教程 on PIG.CENTER

安装

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

Mac OS 前置依赖

在 Mac 上安装依赖，执行以下命令：

brew install postgresql etcd haproxy libyaml python

Psycopg

从 psycopg2-2.8 开始，psycopg2 的二进制版本不再默认安装。从源码编译安装需要 C 编译器以及 postgres 和 python 的开发包。由于 Python 生态中无法将依赖声明为 psycopg2 OR psycopg2-binary，您需要自行选择安装方式。

下载与安装

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

选择分发渠道

渠道	适用场景	地址
官方发布	源码归档与版本说明	GitHub Releases
RPM 软件包	基于 RPM 的 Linux 发行版	PostgreSQL Yum 仓库
Debian/Ubuntu 软件包	基于 APT 的 Linux 发行版	PostgreSQL Apt 仓库
开发源码	尚未正式发布的最新代码	darold/pgbadger

本站文档快照基于 13.2 源码树。下载前始终应查看发布页面：本地快照为了可复现而固定，上游版本仍会继续更新。

用户指南（Debian/Ubuntu）

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

简介

本用户指南适合从头到尾顺序阅读——每章内容均依赖前一章的配置基础。例如，恢复章节依赖 快速开始 章节中已完成的配置。pgBackRest 运行起来之后，跳章阅读也无妨，但建议初次阅读时按顺序跟随本指南。

用户指南（RHEL/Rocky/CentOS）

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

简介

本用户指南设计为从头到尾顺序阅读——每个章节都依赖前一章节的内容。例如，恢复章节依赖 快速开始 章节中完成的配置。熟悉 pgBackRest 之后可以跳章查阅，但初次阅读建议按顺序跟随。

PgBouncer 编译与安装

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

编译

PgBouncer 的编译依赖以下组件：

GNU Make 3.81+
Libevent 2.0+
pkg-config
OpenSSL 1.0.1+（TLS 支持）
（可选）c-ares ，作为 Libevent 内置 evdns 的替代方案
（可选）LDAP 库
（可选）PAM 库

安装依赖后，执行以下命令：

快速入门

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

按照以下步骤本地安装、运行并测试单成员 etcd 集群：

从预构建的二进制文件或源码安装 etcd。详情请参见 [安装][]。

警告

重要：务必完成安装说明的最后一步，确认可执行文件搜索路径中包含 etcd。

示例

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

本系列示例展示了操作 etcd 集群的基本流程。

认证

auth、user、role 用于身份认证：

export ETCDCTL_API=3
ENDPOINTS=localhost:2379

etcdctl --endpoints=${ENDPOINTS} role add root
etcdctl --endpoints=${ENDPOINTS} role get root

etcdctl --endpoints=${ENDPOINTS} user add root
etcdctl --endpoints=${ENDPOINTS} user grant-role root root
etcdctl --endpoints=${ENDPOINTS} user get root

etcdctl --endpoints=${ENDPOINTS} role add role0
etcdctl --endpoints=${ENDPOINTS} role grant-permission role0 readwrite foo
etcdctl --endpoints=${ENDPOINTS} user add user0
etcdctl --endpoints=${ENDPOINTS} user grant-role user0 role0

etcdctl --endpoints=${ENDPOINTS} auth enable
# now all client requests go through auth

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# permission denied, user name is empty because the request does not issue an authentication request
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 can read the key foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

配置本地集群

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

对于测试和开发部署，最快捷简便的方式是配置本地集群。对于生产部署，请参考 clustering 章节。

本地独立集群

启动集群

运行以下命令以将 etcd 集群部署为独立集群：