一. 创建实验资源
开始实验之前,您需要先创建实验相关资源。可以前往实践页面完成创建。
二. 创建依赖
注意:本实验环境已内置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
2.执行如下命令,安装Docker。
yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y
3.执行如下命令,启动Docker系统服务。
systemctl start docker
4.执行如下命令,测试Docker是否安装成功。
docker run hello-world
5.返回结果如下,表示Docker已经安装成功。
三. 使用Docker直接部署PolarDB for PostgreSQL实例
DockerHub上已有内含PolarDB-PG多形态实例的镜像。直接拉取镜像并运行,即可启动PolarDB实例。本步骤指导您如何使用Docker部署PolarDB-PG实例。
1.执行如下命令,拉取PolarDB-PG实例镜像。
docker pull polardb/polardb_pg_local_instance:htap
2.执行如下命令,创建运行并进入容器。
docker run \ -it --cap-add=SYS_PTRACE --privileged=true \ --name polardb_pg_htap \ polardb/polardb_pg_local_instance:htap \ bash
3.执行如下命令,使用psql客户端工具连接PolarDB-PG并执行SQL。
psql -h 127.0.0.1 -c 'select version();'
返回结果如下,表示PolarDB-PG单节点实例连接成功,并且查看到版本号。
4.输入exit并回车,退出容器。
四. 使用Docker在开发镜像中源码编译部署PolarDB for PostgreSQL实例
DockerHub上已有包含源码编译PolarDB for PostgreSQL所需所有工具和依赖的开发镜像。拉取镜像并启动容器,克隆代码,然后从源码编译出 PolarDB for PostgreSQL的各种形态的实例。本步骤指导您如何使用Docker在开发镜像中源码编译部署PolarDB for PostgreSQL单节点实例、双节点(一主一备)实例和HTAP 实例(一主两备)。
1.执行如下命令,拉取PolarDB-PG开发镜像。
docker pull polardb/polardb_pg_devel
2.执行如下命令,创建并启动容器。
docker run -it \ --cap-add=SYS_PTRACE --privileged=true \ --name polardb_pg \ polardb/polardb_pg_devel bash
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
4.执行如下命令,进入源码目录。
cd PolarDB-for-PostgreSQL/
5.部署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单节点连接成功,并且查看到版本号。
6.部署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双节点连接成功,并且查看到版本号。
7.部署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三节点连接成功,并且查看到版本号。