如何一键本地部署PolarDB for PostgreSQL
1. 创建实验资源
开始实验之前,您需要先创建实验相关资源。
- 在实验室页面,单击创建资源。
- (可选)在实验室页面左侧导航栏中,单击云产品资源列表,可查看本次实验资源相关信息(例如IP地址、用户信息等)。
说明:资源创建过程需要3~5分钟。
2. 创建依赖
注意:本实验环境已内置Docker环境以及PolarDB for PostgreSQL开源版的镜像资源,所以可以跳过本章节直接进入第三步。如果开发者想尝试在本地环境搭建PolarDB则需先参考本部分安装Docker。
PolarDB for PostgreSQL的本地安装部署依赖Docker,需要在机器上预装Docker。本步骤指导您如何在ECS实例上安装Docker。
- 执行如下命令,配置Docker的yum软件源。
yum install -y yum-utils yum-config-manager \ --add-repo \ https://download.docker.com/linux/centos/docker-ce.repo
- 执行如下命令,安装Docker。
yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y
- 执行如下命令,启动Docker系统服务。
systemctl start docker
- 执行如下命令,测试Docker是否安装成功。
docker run hello-world
- 返回结果如下,表示Docker已经安装成功。
3. 使用Docker直接部署PolarDB for PostgreSQL实例
DockerHub上已有内含PolarDB-PG多形态实例的镜像。直接拉取镜像并运行,即可启动PolarDB实例。本步骤指导您如何使用Docker部署PolarDB-PG实例。
- 执行如下命令,拉取PolarDB-PG实例镜像。
docker pull polardb/polardb_pg_local_instance:htap
- 执行如下命令,创建运行并进入容器。
docker run \ -it --cap-add=SYS_PTRACE --privileged=true \ --name polardb_pg_htap \ polardb/polardb_pg_local_instance:htap \ bash
- 执行如下命令,使用psql客户端工具连接PolarDB-PG并执行SQL。
psql -h 127.0.0.1 -c 'select version();'
返回结果如下,表示PolarDB-PG单节点实例连接成功,并且查看到版本号。
- 输入exit并回车,退出容器。
4. 使用Docker在开发镜像中源码编译部署PolarDB for PostgreSQL实例
DockerHub上已有包含源码编译PolarDB for PostgreSQL所需所有工具和依赖的开发镜像。拉取镜像并启动容器,克隆代码,然后从源码编译出 PolarDB for PostgreSQL的各种形态的实例。本步骤指导您如何使用Docker在开发镜像中源码编译部署PolarDB for PostgreSQL单节点实例、双节点(一主一备)实例和HTAP 实例(一主两备)。
- 执行如下命令,拉取PolarDB-PG开发镜像。
docker pull polardb/polardb_pg_devel
- 执行如下命令,创建并启动容器。
docker run -it \ --cap-add=SYS_PTRACE --privileged=true \ --name polardb_pg \ polardb/polardb_pg_devel bash
- 执行如下命令,从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
- 执行如下命令,进入源码目录。
cd PolarDB-for-PostgreSQL/
- 部署PolarDB for PostgreSQL单节点实例。
5.1 执行如下命令,部署PolarDB for PostgreSQL单节点实例。
./polardb_build.sh
返回结果如下,表示PolarDB for PostgreSQL单节点实例部署成功。
5.2 执行如下命令,使用psql客户端工具连接单节点并执行SQL语句。
psql -h 127.0.0.1 -p5432 -c 'select version();'
返回结果如下,表示PolarDB for PostgreSQL单节点连接成功,并且查看到版本号。
- 部署PolarDB for PostgreSQL双节点(一主一备)实例。
6.1 执行如下命令,部署PolarDB for PostgreSQL双节点(一主一备)实例。
./polardb_build.sh --withrep --repnum=1
返回结果如下,表示PolarDB for PostgreSQL双节点(一主一备)实例部署成功。
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双节点连接成功,并且查看到版本号。
- 部署PolarDB for PostgreSQL HTAP实例(一主两备)。
7.1 执行如下命令,部署PolarDB for PostgreSQL HTAP实例(一主两备)。
./polardb_build.sh --initpx
返回结果如下,表示PolarDB for PostgreSQL HTAP实例(一主两备)部署成功。
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三节点连接成功,并且查看到版本号。
实验链接:https://developer.aliyun.com/adc/scenario/1498f6bca97c4d668ff5ba75b8b889c8