bootstrap-controller 镜像文档

镜像概述

bootstrap-controller是Weave Gitops Enterprise的核心组件，作为引导控制器，其主要功能是简化Weave Gitops Enterprise的初始化部署流程，自动完成环境配置、资源创建及GitOps工作流的基础设置，确保企业级GitOps环境快速、准确地投入使用。

核心功能和特性

• 自动化部署初始化：自动执行Weave Gitops Enterprise的基础部署步骤，减少手动操作，降低配置错误风险。
• 配置管理：集中管理部署相关配置，支持通过环境变量或配置文件自定义参数，适配不同部署场景。
• Git仓库集成：与指定Git仓库同步，确保部署配置与GitOps源保持一致，支持配置变更的自动拉取与应用。
• 状态监控：实时监控引导过程状态，提供部署进度反馈和错误处理机制，便于问题排查。
• 版本兼容性：与Weave Gitops Enterprise各版本保持兼容，支持平滑升级与版本回滚。

使用场景和适用范围

• 企业级GitOps环境部署：适用于企业搭建基于Weave Gitops Enterprise的GitOps平台，简化初始配置流程。
• 多集群管理：支持跨多个Kubernetes集群的Weave Gitops Enterprise统一部署与配置同步。
• 持续部署流程搭建：作为GitOps工作流的起点，帮助团队快速建立自动化持续部署流程。
• 环境标准化：确保开发、测试、生产等多环境的Weave Gitops Enterprise配置一致，减少环境差异问题。

使用方法和配置说明

前提条件

• 已安装Docker环境
• 具备目标Kubernetes集群的访问权限（需提供kubeconfig文件）
• 可访问的Git仓库（用于存储GitOps配置，控制器需具备读写权限）

Docker Run部署示例

docker run -d \
  --name bootstrap-controller \
  -e WEAVE_GITOPS_ENTERPRISE_VERSION="v2.1.0" \
  -e GIT_REPO_URL="[***]" \
  -e GIT_BRANCH="main" \
  -e KUBECONFIG_PATH="/kubeconfig" \
  -e LOG_LEVEL="info" \
  -v /path/to/local/kubeconfig:/kubeconfig \
  weaveworks/bootstrap-controller:latest

Docker Compose配置示例

version: '3.8'
services:
  bootstrap-controller:
    image: weaveworks/bootstrap-controller:latest
    container_name: weave-bootstrap-controller
    environment:
      - WEAVE_GITOPS_ENTERPRISE_VERSION=v2.1.0
      - GIT_REPO_URL=[***]
      - GIT_BRANCH=main
      - KUBECONFIG_PATH=/kubeconfig
      - LOG_LEVEL=info
    volumes:
      - ./kubeconfig:/kubeconfig  # 挂载本地kubeconfig至容器内指定路径
    restart: unless-stopped  # 异常退出时自动重启

环境变量配置说明

关键配置说明

1. Git仓库配置
   需确保GIT_REPO_URL指向可访问的Git仓库，且控制器对该仓库具有读写权限（建议通过SSH密钥或令牌认证），以便同步配置变更。

2. Kubeconfig挂载
   通过-v参数将本地kubeconfig文件挂载至容器内KUBECONFIG_PATH指定路径（默认/kubeconfig），确保控制器能访问目标Kubernetes集群。

3. 版本管理
   建议显式指定WEAVE_GITOPS_ENTERPRISE_VERSION（如v2.1.0），避免使用latest标签带来的版本不确定性，确保与目标环境兼容。

注意事项

• 权限要求：容器需以足够权限运行，确保能读取挂载的kubeconfig文件及执行部署操作。
• 网络访问：需确保容器可访问目标Kubernetes集群API、Git仓库及Weaveworks镜像仓库。
• 日志查看：通过docker logs bootstrap-controller查看实时日志，用于监控部署进度或排查问题。