管理 Pigsty

如何使用 pig sty 子命令管理 Pigsty 发行版本身?

概述

pig 也可以作为 Pigsty 的命令行工具使用 - Pigsty 是一个功能完备的免费 PostgreSQL RDS。 它为您的 PostgreSQL 集群带来了高可用、时间点恢复、监控、基础设施即代码以及所有扩展功能。

pig sty -初始化(下载)、引导、配置和安装 Pigsty

  pig sty init    [-pfvd]      # 安装 pigsty(默认安装到 ~/pigsty)
  pig sty boot    [-rpk]       # 安装 ansible 并准备离线包
  pig sty conf    [-civrsxn]   # 配置 pigsty 并生成配置文件
  pig sty install              # 使用 pigsty 安装和配置环境(危险操作!)
  pig sty get                  # 下载 pigsty 源代码包
  pig sty list                 # 列出可用的 pigsty 版本

用法:
  pig sty [命令]

别名:
  sty, s, pigsty

示例:
  入门指南:https://pigsty.io/docs/setup/install/
  pig sty init                 # 解压并初始化 ~/pigsty
  pig sty boot                 # 安装 ansible 和其他依赖
  pig sty conf                 # 生成 pigsty.yml 配置文件
  pig sty install             # 运行 pigsty/install.yml playbook

可用命令:
  boot        引导 Pigsty
  conf        配置 Pigsty
  get         下载可用的 pigsty 版本
  init        安装 Pigsty
  install     运行 pigsty install.yml playbook
  list        列出可用的 pigsty 版本

参数:
  -h, --help   显示帮助信息

您可以使用 pig sty 子命令在当前节点上引导 pigsty。


sty init

pig sty init
  -p | --path    : 安装路径,默认为 ~/pigsty
  -f | --force   : 强制覆盖现有的 pigsty 目录
  -v | --version : pigsty 版本,默认使用内置版本
  -d | --dir     : 下载目录,默认为 /tmp

用法:
  pig sty init [参数]

别名:
  init, i

示例:

  pig sty init                   # 使用内置版本安装到 ~/pigsty
  pig sty init -f                # 安装并覆盖现有的 pigsty 目录
  pig sty init -p /tmp/pigsty    # 安装到其他位置 /tmp/pigsty
  pig sty init -v 3.3            # 获取并安装特定版本 v3.3.0
  pig sty init 3                 # 获取并安装 v3 的最新版本


参数:
  -d, --dir string       pigsty 下载目录(默认为 "/tmp"  -f, --force           覆盖现有的 pigsty(默认为 false)
  -h, --help            显示帮助信息
  -p, --path string     目标目录(默认为 "~/pigsty"  -v, --version string  pigsty 版本字符串

sty boot

pig sty boot
  [-r|--region <region]   [default,china,europe]
  [-p|--path <path>]      指定另一个离线包路径
  [-k|--keep]             引导过程中保留现有的上游仓库

详情请查看 https://pigsty.io/docs/setup/offline/#bootstrap

用法:
  pig sty boot [参数]

别名:
  boot, b, bootstrap

参数:
  -h, --help            显示帮助信息
  -k, --keep            保留现有仓库
  -p, --path string     离线包路径
  -r, --region string   default,china,europe,...

sty conf

使用 ./configure 配置 pigsty

pig sty conf
  [-c|--conf <name>       # [meta|dual|trio|full|prod]
  [--ip <ip>]             # 主 IP 地址(使用 -s 跳过)
  [-v|--version <pgver>   # [17|16|15|14|13]
  [-r|--region <region>   # [default|china|europe]
  [-s|--skip]             # 跳过 IP 地址探测
  [-x|--proxy]            # 从环境变量写入代理设置
  [-n|--non-interactive]  # 非交互模式

详情请查看 https://pigsty.io/docs/setup/install/#configure

用法:
  pig sty conf [参数]

别名:
  conf, c, configure

示例:

  pig sty conf                       # 使用默认的 conf/meta.yml 配置
  pig sty conf -c rich -x            # 使用 rich.yml 模板,添加代理环境到配置中
  pig sty conf -c supa --ip=10.9.8.7 # 使用 supa 模板,将 10.9.8.7 设为主 IP
  pig sty conf -c full -v 16         # 使用 4 节点完整模板,默认使用 pg16
  pig sty conf -c oss -s             # 使用 oss 模板,跳过 IP 探测和替换
  pig sty conf -c slim -s -r china   # 使用 2 节点精简模板,指定 china 为区域


参数:
  -c, --conf string       配置模板名称
  -h, --help             显示帮助信息
      --ip string        主 IP 地址
  -n, --non-interactive  非交互式配置
  -p, --proxy           配置代理环境
  -r, --region string    上游仓库区域
  -s, --skip            跳过 IP 探测
  -v, --version string   PostgreSQL 主版本

sty install

运行 pigsty install.yml playbook

用法:
  pig sty install [参数]

别名:
  install, ins, install

参数:
  -h, --help   显示帮助信息




最后修改 2025-03-22: update pig docs (3a10e19)