apecloud/dbctl 提供 dbctl cluster create/list/backup 等子命令，与 KubeBlocks Operator CR 交互完成数据库 provisioning 与故障切换。镜像定位为一次性或 CI Job 工具，非 Web 或数据库服务端。与 mysql 客户端镜像相比专用于 KubeBlocks 生态；典型在 Jenkins/GitLab CI 或运维跳板机 docker run --rm 执行，需挂载 kubeconfig 与 --network host 访问 apiserver。

快速启动

docker run --rm \
  -v ~/.kube/config:/root/.kube/config \
  docker.io/apecloud/dbctl:latest \
  dbctl version

推荐实践

docker run --rm \
  -v ~/.kube/config:/root/.kube/config:ro \
  -e KUBECONFIG=/root/.kube/config \
  docker.io/apecloud/dbctl:0.9.0 \
  dbctl cluster list -n kb-system

核心参数说明

• -v .../.kube/config:... — 挂载集群 kubeconfig
• -e KUBECONFIG — 指定配置文件路径
• --rm — CLI 任务完成即退出
• 定位 — KubeBlocks 运维 CLI
• 前提 — 集群已装 kubeblocks operator
• 固定 tag — dbctl 与 operator 版本对齐