Setup on PIGSTY

安装部署

Mon, 01 Jan 0001 00:00:00 +0000

安装 Pigsty 四步走: 准备，下载，配置，以及安装。如果您没有互联网访问，请同时参阅 离线安装。

简短版本

准备一个安装了兼容操作系统的 Linux x86_64 节点，使用带有免密 sudo 权限的用户，执行以下命令：

curl -L https://get.pigsty.cc/install | bash -s v2.7.0

该命令会下载并解压 Pigsty 源码至家目录，依次完成配置与安装即可完成安装。

离线安装

Mon, 01 Jan 0001 00:00:00 +0000

Pigsty 的 标准安装 流程需要访问互联网，然而生产环境的数据库服务器通常是与互联网隔离的。

因此 Pigsty 提供了离线安装的功能，允许您在没有互联网访问的环境中，同样完成安装与部署。

声明配置

Mon, 01 Jan 0001 00:00:00 +0000

Pigsty将基础设施和数据库视为代码：Database as Code & Infra as Code

你可以通过声明式的接口/配置文件来描述基础设施和数据库集群，你只需在配置清单（Inventory）中描述你的需求，然后用简单的幂等剧本使其生效即可。

准备工作

Mon, 01 Jan 0001 00:00:00 +0000

与 Pigsty 部署有关的 101 入门知识。

节点准备

Pigsty 支持 Linux 内核与 x86_64/amd64 架构，适用于任意节点。

所谓节点（node），指 ssh 可达并提供裸操作系统环境的资源，例如物理机，虚拟机，或者启用了 systemd 与 sshd 的操作系统容器。

资源规划

Mon, 01 Jan 0001 00:00:00 +0000

Pigsty v2.7 的资源规划从选择部署拓扑开始，并据此准备主机、操作系统、网络与管理员访问权限。

规划清单

从资源置备与配置示例中选择单节点、仅监控或高可用拓扑。
根据资源准备与兼容性矩阵核对 CPU 架构、操作系统版本、存储与网络要求。
安装前预留稳定的节点地址、主机名和所需端口，并准备具备免密 SSH 与 sudo 权限的管理员账号。
在在线安装与离线安装之间做出选择，准备相应软件源或离线安装包。
执行剧本前检查配置清单与安全检查项。

集群、用户、数据库、服务与备份的准确参数仍以链接到的 v2.7 页面为准；本页只恢复历史规划入口。

执行剧本

Mon, 01 Jan 0001 00:00:00 +0000

在 Pigsty 中，剧本 / Playbooks 用于在节点上安装模块。

剧本可以视作可执行文件直接执行，例如：./install.yml.

剧本

以下是 Pigsty 中默认包含的剧本：

置备机器

Mon, 01 Jan 0001 00:00:00 +0000

Pigsty 在节点上运行，这些节点可以是裸机或虚拟机。您可以手工置备它们，或使用 terraform 和 vagrant 这样的工具在云端或本地进行自动配置。

沙箱环境

Pigsty 带有一个演示沙箱，所谓沙箱，就是专门用来演示/测试的环境：IP地址和其他标识符都预先固定配置好，便于复现各种演示用例。

安全考量

Mon, 01 Jan 0001 00:00:00 +0000

Pigsty 的默认配置已经足以覆盖绝大多数场景对于安全的需求。

Pigsty 已经提供了开箱即用的认证与访问控制模型，对于绝大多数场景已经足够安全。

如果您希望进一步加固系统的安全性，那么以下建议供您参考：

机密性

重要文件

保护你的 pigsty.yml 配置文件或CMDB

常见问题

Mon, 01 Jan 0001 00:00:00 +0000

如何安装 Docker ？

使用 docker.yml 剧本，在你想安装的节点上执行，即可完成 Docker 的安装

./docker.yml -l <selector>

常见问题

Mon, 01 Jan 0001 00:00:00 +0000

ETCD集群如果不可用了会有什么影响？

ETCD 对于 PGSQL 集群的高可用至关重要，而 etcd 本身的可用性是通过使用多个节点来保证的。使用3节点的 etcd 集群允许最多一个节点宕机，而其他两个节点仍然可以正常工作；使用五节点的 ETCD 集群则可以容忍两个节点失效。如果超过一半的 ETCD 节点宕机，ETCD 集群及其服务将不可用。在 Patroni 3.0 之前，这可能导致 PGSQL 全局故障；所有的主节点将被降级并拒绝写请求。

常见问题

Mon, 01 Jan 0001 00:00:00 +0000

INFRA模块中包含了哪些组件？

Ansible 用于自动化、部署和管理；
Nginx 用于公开对外暴露各种 WebUI 服务，并为提供一个本地软件源
自签名 CA 用于 SSL/TLS 证书；
Prometheus 用于收集存储监控指标；
Grafana 用于监控/可视化；
Loki 用于收集存储查询日志；
AlertManager 用于告警聚合；
Chronyd 用于 NTP 时间同步；
DNSMasq 用于 DNS 注册和解析；
ETCD 作为 PGSQL HA 的 DCS；（可以部署到别的专用节点集群上）
在管理节点上的 PostgreSQL 作为 CMDB；（可选）
Docker 用于无状态的应用程序和工具（可选）。

如何重新向 Prometheus 注册监控目标？

如果你不小心删除了基础设施节点上 Prometheus 的目标目录（/etc/prometheus/target），你可以使用以下命令再次向 Prometheus 注册监控目标：

常见问题

Mon, 01 Jan 0001 00:00:00 +0000

启动多节点/多盘MinIO集群失败怎么办？

在单机多盘或多机多盘模式下，如果数据目录不是有效的磁盘挂载点，MinIO会拒绝启动。

请使用已挂载的磁盘作为MinIO的数据目录，而不是普通目录。您只能在单机单盘模式下使用普通目录作为 MinIO 的数据目录，作为开发测试之用。

常见问题

Mon, 01 Jan 0001 00:00:00 +0000

安装MongoSH

您可以使用 MongoSH 作为客户端工具访问 FerretDB 集群

cat > /etc/yum.repos.d/mongo.repo <<EOF
[mongodb-org-6.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/6.0/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-6.0.asc
EOF
yum install -y mongodb-mongosh

当然，您也可以直接安装 mongosh 的 RPM 包：

常见问题

Mon, 01 Jan 0001 00:00:00 +0000

如何配置主机节点上的NTP服务？

NTP对于生产环境各项服务非常重要，如果没有配置 NTP，您可以使用公共 NTP 服务，或管理节点上的 Chronyd 作为标准时间。

常见问题

Mon, 01 Jan 0001 00:00:00 +0000

Redis初始化失败：ABORT due to existing redis instance

这意味着正在初始化的 Redis 实例已经存在了，使用 redis_clean = true 和 redis_safeguard = false 来强制清除redis数据

当您运行redis.yml来初始化一个已经在运行的redis实例，并且redis_clean设置为false时，就会出现这种情况。

常见问题

Mon, 01 Jan 0001 00:00:00 +0000

这里列出了Pigsty用户在下载、安装、部署时常遇到的问题，如果您遇到了难以解决的问题，可以提交 Issue 或者联系我们。

如何获取Pigsty软件源码包？

使用以下命令一键安装 Pigsty： bash -c "$(curl -fsSL https://get.pigsty.cc/install)" -- v2.7.0