上手

如何快速拉起Pigsty

准备

安装Pigsty需要一个机器节点：规格至少为1核2GB，采用Linux内核，安装CentOS 7发行版，处理器为x86_64架构。该节点在生产环境中被用作元节点（管理节点），发出控制命令，采集监控数据，运行定时任务。

安装

安装需要root权限。使用带有sudo权限的用户（或root）执行以下命令即可完成安装：

curl -fsSL https://pigsty.cc/pigsty.tgz | gzip -d | tar -xC ~; cd ~/pigsty  # 下载源码
make config    # 配置环境
make install   # 安装软件

在使用离线安装包的情况下，整个安装过程耗时约10～15分钟。

./configure 会自动检测环境。如果节点拥有多个IP地址，请指定一个主要IP地址。沙箱环境中的IP地址固定为10.10.10.10 。此外，如果离线安装包/tmp/pkg.tgz不存在，程序会提示是否从网络下载。

沙箱

如果希望在本机运行Pigsty，可以使用虚拟机软件，或使用Pigsty沙箱。沙箱是本地演示/测试/开发环境，运行于由 Vagrant 托管的本地 Virtualbox 虚拟机上。这两者都是跨平台软件，可以在MacOS|Windows|Linux下运行。

以MacOS为例，在本机终端中依次执行以下命令，即可拉起沙箱。

make deps   # 安装homebrew，并通过homebrew安装vagrant与virtualbox（需重启）
make dns    # 向本机/etc/hosts写入静态域名 (需sudo输入密码)
make start  # 使用Vagrant拉起单个meta节点 （start4则为4个节点）
make demo   # 使用单节点Demo配置并安装    （demo4则为4节点demo）

使用

安装完毕后，用可以直接访问该节点上的端口来使用Pigsty监控系统。

例如，Pigsty监控系统默认使用3000端口，默认管理用户与密码均为：admin。

在使用沙箱时，用户可以通过make dns写入的默认本地域名访问Pigsty提供的相关服务，例如这里的：http://g.pigsty。Pigsty对外暴露的相关服务如下表所示：

服务 域名 地址 说明
Grafana http://pigsty 10.10.10.10:3000 Pigsty监控系统主页
Consul http://c.pigsty 10.10.10.10:8500 元数据库，展示集群中的所有节点与服务的状态
Prometheus http://p.pigsty 10.10.10.10:9090 监控时序数据库，查询指标，定义规则，处理报警
Alertmanager http://a.pigsty 10.10.10.10:9093 浏览、处理、屏蔽告警信息
Haproxy http://h.pigsty 10.10.10.10:80 浏览负载均衡器的状态，进行流量管理与控制
Yum Repo http://yum.pigsty 10.10.10.10:80 本地Yum源，包含所有离线软件安装包

当使用普通机器部署时，将这里的IP地址（10.10.10.10）换为用户自己的节点IP即可。

直接通过IP地址访问虽然方便，但更合适的做法是通过 nginx_upstream 为各个服务指定域名，并通过域名访问不同的服务。Pigsty自带的Nginx会默认通过80端口对外代理所有Web访问。

部署

Pigsty安装完成后，这台机器将作为Pigsty的元节点。用户可以从元节点发起控制，部署新PG集群。部署新数据库集群分为三步：

  1. 将用于部署的机器节点纳入管理

    当前用户可以从当前节点免密码ssh登陆目标节点，并带有免密码的sudo权限。

  2. 定义数据库集群（配置文件或图形界面）

  3. 执行数据库集群部署剧本

    如果用户通过make start4与make demo4启动沙箱，则无需配置直接执行此命令即可。

    ./pgsql.yml -l pg-test    # 初始化pg-test数据库集群

更多信息请参考部署一章

FAQ

安装与使用过程中的常见问题，请参考 FAQ

接下来做什么？

FAQ

Pigsty快速上手常见问题

最后修改 2021-05-20: update quick-start faq (dc7e412)