weave-gitops资源管理控制器镜像文档

镜像概述

本镜像提供一个控制器组件，专门用于管理weave-gitops相关资源。它作为weave-gitops生态的一部分，负责自动化处理资源的生命周期，包括创建、更新、删除及配置维护，确保weave-gitops环境中各类资源的一致性和可用性。

核心功能与特性

• 资源生命周期管理：自动化处理weave-gitops相关资源的创建、更新和删除操作，减少手动干预。
• 配置维护：持续监控资源配置状态，确保配置与预期状态一致，支持动态调整。
• weave-gitops集成：与weave-gitops平台深度集成，同步资源状态与Git仓库配置，符合GitOps工作流。
• 稳定性保障：具备故障恢复机制，在资源异常时自动尝试修复，提升系统稳定性。

使用场景

• GitOps环境资源管理：在基于weave-gitops构建的GitOps工作流中，用于自动化管理集群内资源（如应用部署配置、基础设施资源等）。
• 大规模部署场景：当需要管理大量weave-gitops相关资源时，通过控制器实现批量操作与统一配置。
• 持续交付流水线：作为CI/CD流水线的一部分，在应用发布过程中自动配置和更新weave-gitops资源。

使用方法与配置说明

前置条件

• 已部署weave-gitops平台，且控制器可访问weave-gitops API。
• 具备Docker环境或Kubernetes集群（若用于容器编排）。

基本使用（Docker Run）

docker run -d \
  --name weave-gitops-controller \
  -e WEAVE_GITOPS_API_URL="[***]" \
  -e RESOURCE_NAMESPACE="weave-gitops-system" \
  -e LOG_LEVEL="info" \
  weave-gitops/resource-controller:latest

环境变量配置

Docker Compose配置示例

version: '3'
services:
  weave-gitops-controller:
    image: weave-gitops/resource-controller:latest
    container_name: weave-gitops-controller
    environment:
      - WEAVE_GITOPS_API_URL=[***]
      - RESOURCE_NAMESPACE=weave-gitops-system
      - LOG_LEVEL=info
      - SYNC_INTERVAL=60
    restart: unless-stopped

资源配置说明

控制器通过监听weave-gitops的Git仓库配置（如GitRepository、HelmRelease等CRD）来管理资源。具体资源类型及配置规则需参考weave-gitops***文档中关于资源定义的说明。

注意事项

• 确保控制器与weave-gitops平台版本兼容，不同版本可能存在API差异。
• 生产环境中建议通过Kubernetes Deployment部署，配合ConfigMap/Secret管理配置，提升可靠性。
• 调整SYNC_INTERVAL时需平衡资源消耗与同步及时性，高频同步可能增加API负载。