---
author: aming
email: jikcheng@163.com
title: Docker 安裝KingbaseES讀寫分離叢集
creation_date: 2023-02-16 13:59
Last modified date: 2023-02-16 19:18
tags:  Docker 安裝KingbaseES讀寫分離叢集
File Folder with relative path: reading notes/doc/Docker技術入門與實戰
remark:
other:
---

## 本章背景知識

大體步驟參考：[[流複製--V8R6手工搭建]] 
[docker安裝叢集 - 技術乾貨 - 金倉社群 (kingbase.com.cn)](https://bbs.kingbase.com.cn/thread-15775-1-1.html)
  本章使用三節點容器搭建主備流複製叢集。

### 一、容器節點 IP規劃
```bash
IP規劃：
192.168.20.111	--節點一主機IP（主節點）
192.168.20.112	--節點二主機IP（備節點）
192.168.20.113	--節點三主機IP（備節點）
```
### 二、容器資訊規劃
| 部分     | 說明                                                                |
| -------- | ------------------------------------------------------------------- |
| IP: 埠 | 192.168.20.111:54321，192.168.20.112:54322，192.168.20.113:54 323。 |
| 主機名稱 | c_node1，c_node2，c_node3。                                         |
| 容器名稱 | kcm_kingbase01，kcm_kingbase02，kcm_kingbase03。                    |

### 三、宿主機環境準備
1、下載網盤中的映象 `kignbase.v8r6c5b23.tar `
2、將映象匯入 Docker 伺服器中。
```bash
$ docker load -i kignbase.v8r6c5b23.tar 
```
3、檢視是否匯入成功。
```bash
$ docker images
REPOSITORY    TAG        IMAGE ID       CREATED         SIZE
kesimg86523   latest     64f5d3730270   24 hours ago    2.6GB
```
4、建立 Docker 容器私有網路。
```bash
$ docker network create --subnet=192.168.20.0/24 kcmnet
```
編者注：由於 Docker 自帶的網路介面不允許指定靜態 IP 地址，所以需要新建私有網路。

## LAB01-Docker 容器準備

`````ad-warning
如果需要清空環境則需要執行以下命令。
``` bash
docker rm -f `docker ps -aq`
```
此命令非常危險請只在測試環境上操作。
`````

1、建立流複製所需的容器。
```bash
docker run -itd --privileged -h c_node1 --name kcm_kingbase01 --net kcmnet --ip 192.168.20.111  -p 54321:54321   --restart=on-failure:3  kesimg86523:latest /usr/sbin/init

docker run -itd  --privileged -h c_node2 --name kcm_kingbase02  --net kcmnet --ip 192.168.20.112  -p 54322:54321   --restart=on-failure:3  kesimg86523:latest /usr/sbin/init

docker run -itd  --privileged -h c_node3 --name kcm_kingbase03 --net kcmnet  --ip 192.168.20.113  -p 54323:54321   --restart=on-failure:3  kesimg86523:latest /usr/sbin/init
```

2、命令說明。

| 選項                     | 說明                                            |
| ------------------------ | ----------------------------------------------- |
| -it                      | 使用 tty 偽終端，並進入互動式模式。             |
| -d                       | 使用守護程式執行容器。                          |
| -h                       | 容器主機名。                                    |
| --restart-=on-faulure: 3 | 當容器故障退出，重啟 3 次，3 次之後不會再重啟。 |
| --net kcmnet             | 指定流複製私有網路環境。                                                |
## LAB02-備節點資料目錄清空
1、請執行以下操作進入 `kcm_kingbase02`, `kcm_kingbase03` 容器。
2、刪除 `kcm_kingbase02` 資料目錄。
```bash
docker$ docker exec -u kingbase -it kcm_kingbase02 /bin/bash
<contanier>$ sys_ctl stop 
<contanier>$ rm -rf /home/kingbase/data/*
<contanier>$ rm -rf /home/kingbase/data/.wallet
<contanier>$ exit
```
3、刪除 `kcm_kingbase03` 資料目錄。
```bash
docker$ docker exec -u kingbase -it kcm_kingbase03 /bin/bash
<contanier>$ sys_ctl stop 
<contanier>$ rm -rf /home/kingbase/data/*
<contanier>$ rm -rf /home/kingbase/data/.wallet
<contanier>$ exit
```

## LAB03-容器主機名解析
###  一、所有容器配置 host 檔案
1、c_node1。
```
$ docker exec -u root -it kcm_kingbase01 vi /etc/hosts

------------------寫入以下內容------------------
192.168.20.111 c_node1
192.168.20.112 c_node2
192.168.20.113 c_node3
```
2、c_node2。
```
$ docker exec -u root -it kcm_kingbase02 vi /etc/hosts
------------------寫入以下內容------------------
192.168.20.111 c_node1
192.168.20.112 c_node2
192.168.20.113 c_node3
```
3、c_node3。
```bash
$ docker exec -u root -it kcm_kingbase03 vi /etc/hosts
------------------寫入以下內容------------------
192.168.20.111 c_node1
192.168.20.112 c_node2
192.168.20.113 c_node3
```
### 二、驗證主機名解析正確
1、node1。
```
docker exec -u root -it kcm_kingbase01 ping -c 4 c_node1
docker exec -u root -it kcm_kingbase01 ping -c 4 c_node2
docker exec -u root -it kcm_kingbase01 ping -c 4 c_node3
```
2、node2。
```
docker exec -u root -it kcm_kingbase02 ping -c 4 c_node1
docker exec -u root -it kcm_kingbase02 ping -c 4 c_node2
docker exec -u root -it kcm_kingbase02 ping -c 4 c_node3
```
3、node3。
```
docker exec -u root -it kcm_kingbase03 ping -c 4 c_node1
docker exec -u root -it kcm_kingbase03 ping -c 4 c_node2
docker exec -u root -it kcm_kingbase03 ping -c 4 c_node3
```

## LAB04-配置主節點（c_node 1）

###   一、配置歸檔及流複製引數
1、進入 `kcm_kingbase01` 容器。
```bash
$ docker exec -u kingbase -it kcm_kingbase01 /bin/bash
```
2、配置流複製引數。
```
<contanier>$ cat >> $KINGBASE_DATA/kingbase.conf <<eof wal_log_hints="on" wal_level="replica" minimal="" replica="" or="" logical="" max_wal_senders="10" max="" number="" of="" walsender="" processes="" max_replication_slots="10" wal_keep_segments="1024" in="" logfile="" segments="" each="" disables="" hot_standby="on" synchronous_commit="on" synchronous_standby_names="1(c_node1,c_node2,c_node3)" hot_standby_feedback="on" fsync="on" eof="" echo="" sys_hba.="" conf="" replication="">$ cat >> $KINGBASE_DATA/sys_hba.conf <<eof host="" replication="" system="" md5="" eof="" echo="" grep="">$ sys_ctl restart -D $KINGBASE_DATA
```

### 四、在主節點上建立 replication 複製槽

1、檢視當前複製槽

```bash
$ docker exec -u kingbase -it kcm_kingbase01 /bin/bash
<contanier>$  ksql  -U system -d test
# \x 
SELECT * FROM sys_replication_slots;
```

2、建立複製槽

```sql
<contanier>$  ksql  -U system -d test
test# SELECT * FROM sys_create_physical_replication_slot('slot_node2');
test# SELECT * FROM sys_create_physical_replication_slot('slot_node3');
test# SELECT slot_name, slot_type, active FROM sys_replication_slots;
```

## LAB05-配置備節點 (c_node 2)

###  一、用sys_basebackup全量傳輸
1、進入 kcm_kingbase 02 備節點。
```bash
$ docker exec -u kingbase -it kcm_kingbase02 /bin/bash
```
2、全量傳輸資料。
```bash
<contanier>$ sys_basebackup -h c_node1 -p 54321 -U system -Fp -X stream -v -P -D $KINGBASE_DATA
ls -lh $KINGBASE_DATA
du -sh $KINGBASE_DATA
```

### 二、配置 kingbase. conf

```bash
<contanier>$ cat >> $KINGBASE_DATA/kingbase.conf << EOF 
primary_conninfo='port=54321 host=c_node1 user=system password=kingbase application_name=c_node2' 
recovery_target_timeline='latest' 
primary_slot_name ='slot_node2'
EOF
touch $KINGBASE_DATA/standby.signal
```

### 三、啟動備節點並開啟流複製

```bash
sys_ctl start -D $KINGBASE_DATA
tail -f $KINGBASE_DATA/sys_log/kingbase*.log
```
## LAB06-配置備節點 (c_node 3)

###  一、用 sys_basebackup 全量傳輸
1、進入kcm_kingbase02備節點
```bash
$ docker exec -u kingbase -it kcm_kingbase03 /bin/bash
```
2、全量傳輸資料。
```bash
<contanier>$ sys_basebackup -h c_node1 -p 54321 -U system -Fp -X stream -v -P -D $KINGBASE_DATA
ls -lh $KINGBASE_DATA
du -sh $KINGBASE_DATA
```

### 二、配置 kingbase.conf

```bash
<contanier>$ cat >> $KINGBASE_DATA/kingbase.conf << EOF 
primary_conninfo='port=54321 host=c_node1 user=system password=kingbase application_name=c_node3' 
recovery_target_timeline='latest' 
primary_slot_name ='slot_node3'
EOF
touch $KINGBASE_DATA/standby.signal
```

### 三、啟動備節點並開啟流複製

```bash
sys_ctl start -D $KINGBASE_DATA
tail -f $KINGBASE_DATA/sys_log/kingbase*.log
```

## LAB07- 驗證流複製環境

### 一、在主節點檢視流複製狀態
1、進入 kcm_kingbase 01 主節點。
```bash
$ docker exec -u kingbase -it kcm_kingbase01 /bin/bash
```
2、檢視 replication 程式 (主節點上可以看到正在向從節點傳送資料流
```bash
$ ps -ef|grep -v grep|grep -E 'sender|receiver'
```
3、檢視流複製狀態

```bash
ksql -U system -d test 
SELECT * FROM sys_stat_replication;
```
4、檢視複製槽資訊。

```bash
SELECT * FROM sys_replication_slots;
```

### 二、在主節點建立測試資料
1、進入 `kcm_kingbase01` 容器。
```bash
$ docker exec -u kingbase -it kcm_kingbase01 /bin/bash
```
2、生成測試資料。
```sql
<contanier>$ ksql -U system -d test 
CREATE database prod01; 
TEST=# \c prod01 system
CREATE table t01 (id int ,name text);
INSERT INTO t01 SELECT generate_series(1,1000),md5(random());
SELECT * FROM t01 limit 2;
```

### 三、在主節點建立測試資料 (c_node 2)
1、進入 `kcm_kingbase01` 容器。
```bash
$ docker exec -u kingbase -it kcm_kingbase02 /bin/bash
```
2、檢視資料。
```bash
SELECT * FROM t01 limit 2;
```

### 四、在主節點建立測試資料 (c_node 3)
1、進入 `kcm_kingbase01` 容器。
```bash
$ docker exec -u kingbase -it kcm_kingbase03 /bin/bash
```
2、檢視資料。
```bash
SELECT * FROM t01 limit 2;
```</contanier></contanier></contanier></contanier></contanier></contanier></contanier></eof></eof></contanier></contanier></contanier></contanier></contanier></contanier></contanier></contanier></contanier>

Docker 搭建KingbaseES主備流複製

相關文章