中标麒麟离线部署PolarDB-X企业版集群单container开发环境介绍

#### 目标

部署企业版集群，其中 GMS, DN, CN, CDC 节点各 1 个

#### 安装前准备

* 确保系统为kylin或neokylin操作系统

* 空闲内存必须8GB，如果不满8gb空闲内存，使用磁盘交换空间

#### 空闲内存不足8gb处理方式(不推荐)，反之，此处可不看

* 检查当前的交换空间(两种方法可以同时使用)

```

sudo swapon --show

free -h

```

* 创建8GB交换文件

```

fallocate -l 8G /swapfile

```

* 设置正确权限

```

chmod 600 /swapfile

```

* 将文件标记为交换空间

```

mkswap /swapfile

```

* 启用交换文件

```

swapon /swapfile

```

* 验证交换空间是否添加

```

swapon --show

free -h

```

* 使交换文件永久生效(在重启后仍然有效)

```

echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

```

* 调整交换设置（可选）：

您可以调整 "swappiness" 值，它决定了系统使用交换空间的倾向。值范围从 0 到 100，较低的值表示系统更倾向于使用物理内存。

* 查看当前值

```

cat /proc/sys/vm/swappiness

```

* 临时更改，重启后失效

```

sysctl vm.swappiness=10

```

* 永久更改(添加或修改vm.swappiness=10)

```

echo 'vm.swappiness=10' | tee -a /etc/sysctl.conf

sysctl -p

```

* 注意事项：

1.增加交换空间会占用硬盘空间。

2.过度依赖交换空间会显著降低系统性能，尤其是对于数据库这样的1/0 密集型应用。

3.在SSD上使用交换空间可能会增加磁盘的写入负载，可能影响SSD 的寿命。

4.这只是一个临时解决方案。长期来看，增加物理内存或优化应用程序的内存使用才是更好的解决方法。

#### 离线安装docker(版本号:27.1.1)

- 下载Docker安装包：

https://download.docker.com/linux/static/stable/x86_64/docker-27.1.1.tgz

- 解压安装包：

```bash

tar xzvf docker-27.1.1.tgz

```

- 复制Docker可执行文件到/usr/bin/：

```bash

sudo cp docker/* /usr/bin/

```

- 编辑Docker服务配置文件：

```bash

vim /etc/systemd/system/docker.service

```

```

[Unit]

Description=Docker Application Container Engine

Documentation=https://docs.docker.com

After=network-online.target firewalld.service

Wants=network-online.target

[Service]

Type=notify

ExecStart=/usr/bin/dockerd

ExecReload=/bin/kill -s HUP $MAINPID

LimitNOFILE=infinity

LimitNPROC=infinity

LimitCORE=infinity

TimeoutStartSec=0

Delegate=yes

KillMode=process

Restart=on-failure

StartLimitBurst=3

StartLimitInterval=60s

[Install]

WantedBy=multi-user.target

```

- 重新加载systemd配置：

```bash

sudo systemctl daemon-reload

```

- 启动Docker服务：

```bash

sudo systemctl start docker

```

- 设置Docker开机自启动：

```bash

sudo systemctl enable docker

```

- 验证Docker安装是否成功：

```bash

docker --version

```

- 运行Hello World容器验证Docker是否正常工作：

```bash

sudo docker run hello-world

```

#### 离线安装PolarDB-x(版本号：
5.6.29-PXC-5.4.19-SNAPSHOT)

##### 镜像压缩包获取方式一：从百度云盘下载压缩包(X86、amd64,一般都是X86)

```

X86下载链接:链接:
https://pan.baidu.com/s/1nfmTV9B0NiLhw-7CbjO88g?pwd=1234 提取码: 1234

amd64下载链接:
https://pan.baidu.com/s/1nvTktPyZDoqCsQbXOjS0TQ?pwd=1234 提取码: 1234

```

##### 镜像压缩包获取方式二

* 注意事项

```

1、本地计算机需有docker环境

2、请注意本地计算机的芯片

```

* 将镜像下载到本地

```

docker pull polardbx/polardb-x

```

* 使用命令导出镜像为压缩包

```

docker save polardbx/polardb-x | gzip > polardb-x.tar.gz

```

##### 上传镜像压缩包到目标计算机，执行下面命令导入镜像

```

docker load < polardb-x.tar.gz

```

##### 自定义docker网络,php部分也是这个网络

```

docker network create my_app_network

```

##### 创建并运行容器

* 方式一

```

docker run -d --name some-polardb-x --network my_app_network -p 8527:8527 polardbx/polardb-x

```

* 方式二(不推荐)

- 使用swap弥补内存不足，前提是需按照前面方式生成swap

- -m 3g表示容器可以使用最多 3GB 的物理内存

- --memory-swap 11g表示container总限制在11GB，其中可以使用最多 8GB 的交换空间（11GB 总限制 - 3GB 物理内存）

```

docker run -d --name some-polardb-x --network my_app_network -p 8527:8527 -m 3g --memory-swap 11g polardbx/polardb-x

```

#### 安装mariadb(mysql的一个分支与mysql兼容)

```

sudo yum install mariadb

```

#### 验证安装

1. 使用数据库连接工具连接PolarDB-X：

- 任何可以连接到mysql的工具都可以连接到poloardb-x

- mysql -h127.0.0.1 -P8527 -upolardbx_root -p123456

- 查看是否连接成功

如果以上操作都能正常执行，说明PolarDB-X安装和配置成功。

#### 注意事项

* 启动时，如果内存超过8gb，一般需3分钟，如果使用了交换空间时间还要延长，并且基本处于无法使用状态，在控制台运行一个新建数据库的命令都要以分钟计算。

* 使用docker desktop容器化安装，如果将内存从原来设置的超过8gb的内存变为小于8gb，会导致无法启动，就算恢复为原来的内存，都会导致部分container无法启动

* 如遇问题，请查阅PolarDB-X官方文档或寻求技术支持

* 参考资料

https://www.polardbx.com/document?type=PolarDB-X

https://blog.csdn.net/m0_55877125/article/details/131050511