simoncomputing/poll-deploy

ECR镜像更新监控与Helm Chart自动更新工具镜像

镜像概述

本镜像为一款专用工具，核心功能是定期轮询Amazon ECR（Elastic Container Registry）仓库中的镜像版本变化，当检测到目标镜像有更新时，自动更新关联的Helm Chart配置。注意：本镜像不能单独运行，需配合CI/CD管道、Kubernetes集群或其他部署系统组件使用。

核心功能和特性

• ECR镜像轮询：定期检查指定ECR仓库的镜像标签或摘要变化
• 更新检测：通过比对镜像元数据（如SHA摘要、标签版本）识别更新
• Helm Chart自动更新：发现镜像更新后，自动修改Helm Chart中的镜像版本配置
• 依赖集成：需与外部环境（如Helm客户端、AWS凭证、文件存储）配合工作

使用场景和适用范围

• Kubernetes自动部署流程：在基于Helm的K8s应用部署中，实现镜像更新到Chart配置的自动化同步
• CI/CD流水线集成：作为流水线环节，监控ECR镜像发布并触发Chart更新及后续部署
• 多环境镜像同步：在开发、测试、生产环境间，保持ECR镜像版本与Helm配置的一致性
• 适用对象：需要自动化管理容器镜像版本与Helm部署配置的DevOps团队

使用方法和配置说明

环境变量配置

镜像概述

本镜像为一款专用工具，核心功能是定期轮询Amazon ECR（Elastic Container Registry）仓库中的镜像版本变化，当检测到目标镜像有更新时，自动更新关联的Helm Chart配置。注意：本镜像不能单独运行，需配合CI/CD管道、Kubernetes集群或其他部署系统组件使用。

核心功能和特性

• ECR镜像轮询：定期检查指定ECR仓库的镜像标签或摘要变化
• 更新检测：通过比对镜像元数据（如SHA摘要、标签版本）识别更新
• Helm Chart自动更新：发现镜像更新后，自动修改Helm Chart中的镜像版本配置
• 依赖集成：需与外部环境（如Helm客户端、AWS凭证、文件存储）配合工作

使用场景和适用范围

• Kubernetes自动部署流程：在基于Helm的K8s应用部署中，实现镜像更新到Chart配置的自动化同步
• CI/CD流水线集成：作为流水线环节，监控ECR镜像发布并触发Chart更新及后续部署
• 多环境镜像同步：在开发、测试、生产环境间，保持ECR镜像版本与Helm配置的一致性
• 适用对象：需要自动化管理容器镜像版本与Helm部署配置的DevOps团队

使用方法和配置说明

环境变量配置

外部依赖挂载

• Helm Chart目录：需通过卷挂载本地Helm Chart目录到容器内的HELM_CHART_PATH路径
• AWS凭证：需通过环境变量或卷挂载提供AWS访问凭证（如AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY）以访问ECR

Docker Run示例

bash
docker run -d \
  -e ECR_REPO=123456789012.dkr.ecr.us-west-2.amazonaws.com/my-app \
  -e HELM_CHART_PATH=/charts/my-app-chart \
  -e POLL_INTERVAL=600 \
  -e AWS_REGION=us-west-2 \
  -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE \
  -e AWS_SECRET_ACCESS_KEY=secretExample \
  -v /local/path/to/helm/charts:/charts/my-app-chart \
  --name ecr-helm-updater \
  [镜像名称]:[标签]

注意事项

1. 权限要求：容器需具备读取ECR仓库元数据的权限（AWS IAM策略需包含ecr:DescribeImages权限）和修改Helm Chart文件的权限
2. 版本控制：建议对Helm Chart目录启用版本控制（如Git），以便追踪自动更新的变更
3. 错误处理：本镜像不包含独立的错误重试机制，需依赖外部系统（如CI/CD工具）处理失败场景
4. 单独运行限制：未集成完整的Helm客户端和AWS SDK运行时，需确保外部环境已提供必要依赖