patronictl

原创已于 2025-02-13 11:23:03 修改 · 1.7k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#数据库

于 2022-09-24 22:32:14 首次发布

PG 专栏收录该内容

355 篇文章

订阅专栏

目录标题

Patroni + Etcd 实现高可用技术栈操作指南与解析
- 一、Patroni 常用操作指令详解

Patroni + Etcd 实现高可用技术栈操作指南与解析

在构建高可用的PostgreSQL集群时，Patroni结合Etcd是一种常见且高效的解决方案。以下将对相关的操作指令以及知识进行梳理，帮助深入理解和运用该技术栈。同时，参考一系列知乎专栏文章，逐步深入探讨其安装部署、高可用测试、参数配置以及处理流程等关键环节。

一、Patroni 常用操作指令详解

（一）重新初始化操作

在某些特定场景下，如集群成员出现严重故障需要重新恢复初始状态，或对集群成员进行重大配置调整前，可能需要执行重新初始化操作。

patronictl reinit --help
Usage: patronictl reinit [OPTIONS] CLUSTER_NAME [MEMBER_NAMES]...

  Reinitialize cluster member

Options:
  --force  Do not ask for confirmation at any point
  --wait   Wait until reinitialization completes
  --help   Show this message and exit.

参数说明：
- CLUSTER_NAME：指定要操作的集群名称，明确指令作用的集群范围。
- MEMBER_NAMES（可选）：可指定集群内特定的成员名称。若不指定，则默认对集群内所有成员执行操作。
- --force：该选项较为危险，使用时将跳过所有确认步骤，直接执行重新初始化。在生产环境中需谨慎使用，避免误操作。
- --wait：使用此选项后，命令行将阻塞，直至重新初始化操作完成，方便实时监控操作进度。

（二）查看历史记录

通过查看历史记录，可以清晰了解集群中发生的故障转移（failover）和切换（switchover）等关键事件，这对于故障排查、性能优化以及运维审计都具有重要意义。

patronictl history

执行该命令后，会展示详细的事件记录，包括事件发生的时间、涉及的集群成员、操作类型（如failover、switchover）等信息。这些信息为分析集群的运行状况和稳定性提供了有力依据。

在这里插入图片描述

参考文档：Patroni 官方文档 - patronictl 工具说明

（三）查看集群成员列表

查看集群成员列表是日常运维中常用的操作，方便快速了解集群的组成结构和成员状态。

patronictl list

patronictl --help
Usage: patronictl [OPTIONS] COMMAND [ARGS]...

Options:
  -c, --config-file TEXT  Configuration file
  -d, --dcs TEXT          Use this DCS
  -k, --insecure          Allow connections to SSL sites without certs
  --help                  Show this message and exit.

Commands:
  configure    Create configuration file
  dsn          Generate a dsn for the provided member, defaults to a dsn...
  edit-config  Edit cluster configuration
  failover     Failover to a replica
  flush        Discard scheduled events
  history      Show the history of failovers/switchovers
  list         List the Patroni members for a given Patroni
  pause        Disable auto failover
  query        Query a Patroni PostgreSQL member
  reinit       Reinitialize cluster member
  reload       Reload cluster member configuration
  remove       Remove cluster from DCS
  restart      Restart cluster member
  resume       Resume auto failover
  scaffold     Create a structure for the cluster in DCS
  show-config  Show cluster configuration
  switchover   Switchover to a replica
  topology     Prints ASCII topology for given cluster
  version      Output version of patronictl command or a running Patroni...

常用选项说明：
- -c, --config-file TEXT：用于指定Patroni的配置文件路径。在复杂的多集群或多环境部署中，可通过此选项灵活切换不同的配置。
- -d, --dcs TEXT：指定要使用的分布式一致性存储（DCS），如Etcd。当同时管理多个不同DCS的集群时，该选项非常有用。
- -k, --insecure：允许在连接SSL站点时不进行证书验证。在测试环境或内部信任网络中，可使用此选项跳过繁琐的证书配置，但在生产环境中不建议使用，以免带来安全风险。