qca-k8s-bootstrap Docker镜像文档

镜像概述

qca-k8s-bootstrap Docker镜像专注于Kubernetes集群的引导与初始化流程，通过集成自动化配置逻辑，减少手动操作成本，确保集群部署的标准化和高效性。该镜像适用于各类Kubernetes环境，提供从集群初始化到基础组件配置的全流程支持。

核心功能和特性

• 自动化集群初始化：支持一键式Kubernetes控制平面初始化，自动生成必要配置文件
• 多节点部署支持：兼容单节点测试环境与多节点生产环境的部署需求
• 组件集成能力：可集成主流网络插件（如Calico、Flannel）和存储解决方案
• 配置验证机制：内置集群配置校验和节点健康检查功能，提前发现部署问题
• 版本兼容性：支持Kubernetes 1.24+主流版本，适配不同环境需求

使用场景和适用范围

• 新集群部署：快速搭建开发、测试或生产环境的Kubernetes集群
• 集群标准化：企业内部统一集群部署流程，确保环境一致性
• 快速环境重建：开发/测试场景下快速重置或重建集群环境
• 自动化运维：集成到CI/CD流程中实现集群的自动化部署与更新

使用方法和配置说明

基本使用（docker run命令）

docker run -d --name k8s-bootstrap \
  --privileged \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /etc/kubernetes:/etc/kubernetes \
  -v /boot:/boot \
  -e KUBE_VERSION=1.28.3 \
  -e CLUSTER_ROLE=control-plane \
  -e POD_CIDR=10.244.0.0/16 \
  qca/k8s-bootstrap:latest

环境变量配置说明

docker-compose配置示例

version: '3.8'
services:
  k8s-bootstrap:
    image: qca/k8s-bootstrap:latest
    container_name: k8s-bootstrap
    privileged: true
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /etc/kubernetes:/etc/kubernetes
      - /boot:/boot
      - ./bootstrap-config:/config  # 自定义配置文件挂载
    environment:
      - KUBE_VERSION=1.28.3
      - CLUSTER_ROLE=control-plane
      - POD_CIDR=10.244.0.0/16
      - NETWORK_PLUGIN=calico
      - APISERVER_ADVERTISE_ADDRESS=192.168.1.100
    restart: on-failure

自定义配置文件

如需使用自定义配置，可将配置文件挂载至容器/config目录，支持以下配置文件：

• cluster-config.yaml: 集群全局配置
• network-config.yaml: 网络插件详细配置
• addons.yaml: 额外组件部署清单（如Dashboard、Ingress等）

部署验证

容器启动后，可通过以下命令检查引导进度：

docker logs -f k8s-bootstrap

成功完成后，将输出集群加入命令（适用于worker节点），格式如下：

kubeadm join 192.168.1.100:6443 --token xxxxx.xxxxxxxxxx \
  --discovery-token-ca-cert-hash sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx