容器部署准备

硬件

说明

为了提高可用性，降低数据丢失的风险，建议在单台计算机上只运行一个节点。KaiwuDB 采用跨节点复制机制，如果在一台计算机上同时运行多个节点，当计算机发生故障时，更有可能丢失数据。

下表列出使用容器安装包部署 KaiwuDB 所需的硬件规格要求。

项目	要求
CPU 和内存	- 单节点配置建议不低于 4 核 8G。 - 对于数据量大、复杂工作负载、高并发和高性能场景，建议配置更高的 CPU 和内存资源以确保系统的高效运行。
磁盘	- 推荐使用 SSD 或者 NVMe 设备，尽量避免使用 NFS、CIFS、CEPH 等共享存储。 - 使用 HDD 硬盘部署单机版本时，避免设备数过多或每秒写入测点数过高，否则数据写入性能将显著下降；不建议使用 HDD 部署分布式集群版本。 - 磁盘必须能够实现 500 IOPS 和 30MB/s 处理效率。 - KaiwuDB 系统自身启动不会占用过多磁盘容量（低于 1G）。实际所需磁盘大小主要取决于用户的业务量以及是否开启 KaiwuDB 压缩等可以减少原始数据磁盘占用的功能，更多详细信息，参见预估磁盘使用量。
文件系统	建议使用 ext4 文件系统。

操作系统

说明

如果目标机器尚未安装 Docker，请提前安装适合您操作系统的 Docker 容器。更多信息，参见 Docker 安装文档open in new window。
如果目标机器无法联网且未安装 Docker，请采用二进制包安装 Docker。更多信息，参见 Docker 安装文档open in new window和安装后说明open in new window。
未提及的操作系统版本也许可以运行 KaiwuDB，但尚未得到 KaiwuDB 官方支持。

KaiwuDB 容器安装包支持在以下已安装 Docker 的操作系统中进行安装部署。

操作系统	版本	架构
Anolis	7.9	ARM_64
	7.9	x86_64
	8.6	ARM_64
	8.6	x86_64
CentOS	7	x86_64
	8	x86_64
Debian	V11	ARM_64
KylinOS	V10 SP3 2403 V10 SP3 2303	ARM_64
	V10 SP3 2403 V10 SP3 2303	x86_64
openEuler	22.03	x86_64
Ubuntu	V18.04	x86_64
	V20.04	ARM_64
	V20.04	x86_64
	V22.04	ARM_64
	V22.04	x86_64
	V24.04	ARM_64
	V24.04	x86_64
UOS	1050e	x86_64
	1060e	x86_64
	1060e	ARM_64
	1070e	x86_64

软件依赖

目标机器已安装 Docker Compose（1.20.0 及以上版本）。

在线安装 Docker Compose，参见 Docker 官方文档open in new window。
离线安装 Docker Compose，参见 Docker 官方文档open in new window。

示例：

sudo apt-get install docker-compose

端口

下表列出 KaiwuDB 服务需要映射的端口。在安装部署前，确保目标机器的以下端口没有被占用且没有被防火墙拦截。在安装部署时，用户可以修改 deploy.cfg 文件中的端口配置参数。

端口号	说明
`8080`	数据库 Web 服务端口
`26257`	数据库服务端口、节点监听端口和对外连接端口

安装包

获取系统环境对应的容器安装包，将安装包复制到待安装 KaiwuDB 的目标机器上，然后解压缩安装包：

tar -zxvf <install_package_name>

解压后生成的目录包含以下文件：

文件	说明
`add_user.sh`	安装、启动 KaiwuDB 后，为 KaiwuDB 数据库创建用户。
`deploy.cfg`	安装部署配置文件，用于配置部署节点的 IP 地址、端口等配置信息。
`deploy.sh`	安装部署脚本，用于安装、卸载、启动、状态获取、关停和重启等操作。
`packages` 目录	存放 DEB、RPM 和镜像包。
`utils` 目录	存放工具类脚本。

节点配置

SSH 免密登录

登录当前节点，生成公私密钥对。
```
ssh-keygen -f ~/.ssh/id_rsa -N ""
```
参数说明：
- -f ~/.ssh/id_rsa：指定生成的密钥对文件目录。
- -N：将密钥密码设置为空，以实现免密登录。

将密钥分发至集群其它节点。

ssh-copy-id -f -i ~/.ssh/id_rsa.pub -o StrictHostKeyChecking=no <target_node>

确认是否可以使用 SSH 免密登录到集群其它节点。
```
ssh <target_node>
```

时钟同步

KaiwuDB 采用中等强度的时钟同步机制来维持数据的一致性。当节点检测到自身的机器时间与集群中至少 50% 的节点的机器时间的误差值超过集群最大允许时间误差值（默认为 500 ms）的 80% 时，该节点会自动停止，从而避免违反数据一致性，带来读写旧数据的风险。每个节点都必须运行 NTP（Network Time Protocol，网络时间协议）或其他时钟同步软件，防止时钟漂移得太远。

以下示例以 CentOS 7 为例，介绍如何配置时钟同步。

使用 SSH 登录到将要部署集群的节点。
关闭 timesyncd 服务。
```
timedatectl set-ntp no
```
安装 NTP 服务。
```
sudo apt install ntp
```
关闭 NTP 后台进程。
```
service ntp stop
```
通过 NTP 服务同步机器时间。
```
ntpdate -u 0.cn.pool.ntp.org
```

打开 /etc/ntp.conf 文件，查找 server 和 pool 的相关配置并将其修改为如下内容。

server 0.cn.pool.ntp.org iburst
server 1.cn.pool.ntp.org iburst
server 2.cn.pool.ntp.org iburst
server 3.cn.pool.ntp.org iburst

启动 NTP 服务。
```
service ntp start
```
在所有要安装 KaiwuDB 服务的集群节点上重复执行以上步骤。

# 容器部署准备

# 硬件

# 操作系统

# 软件依赖

# 端口

# 安装包

# 节点配置

# SSH 免密登录

# 时钟同步