分类: Setup

这里列出了Pigsty用户在下载、安装、部署时常遇到的问题，如果您遇到了难以解决的问题，可以提交 Issue 或者联系我们。 如何获取Pigsty软件源码包？ 使用以下命令一键安装 Pigsty： bash -c "$(curl -fsSL https://get.pigsty.cc/install)" -- v2.7.0 上述命令会自动下载最新的稳定版本 pigsty.tgz 并解压到 ~/pigsty 目录。您也可以从以下位置手动下载 Pigsty 源代码的特定版本。 如果您需要在没有互联 …

Redis初始化失败：ABORT due to existing redis instance 这意味着正在初始化的 Redis 实例已经存在了，使用 redis_clean = true 和 redis_safeguard = false 来强制清除redis数据 当您运行redis.yml来初始化一个已经在运行的redis实例，并且redis_clean设置为false时，就会出现这种情况。 如果redis_clean设置为true（并且 redis_safeguard 也设置为 …

如何配置主机节点上的NTP服务？ NTP对于生产环境各项服务非常重要，如果没有配置 NTP，您可以使用公共 NTP 服务，或管理节点上的 Chronyd 作为标准时间。 如果您的节点已经配置了 NTP，可以通过设置 node_ntp_enabled 为 false 来保留现有配置，不进行任何变更。 否则，如果您有互联网访问权限，可以使用公共 NTP 服务，例如 pool.ntp.org。 如果您没有互联网访问权限，可以使用以下方式，确保所有环境内的节点与管理节点时间是同步的，或者使用其他内网环 …

安装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 …

启动多节点/多盘MinIO集群失败怎么办？ 在单机多盘或多机多盘模式下，如果数据目录不是有效的磁盘挂载点，MinIO会拒绝启动。 请使用已挂载的磁盘作为MinIO的数据目录，而不是普通目录。您只能在单机单盘模式下使用普通目录作为 MinIO 的数据目录，作为开发测试之用。 如何部署一个多节点/多盘MinIO集群？ 请参阅创建多节点多盘的MinIO集群 如何向已有的MinIO集群中添加新的成员？ 在部署之前，您最好规划MinIO集群容量，因为新增成员需要全局重启。 请参考这里：扩展MinIO部署 …

INFRA模块中包含了哪些组件？ Ansible 用于自动化、部署和管理； Nginx 用于公开对外暴露各种 WebUI 服务，并为提供一个本地软件源 自签名 CA 用于 SSL/TLS 证书； Prometheus 用于收集存储监控指标； Grafana 用于监控/可视化； Loki 用于收集存储查询日志； AlertManager 用于告警聚合； Chronyd 用于 NTP 时间同步； DNSMasq 用于 DNS 注册和解析； ETCD 作为 PGSQL HA 的 DCS；（可以部署到 …

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

如何安装 Docker ？ 使用 docker.yml 剧本，在你想安装的节点上执行，即可完成 Docker 的安装 ./docker.yml -l <selector>

Pigsty 的默认配置已经足以覆盖绝大多数场景对于安全的需求。 Pigsty 已经提供了开箱即用的认证与访问控制模型，对于绝大多数场景已经足够安全。 如果您希望进一步加固系统的安全性，那么以下建议供您参考： 机密性 重要文件 保护你的 pigsty.yml 配置文件或CMDB pigsty.yml 配置文件通常包含了高度敏感的机密信息，您应当确保它的安全。 严格控制管理节点的访问权限，仅限 DBA 或者 Infra 管理员访问。 严格控制 pigsty.yml 配置文件仓库的访问权限（如果您使 …

Pigsty 在节点上运行，这些节点可以是裸机或虚拟机。您可以手工置备它们，或使用 terraform 和 vagrant 这样的工具在云端或本地进行自动配置。 沙箱环境 Pigsty 带有一个演示沙箱，所谓沙箱，就是专门用来演示/测试的环境：IP地址和其他标识符都预先固定配置好，便于复现各种演示用例。 默认的沙箱环境由4个节点组成，配置文件请参考 demo.yml。 沙箱的 4 个节点有着固定的 IP 地址 …

在 Pigsty 中，剧本 / Playbooks 用于在节点上安装模块。 剧本可以视作可执行文件直接执行，例如：./install.yml. 剧本 以下是 Pigsty 中默认包含的剧本： 剧本 功能 install.yml 在当前节点上一次性完整安装 Pigsty infra.yml 在 infra 节点上初始化 pigsty 基础设施 infra-rm.yml 从 infra 节点移除基础设施组件 node.yml 纳管节点，并调整节点到期望的状态 node-rm.yml 从 pigsty …

Pigsty v2.7 的资源规划从选择部署拓扑开始，并据此准备主机、操作系统、网络与管理员访问权限。 规划清单 从资源置备与配置示例中选择单节点、仅监控或高可用拓扑。 根据资源准备与兼容性矩阵核对 CPU 架构、操作系统版本、存储与网络要求。 安装前预留稳定的节点地址、主机名和所需端口，并准备具备免密 SSH 与 sudo 权限的管理员账号。 在在线安装与离线安装之间做出选择，准备相应软件源或离线安装包。 执行剧本前检查配置清单与安全检查项。 集群、用户、数据库、服务与备份的准确参数仍以链接到 …

与 Pigsty 部署有关的 101 入门知识。 节点准备 Pigsty 支持 Linux 内核与 x86_64/amd64 架构，适用于任意节点。 所谓节点（node），指 ssh 可达并提供裸操作系统环境的资源，例如物理机，虚拟机，或者启用了 systemd 与 sshd 的操作系统容器。 部署 Pigsty 最少需要一个节点。最低配置要求为 1C1G，推荐至少使用 2C4G 以上的机型，适用配置上不封顶，参数会自动优化适配。 作为 Demo，个人站点，或者开发环境时，可以使用单个节点。 作 …

Pigsty将基础设施和数据库视为代码：Database as Code & Infra as Code 你可以通过声明式的接口/配置文件来描述基础设施和数据库集群，你只需在 配置清单 （Inventory） 中描述你的需求，然后用简单的幂等剧本使其生效即可。 配置概览 Pigsty 使用 配置清单 每一套 Pigsty 部署都有一个相应的 配置清单（Inventory）。它可以以 YAML 的形式存储在本地，并使用 git 管理；或从 CMDB 或任何 ansible 兼容的方式动态生成。 …

Pigsty 的 标准安装 流程需要访问互联网，然而生产环境的数据库服务器通常是与互联网隔离的。 因此 Pigsty 提供了离线安装的功能，允许您在没有互联网访问的环境中，同样完成安装与部署。 如果您有互联网访问，提前下载好预制的 离线软件包 也可以帮助您加速安装的过程，并增强安装过程的确定性与可靠性。 简短版本 在执行 标准安装 前，首先下载好 Pigsty 软件包与 离线软件包 。 软件包下载地址 CDN（中国大陆） GitHub Release Pigsty 源码包 …

安装 Pigsty 四步走: 准备，下载，配置，以及 安装。如果您没有互联网访问，请同时参阅 离线安装。 简短版本 准备 一个安装了 兼容 操作系统的 Linux x86_64 节点，使用带有免密 sudo 权限的用户，执行以下命令： curl -L https://get.pigsty.cc/install | bash -s v2.7.0 该命令会 下载 并解压 Pigsty 源码至家目录，依次完成 配置 与安装 即可完成安装。 cd ~/pigsty # 下载源码包解压后进入 …