apkappa/argo-kustomized-helm

Argo自定义管理插件边车镜像

镜像概述

本镜像为Argo自定义管理插件的边车（sidecar）容器镜像，集成了kubectl和helm命令行工具。作为边车容器运行时，可与Argo工作流主容器协同工作，提供Kubernetes资源管理和Helm图表操作能力，扩展Argo工作流的自定义管理功能。

核心功能和特性

• 工具集成：内置kubectl（Kubernetes命令行工具）和helm（Kubernetes包管理工具），无需额外安装即可使用
• 边车模式：设计为边车容器，可轻松集成到Argo工作流的Pod中，与主容器共享网络和存储
• 兼容性：与Argo自定义管理插件架构兼容，支持标准的插件交互流程
• 轻量级：基于精简基础镜像构建，减少资源占用

使用场景和适用范围

• Argo工作流中需要执行Kubernetes资源创建、更新、删除等操作的场景
• 自动化部署流程中需通过Helm安装、升级或卸载应用的场景
• 自定义Argo管理插件中需要调用kubectl或helm命令的扩展场景
• Kubernetes集群内基于Argo的CI/CD流水线资源管理环节

使用方法和配置说明

基本运行方式

通过以下命令可直接运行镜像并进入交互终端：

bash
docker run -it --rm argoproj/argo-custom-management-plugin-sidecar:latest /bin/sh

在Argo工作流中配置为边车容器

在Argo Workflow的模板定义中，可通过sidecars字段添加本镜像作为边车容器：

yaml
apiVersion: argoproj.io/v1alpha1
kind: Workflow
metadata:
  generateName: argo-custom-plugin-example-
spec:
  entrypoint: main
  templates:
  - name: main
    container:
      image: your-main-plugin-image:latest
      command: ["./your-plugin-script.sh"]
    sidecars:
    - name: argo-management-sidecar
      image: argoproj/argo-custom-management-plugin-sidecar:latest
      command: ["/bin/sh", "-c", "tail -f /dev/null"]  # 保持容器运行
      resources:
        requests:
          cpu: 100m
          memory: 128Mi
        limits:
          cpu: 500m
          memory: 256Mi

工具使用示例

在边车容器中执行kubectl命令：

bash
# 查看集群节点
kubectl get nodes

# 创建Kubernetes部署
kubectl apply -f deployment.yaml

在边车容器中执行helm命令：

bash
# 添加Helm仓库
helm repo add stable https://charts.helm.sh/stable

# 安装应用
helm install my-app stable/nginx

注意事项

• 运行时需确保边车容器具有适当的Kubernetes集群访问权限（通过挂载kubeconfig文件或使用Service Account）
• 根据实际需求调整资源限制（CPU/内存）以避免资源竞争
• 选择与Argo工作流版本兼容的镜像标签，建议使用固定版本而非latest以确保稳定性