本文介绍了如何在同一台机器上使用 Docker 容器搭建GBase 8s主备集群环境。
拉取镜像
拉取GBase 8s的最新镜像
docker pull liaosnet/gbase8s或者docker pull liaosnet/gbase8s:v8.8_3513x25_csdk_x64
注：在tag为v8.8_3513x25_csdk_x64及之后的版本中，可通过参数方式自动创建集群
拉取镜像成功后，可通过docker images查看拉取镜像的版本。
创建自定义网络
Docker安装后，默认会创建三种网络。bridge网络是默认情况下启动Docker容器的网络，为Docker安装时创建的桥接网络，每次Docker容器重启时，会按照顺序获取对应的IP地址，这会导致Docker重启后IP地址的改变。因此在搭建一些集群软件的时候，组件和组件之间需要进行网络通信，如果没有固定分配的IP，容器提供的服务将是不可靠的。每次主机重启时，如果容器没有固定IP，容器的IP将由启动顺序决定。这将导致主备集群容器之间访问异常，从而使得服务提供失败；因此需要将容器的IP固定下来。这里我们就需要创建自定义的docker的bridge网络。
使用docker network create来创建自定义网络，创建命令如下：
docker network create --subnet=172.20.0.0/24 --gateway=172.20.0.1 mynetwork
创建网络成功后，可通过docker network ls查看docker的网络。
数据库集群将使用到172.20.0.21及172.20.0.22这两个IP地址。
创建数据卷（可选）
可以创建数据卷用于持久化数据库的数据。
docker volume create gbase_pri_datadocker volume create gbase_hac_data
注：未指定数据卷目录将默认使用/var/lib/docker/volumes/数据卷名/_data 目录
创建数据卷成功后，可通过docker volume ls查看数据卷。
不创建数据卷，也可使用-v的映射目录的方式进行持久化数据。
创建主节点容器
使用docker run来创建启动主节点容器，启动命令如下：
docker run -d -p 19188:9088 \--network mynetwork --ip 172.20.0.21 \--name node01 --hostname node01 \--privileged=true \-v /data/gbase_pri:/opt/gbase/data \-e SERVERNAME=gbase01 \-e MODE=primary \-e LOCALIP=172.20.0.21 \-e PAIRENAME=gbase02 \-e PAIREIP=172.20.0.22 \-e USERPASS=GBase123$% \-e CPUS=1 \-e MEMS=2048 \-e ADTS=0 \liaosnet/gbase8s:v8.8_3513x25_csdk_x64
以上面的启动命令进行如下说明：
-p 19188:9088将容器中的数据库端口号9088映射到宿主机上的19088端口，应用可以通过宿主机IP:19088端口访问容器中的数据库服务。如需要外部访问，此参数必须配置。
--network mynetwork指定容器使用自建的桥接网络，名称为mynetwork。如需要使用集群，此参数必须配置。
--ip 172.20.0.21指定容器使用自建的桥接网络下的IP地址。如需要使用集群，此参数必须配置。
--name node01指定容器使用的名称。
--hostname node01指定容器内使用的主机名称。
--privileged=true指定容器在特权模式下运行。有-v参数时，此参数必须配置。
-v /data/gbase_pri:/opt/gbase/data指定挂载宿主目录/data/gbase_pri到容器内/opt/gbase/data数据库数据目录。这里也可以使用数据卷的方式，如 -v gbase_pri_data:/opt/gbase/data
-e SERVERNAME=gbase01指定数据库服务/实例名称。
-e MODE=primary指定容器内数据库为主节点。
-e LOCALIP=172.20.0.21指定本节点使用的IP地址。
-e PAIRENAME=gbase02指定集群对端节点数据库服务/实例名称。
-e PAIREIP=172.20.0.22指定集群对端节点使用的IP地址。
-e USERPASS=GBase123$%指定gbasedbt用户密码。
-e CPUS=1指定容器内数据库使用CPU个数。
-e MEMS=2048指定容器内数据库使用内存大小（单位MB）
-e ADTS=0指定容器内数据库是否开启审计。
liaosnet/gbase8s:v8.8_3513x25_csdk_x64指定容器使用的镜像名称及版本。此参数必须配置。
容器启动完成后，使用docker logs node01查看启动情况
docker logs node01
最后一行显示类似如下，表示已经启动到主节点
[2025-02-26 14:48:07] Change mode to PRIMARY.
创建备节点容器
使用docker run来创建启动备节点容器，启动命令如下：
docker run -d -p 19288:9088 \--network mynetwork --ip 172.20.0.22 \--name node02 --hostname node02 \--privileged=true \-v /data/gbase_sec:/opt/gbase/data \-e SERVERNAME=gbase02 \-e MODE=secondary \-e LOCALIP=172.20.0.22 \-e PAIRENAME=gbase01 \-e PAIREIP=172.20.0.21 \-e USERPASS=GBase123$% \-e CPUS=1 \-e MEMS=2048 \-e ADTS=0 \liaosnet/gbase8s:v8.8_3513x25_csdk_x64
以上面的启动命令，注意与主节点命令的区别。
容器启动完成后，使用docker logs node02查看启动情况
docker logs node02
最后一行显示类似如下，表示已经启动并加入到集群中成为备节点
[2025-02-26 14:49:13] Add datbase to cluster as secondary mode.
查看及进入容器
容器启动完导后，使用docker ps来查看容器启动情况，命令如下：
docker ps
通过docker logs来查看容器的日志，查看启动情况
docker logs node01docker logs node02
通过docker exec进入容器，然后切换到gbasedbt用户下
docker exec -it node01 bash
su - gbasedbtdocker exec -it node02 bash
su - gbasedbt
容器内数据库集群主备切换
容器内的集群切换与常规集群切换相同（使用DRAUTO值为1，主节点保持模式），当主节点（node01）所在的容器关闭时，备节点（node02）所在的容器升为标准节点；当原主节点（node01）恢复后，node01将恢复成主节点，而node2降级为备节点。
使用docker stop关闭主节点（node01）
docker stop node01
使用docker logs 查看容器内状态
docker logs node02 -f
备节点（node02）数据库升级为标准模式（5），类似如下
[2025-02-26 14:49:50] DATABASE STATUS CHANGE! LAST STATUS: 2, CURRENT: 5.
重新启动原主节点（node01），而后查看数据库状态
docker start node01
docker logs node01 -f
原主节点（node01）重新升级为主用（5）
[2025-02-26 14:52:41] DATABASE STATUS CHANGE! LAST STATUS: 2, CURRENT: 5.
查看备节点（node02）上的数据库状态
docker logs node02 -f
备节点（node02）的状态降级为备用（2）
[2025-02-26 14:52:40] DATABASE STATUS CHANGE! LAST STATUS: 5, CURRENT: 2.
