razorpay/imagepullsecret-patcher

镜像概述

本Docker镜像专为Kubernetes环境设计，提供镜像拉取密钥（imagepull Secrets）的创建与修补功能，旨在简化容器镜像拉取过程中的认证配置，确保集群中Pod能够顺利访问私有或需要认证的容器镜像仓库。

核心功能与特性

主要功能

• 创建新密钥：根据提供的镜像仓库认证信息（如用户名、密码、仓库地址等），在指定Kubernetes命名空间中创建新的imagepull Secrets。
• 修补现有密钥：更新或修补已存在的imagepull Secrets，支持修改认证信息（如更新密码、更换仓库地址等），无需手动删除重建。

特性

• 支持标准Docker Registry认证格式（dockerconfigjson类型密钥）。
• 自动处理密钥编码与Kubernetes API交互，无需手动执行kubectl命令。
• 轻量级设计，基于最小化基础镜像，减少资源占用。

使用场景与适用范围

典型使用场景

• 新集群初始化：在Kubernetes集群部署初期，快速配置私有镜像仓库的拉取认证密钥。
• 密钥更新维护：当镜像仓库认证信息（如密码过期）变更时，批量或单独更新现有密钥。
• 跨命名空间管理：在多命名空间环境中，统一创建或同步镜像拉取密钥。

适用范围

• Kubernetes集群环境（支持v1.16+版本）。
• 需要访问私有Docker Registry、AWS ECR、Google GCR等需认证镜像仓库的场景。
• CI/CD流水线中集成，实现密钥的自动化创建与更新。

使用方法与配置说明

前提条件

• 运行环境需具备Kubernetes集群访问权限（通过挂载kubeconfig文件或集群内服务账户授权）。
• 已获取目标镜像仓库的认证信息（用户名、密码、仓库地址）。

环境变量说明

部署示例

1. 创建新的imagepull Secret

bash
docker run --rm \
  -e REGISTRY_URL="https://index.docker.io/v1/" \
  -e REGISTRY_USERNAME="myuser" \
  -e REGISTRY_PASSWORD="mypassword" \
  -e SECRET_NAME="my-registry-secret" \
  -e NAMESPACE="default" \
  -v $HOME/.kube/config:/root/.kube/config \  # 挂载kubeconfig以访问集群
  [镜像名称]:[标签]

2. 修补现有Secret（更新认证信息）

bash
docker run --rm \
  -e REGISTRY_URL="https://index.docker.io/v1/" \
  -e REGISTRY_USERNAME="myuser" \
  -e REGISTRY_PASSWORD="newpassword" \  # 更新为新密码
  -e SECRET_NAME="my-registry-secret" \
  -e NAMESPACE="default" \
  -e PATCH_MODE="true" \
  -v $HOME/.kube/config:/root/.kube/config \
  [镜像名称]:[标签]

注意事项

• 挂载kubeconfig文件时，确保容器内用户（通常为root）对文件有读取权限。
• 对于需要跨命名空间操作的场景，需确保kubeconfig中配置的用户具备相应命名空间的secret资源操作权限（create、update权限）。
• 敏感信息（如密码）建议通过环境变量注入，避免硬编码在命令行中。