使用Docker部署SeekDB

简介

seekdb Docker镜像可在dockerhub、quay.io和ghcr.io获取，旨在帮助用户快速搭建SeekDB测试环境。

关键注意事项：

• 在MacOS和Intel芯片上，使用Docker版本大于4.9.0运行此镜像存在已知问题，可从此链接下载所需Docker版本。
• 此镜像仅用于测试目的，请勿在生产环境中使用。

前提条件

部署seekdb前，请确保满足以下要求：

• 主机至少拥有1个物理核心和2GB内存。
• 主机已安装并运行Docker。参考Docker安装指南。

启动SeekDB实例

启动SeekDB实例，请使用以下命令：

bash
docker run -d -p 2881:2881 -p 2886:2886 oceanbase/seekdb

# 如需在启动后执行初始化SQL脚本，需挂载包含初始化脚本的目录，并通过环境变量INIT_SCRIPTS_PATH指定容器内的目录。
# 请勿在SQL脚本中修改root用户密码。如需修改root用户密码，请使用环境变量ROOT_PASSWORD。
docker run -d -p 2881:2881 -p 2886:2886 -v {init_sql_folder_path}:/root/boot/init.d -e INIT_SCRIPTS_PATH=/root/boot/init.d oceanbase/seekdb

支持的环境变量

以下是镜像支持的环境变量表格：

如需修改其他SeekDB参数，可将配置文件挂载到容器内的/etc/oceanbase/seekdb.cnf路径。默认配置文件如下：

datafile_size=2G
datafile_next=2G
datafile_maxsize=50G
cpu_count=4
memory_limit=2G
log_disk_size=2G
# 按以下格式配置参数
# key=value

启动命令示例如下：

# 注意：如果决定使用配置文件，请不要指定与资源相关的环境变量。
docker run -d -p 2881:2881 -p 2886:2886 -v {config_file}:/etc/oceanbase/seekdb.cnf oceanbase/seekdb

数据持久化

SeekDB部署在/var/lib/oceanbase目录。如需在主机上持久化数据，请将主机的空目录挂载到该路径：

mkdir -p seekdb
docker run -d -p 2881:2881 -p 2886:2886 -v $PWD/seekdb:/var/lib/oceanbase --name seekdb oceanbase/seekdb

连接SeekDB实例

mysql -h 127.0.0.1 -P 2881 -u root -p    # 使用root账户连接

访问控制台

容器提供友好的Web界面，可在浏览器中访问[***]{server_ip}:2886。登录密码与root用户密码相同。若未设置ROOT_PASSWORD，密码字段留空即可。