philmbrandwatch/ecr-credentials-updater

philmbrandwatch/ecr-credentials-updater 镜像说明

镜像概述

本镜像提供轻量工具，解决非AWS EC2环境下Kubernetes集群无法自动获取Amazon ECR凭证的问题。通过定期更新集群内的凭证Secret，确保集群持续拥有拉取ECR镜像的权限，避免因凭证过期导致服务部署或更新失败。

核心功能

• 自动生成并更新Kubernetes集群中的ECR凭证Secret
• 支持非EC2托管的Kubernetes环境（自建集群、其他云厂商集群等）
• 可配置凭证更新周期（默认12小时，匹配ECR凭证有效期）
• 轻量无额外依赖，部署便捷

使用场景

适用于以下场景：

1. 自建Kubernetes集群需要拉取Amazon ECR中的镜像
2. 非AWS云厂商（如阿里云、腾讯云）的K8s集群访问ECR镜像
3. 本地开发环境（如Minikube）测试ECR中的镜像

配置说明

需通过环境变量配置以下参数：

• AWS_ACCESS_KEY_ID: 具备ECR读取权限的AWS访问密钥ID
• AWS_SECRET_ACCESS_KEY: 对应AWS秘密访问密钥
• AWS_REGION: ECR仓库所在的AWS区域（如us-east-1）
• K8S_SECRET_NAME: 存储ECR凭证的Kubernetes Secret名称
• K8S_NAMESPACE: Secret所在的Kubernetes命名空间（默认：default）
• UPDATE_INTERVAL: 凭证更新周期（单位：秒，默认：43200即12小时）

部署示例

Docker Run 命令

bash
docker run -d \
  --name ecr-cred-updater \
  -e AWS_ACCESS_KEY_ID="your_aws_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_aws_secret_key" \
  -e AWS_REGION="us-east-1" \
  -e K8S_SECRET_NAME="ecr-docker-config" \
  -e K8S_NAMESPACE="app-namespace" \
  -e UPDATE_INTERVAL="43200" \
  philmbrandwatch/ecr-credentials-updater

Docker Compose 配置

yaml
version: "3.8"
services:
  ecr-credentials-updater:
    image: philmbrandwatch/ecr-credentials-updater
    container_name: ecr-cred-updater
    environment:
      AWS_ACCESS_KEY_ID: "your_aws_access_key"
      AWS_SECRET_ACCESS_KEY: "your_aws_secret_key"
      AWS_REGION: "us-east-1"
      K8S_SECRET_NAME: "ecr-docker-config"
      K8S_NAMESPACE: "app-namespace"
      UPDATE_INTERVAL: "43200"
    restart: always

注意：部署前需确保容器具备访问目标Kubernetes集群的权限（如挂载kubeconfig文件或配置集群内RBAC权限）。