通过 Docker 实现 openGauss 的快速容器化安装

openGauss 的密码有复杂度要求

密码长度 8 个字符以上，必须同时包含大写字母、小写字母、数字、以及特殊符号（特殊符号仅包含'#?!@$%^&*-'，并且'!$&'需要用转义符''进行转义）。

GS_NODENAME

指定数据库节点名称，默认为 gaussdb。

GS_USERNAME

指定数据库连接用户名，默认为 gaussdb。

GS_PORT

指定数据库端口，默认为 5432。

开启实例

docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Enmo@123 opengauss:X.X.X 

从操作系统层面连接数据库

docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Enmo@123 -p8888:5432 opengauss:X.X.X 
gsql -d postgres -U gaussdb -W'Enmo@123' -h your-host-ip -p8888 

数据持久化

docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Enmo@123 -v /opengauss:/var/lib/opengauss opengauss:X.X.X 

说明

对于使用其他版本的数据库构建容器镜像，可以参考 openGauss-server/docker/dockerfiles/X.X.X 里面的配置文件，只需要修改为对应的版本号即可。

对于构建 openEuler-arm 的容器镜像，如果 openeuler-20.03-lts:latest 镜像下载不下来，可以在 openEuler 官方网站下载容器镜像压缩包，然后使用 docker load -i openEuler-docker.aarch64.tar.xz 导入到本地镜像列表。

在进行构建时候，如果遇到 yum 源下载超时，请检查下代理，也可以在 buildDockerImage.sh 脚本里面的 docker build 命令后加上 --network host 使用宿主机的网络。

CM 容器化部署

创建 openGauss docker 镜像

下载 openGauss-docker 仓库代码，构建脚本在该仓库中管理。

• 构建镜像需要 openGauss 社区发布的企业版本包，openGauss-*-64bit-all.tar.gz。放到 openGauss-docker/dockerfiles 目录下。
• 运行 buildDockerImage.sh 脚本时，如果不指定 -i 参数，此时默认提供 SHA256 检查，需要您手动将校验结果写入 sha256_file_amd64 文件。

# 修改 sha256 校验文件内容
cd openGauss-docker/dockerfiles
sha256sum openGauss-X.X.X-CentOS-64bit-all.tar.gz > sha256_file_amd64 

• 对于 x86 平台，使用社区发布的 Centos_x86_64 的包；对于 arm 平台，使用发布的 openEuler-arm 版本企业包。

构建命令：

sh buildDockerImage.sh -v X.X.X -i 

使用社区发布的镜像

最新的容器镜像：

x86_64 平台：

docker pull swr.cn-south-1.myhuaweicloud.com/opengauss/x86_64/opengauss:X.X.X
docker tag swr.cn-south-1.myhuaweicloud.com/opengauss/x86_64/opengauss:X.X.X opengauss:X.X.X 

arm 平台：

docker pull swr.cn-south-1.myhuaweicloud.com/opengauss/arm/opengauss:X.X.X
docker tag swr.cn-south-1.myhuaweicloud.com/opengauss/arm/opengauss:X.X.X opengauss:X.X.X 

启动容器

搭建 CM 集群至少需要两个容器实例才能使用。

1. 创建容器网络

如果多个容器部署在一台机器上，创建一个普通的容器网络即可：

docker network create --subnet=172.11.0.0/24 og-network

如果容器跨多个节点部署，即要求节点间的容器能够进行通信。业界有多种实现方式，这里提供一种作为参考，用户可以自行选择。

选择一台部署 progrium/consul 容器：

docker pull progrium/consul
docker run -d -p 8500:8500 -h consul --name consul progrium/consul -server -bootstrap 

每个节点的 docker 都进行修改：vim /usr/lib/systemd/system/docker.service 在 ExecStart 一栏后面追加：

-H tcp://0.0.0.0:2376 -H unix:///var/run/var/run/docker.sock --cluster-store=consul://192.168.0.94:8500 --cluster-advertise=eth0:2376 

192.168.0.94 是部署 consul 的机器 ip。

修改完成后需要重启 docker：

systemctl daemon-reload
systemctl restart docker 

创建 overlay 网络

docker network create -d overlay --subnet 10.22.1.0/24 --gateway 10.22.1.1 og-network 

2. 启动多个容器实例

# ip 需要和容器网络在同一网段，几个实例的 ip 和节点名称不能重复。如下示例 1 主 2 备：
primary_nodeip="172.11.0.2"
standby1_nodeip="172.11.0.3"
standby2_nodeip="172.11.0.4"
primary_nodename=primary
standby1_nodename=standby1
standby2_nodename=standby2
OG_NETWORK=og-network
GS_PASSWORD=test@123

# 启动实例 1
docker run -d -it -P --ulimit nofile=1000000:1000000 --sysctl kernel.sem="250 6400000 1000 25600" --security-opt seccomp=unconfined -v /data/opengauss_volume:/volume --name opengauss-01 --net ${OG_NETWORK} --ip "$primary_nodeip" -h=$primary_nodename -e primaryhost="$primary_nodeip" -e primaryname="$primary_nodename" -e standbyhosts="$standby1_nodeip, $standby2_nodeip" -e standbynames="$standby1_nodename, $standby2_nodename" -e GS_PASSWORD=$GS_PASSWORD opengauss:X.X.X

# 启动实例 2
docker run -d -it -P --ulimit nofile=1000000:1000000 --sysctl kernel.sem="250 6400000 1000 25600" --security-opt seccomp=unconfined -v /data/opengauss_volume:/volume --name opengauss-02 --net ${OG_NETWORK} --ip "$standby1_nodeip" -h=$standby1_nodename -e primaryhost="$primary_nodeip" -e primaryname="$primary_nodename" -e standbyhosts="$standby1_nodeip, $standby2_nodeip" -e standbynames="$standby1_nodename, $standby2_nodename" -e GS_PASSWORD=$GS_PASSWORD opengauss:X.X.X

# 启动实例 3
docker run -d -it -P --ulimit nofile=1000000:1000000 --sysctl kernel.sem="250 6400000 1000 25600" --security-opt seccomp=unconfined -v /data/opengauss_volume:/volume --name opengauss-03 --net ${OG_NETWORK} --ip "$standby2_nodeip" -h=$standby2_nodename -e primaryhost="$primary_nodeip" -e primaryname="$primary_nodename" -e standbyhosts="$standby1_nodeip, $standby2_nodeip" -e standbynames="$standby1_nodename, $standby2_nodename" -e GS_PASSWORD=$GS_PASSWORD opengauss:X.X.X 

3. 使用脚本快速启动 1 主 2 备的 cm 集群容器实例

在 openGauss-docker 目录下，执行 sh create_cm_contariners.sh

This script will create three containers with cm on a single node.
Please input OG_SUBNET (容器所在网段) [172.11.0.0/24]:
OG_SUBNET set 172.11.0.0/24
Please input OG_NETWORK (容器网络名称) [og-network]:
OG_NETWORK set og-network
Please input GS_PASSWORD (定义数据库密码)[test@123]:
GS_PASSWORD set
Please input openGauss VERSION [X.X.X]:
openGauss VERSION set X.X.X
starting create docker containers...

会让填入容器网段、容器网络名称、数据库密码、容器版本号。使用默认值得话可以直接回车跳过。脚本执行完成后，会拉起 3 个容器实例，组成 1 主 2 备的 cm 集群。

进入容器中查看实例状态

1. 进入容器

docker exec -ti <containerid> /bin/bash
su - omm 

2. 查看集群状态

cm_ctl query -Cvid 

3. 连接接数据库

gsql -d postgres -r 

说明

1. 构建的容器需要包含操作系统层
2. 容器内仅提供 CM 和数据库内核工具，OM 工具无法使用