如何一键本地部署PolarDB for PostgreSQL

1.创建依赖

注意：本实验环境已内置Docker环境以及PolarDB for PostgreSQL开源版的镜像资源，所以可以跳过本章节直接进入第三步。如果开发者想尝试在本地环境搭建PolarDB则需先参考本部分安装Docker。

PolarDB for PostgreSQL的本地安装部署依赖Docker，需要在机器上预装Docker。本步骤指导您如何在ECS实例上安装Docker。

1. 执行如下命令，配置Docker的yum软件源。

yum install -y yum-utils
yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

1. 1执行如下命令，安装Docker。

yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y

1. 2执行如下命令，启动Docker系统服务。

systemctl start docker

1. 3执行如下命令，测试Docker是否安装成功。

docker run hello-world

1. 4返回结果如下，表示Docker已经安装成功。

2.使用Docker直接部署PolarDB for PostgreSQL实例

DockerHub上已有内含PolarDB-PG多形态实例的镜像。直接拉取镜像并运行，即可启动PolarDB实例。本步骤指导您如何使用Docker部署PolarDB-PG实例。

2.1执行如下命令，拉取PolarDB-PG实例镜像。

docker pull polardb/polardb_pg_local_instance:htap

2.2执行如下命令，创建运行并进入容器。

docker run \
    -it --cap-add=SYS_PTRACE --privileged=true \
    --name polardb_pg_htap \
    polardb/polardb_pg_local_instance:htap \
    bash

2.3执行如下命令，使用psql客户端工具连接PolarDB-PG并执行SQL。

psql -h 127.0.0.1 -c 'select version();'

返回结果如下，表示PolarDB-PG单节点实例连接成功，并且查看到版本号。

2.4输入exit并回车，退出容器。

3. 使用Docker在开发镜像中源码编译部署PolarDB for PostgreSQL实例

DockerHub上已有包含源码编译PolarDB for PostgreSQL所需所有工具和依赖的开发镜像。拉取镜像并启动容器，克隆代码，然后从源码编译出 PolarDB for PostgreSQL的各种形态的实例。本步骤指导您如何使用Docker在开发镜像中源码编译部署PolarDB for PostgreSQL单节点实例、双节点（一主一备）实例和HTAP 实例（一主两备）。

3.1执行如下命令，拉取PolarDB-PG开发镜像。

docker pull polardb/polardb_pg_devel

3.2执行如下命令，创建并启动容器。

docker run -it \
    --cap-add=SYS_PTRACE --privileged=true \
    --name polardb_pg \
    polardb/polardb_pg_devel bash

3.3执行如下命令，从GitHub上克隆PolarDB-PG稳定分支源码。

**说明：**若存在网络问题可以尝试Gitee中国内地镜像：git clone -b POLARDB_11_STABLE https://gitee.com/mirrors/PolarDB-for-PostgreSQL.git。

git clone -b POLARDB_11_STABLE https://github.com/ApsaraDB/PolarDB-for-PostgreSQL.git

3.4执行如下命令，进入源码目录。

cd PolarDB-for-PostgreSQL/

3.5部署PolarDB for PostgreSQL单节点实例。

3.5.1执行如下命令，部署PolarDB for PostgreSQL单节点实例。

./polardb_build.sh

返回结果如下，表示PolarDB for PostgreSQL单节点实例部署成功。

3.5.2 执行如下命令，使用psql客户端工具连接单节点并执行SQL语句。

psql -h 127.0.0.1 -p5432 -c 'select version();'

返回结果如下，表示PolarDB for PostgreSQL单节点连接成功，并且查看到版本号。

3.6部署PolarDB for PostgreSQL双节点（一主一备）实例。

3.6.1 执行如下命令，部署PolarDB for PostgreSQL双节点（一主一备）实例。

./polardb_build.sh --withrep --repnum=1

返回结果如下，表示PolarDB for PostgreSQL双节点（一主一备）实例部署成功。

3.6.2 执行如下命令，分别连接两个节点并执行SQL语句。

psql -h 127.0.0.1 -p5432 -c 'select version();'psql -h 127.0.0.1 -p5433 -c 'select version();'

返回结果如下，表示PolarDB for PostgreSQL双节点连接成功，并且查看到版本号。

3.7部署PolarDB for PostgreSQL HTAP实例（一主两备）。

3.7.1 执行如下命令，部署PolarDB for PostgreSQL HTAP实例（一主两备）。

./polardb_build.sh --initpx

返回结果如下，表示PolarDB for PostgreSQL HTAP实例（一主两备）部署成功。

3.7.2 执行如下命令，分别连接三个节点并执行SQL语句。

psql -h 127.0.0.1 -p5432 -c 'select version();'psql -h 127.0.0.1 -p5433 -c 'select version();'psql -h 127.0.0.1 -p5434 -c 'select version();'

返回结果如下，表示PolarDB for PostgreSQL三节点连接成功，并且查看到版本号。

以上一全部部署流程，如有问题请在评论区评论；