govpf/argocd-cmp-plugin

ArgoCD cmp-plugin镜像文档

镜像概述

本镜像为ArgoCD提供Config Management Plugin（CMP）功能，旨在扩展ArgoCD的配置管理能力。通过容器化部署，简化cmp-plugin的集成流程，支持用户自定义配置管理逻辑，实现与外部工具（如Kustomize、Helm、Jsonnet等）的无缝对接，提升ArgoCD在复杂应用场景下的配置管理灵活性。

核心功能与特性

• 配置管理扩展：支持自定义配置管理流程，满足特定业务场景下的配置处理需求
• 多工具集成：兼容主流配置管理工具（Kustomize、Helm、Jsonnet等），提供统一的插件接口
• 容器化部署：基于轻量级基础镜像构建，体积小、启动快，易于集成到ArgoCD环境
• 版本化管理：支持插件版本控制，便于升级与回滚操作
• 配置灵活性：通过环境变量和挂载配置文件实现插件行为自定义

使用场景与适用范围

• 复杂应用配置管理：需对应用配置进行多步骤处理（如模板渲染、变量替换、依赖解析）的场景
• 自定义工具集成：需要将内部自研配置工具或特定版本工具集成到ArgoCD的场景
• 标准化部署流程：在团队或组织内统一配置管理流程，确保部署一致性
• ArgoCD功能扩展：弥补ArgoCD原生配置管理能力不足的场景

使用方法与配置说明

前提条件

• 已部署ArgoCD 2.4+版本
• 具备Docker环境或容器运行时
• 熟悉ArgoCD插件配置方法

镜像拉取

bash
docker pull [镜像仓库地址]/argocd-cmp-plugin:[版本标签]

Docker Run示例

bash
docker run -d \
  --name argocd-cmp-plugin \
  -v /path/to/plugin-config:/etc/cmp-plugin/config \
  -e PLUGIN_MODE=custom \
  -e TOOL_CHAIN=kustomize:v4.5.7 \
  [镜像仓库地址]/argocd-cmp-plugin:[版本标签]

环境变量配置

ArgoCD集成配置

在ArgoCD的argocd-cm ConfigMap中添加插件配置：

yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-cm
  namespace: argocd
data:
  configManagementPlugins: |
    - name: custom-cmp-plugin
      init:
        command: ["/cmp-plugin/init.sh"]
      generate:
        command: ["/cmp-plugin/generate.sh"]
      lockRepo: true

持久化配置

通过挂载配置文件自定义插件行为，配置文件示例（config.yaml）：

yaml
tools:
  - name: kustomize
    version: v4.5.7
    path: /usr/local/bin/kustomize
  - name: helm
    version: v3.9.0
    path: /usr/local/bin/helm
hooks:
  pre-generate: /hooks/pre-generate.sh
  post-generate: /hooks/post-generate.sh

注意事项

• 确保插件镜像版本与ArgoCD版本兼容，建议使用官方推荐的版本组合
• 自定义工具需确保在镜像内或通过挂载方式提供可执行文件
• 生产环境中建议通过Secret管理敏感配置信息
• 高并发场景下可调整资源限制，避免插件成为性能瓶颈