circleci/k8s-release-agent

镜像概述

该镜像是一款专用于内部客户集群的发布代理工具，旨在为内部客户的容器集群环境提供发布流程的管理、协调与监控能力，确保集群中的应用发布过程稳定可控。

核心功能与特性

• 发布流程管理：支持标准化发布流程的定义与执行，协调集群中多组件的发布顺序
• 集群协调能力：与内部客户集群中的节点及组件进行通信，同步发布状态与进度
• 状态监控与报告：实时监控发布过程，生成状态报告并在异常时触发通知
• 兼容性支持：适配主流容器集群环境（如Kubernetes、Docker Swarm等）

使用场景

• 内部客户Kubernetes集群的应用版本发布与更新
• 多节点容器集群环境下的批量发布任务管理
• 需要集中协调的集群级发布流程自动化场景

使用方法与配置说明

安装与部署

Docker Run 命令示例

bash
docker run -d \
  --name release-agent \
  --restart=always \
  -e CLUSTER_ENDPOINT="https://cluster-api.internal.example.com:6443" \
  -e AUTH_TOKEN="internal-cluster-auth-token" \
  -e AGENT_NAME="customer-cluster-agent-01" \
  -v /var/run/docker.sock:/var/run/docker.sock \
  internal/release-agent:latest

环境变量配置

持久化配置

如需保存发布历史记录与配置文件，可挂载数据卷：

bash
docker run -d \
  --name release-agent \
  -v /local/path/to/agent-data:/agent/data \
  -e CLUSTER_ENDPOINT="https://cluster-api.internal.example.com:6443" \
  -e AUTH_TOKEN="internal-cluster-auth-token" \
  internal/release-agent:latest

运行状态检查

通过以下命令检查代理运行状态：

bash
docker logs release-agent

正常运行时日志将输出类似 Agent started successfully. Connected to cluster: https://cluster-api.internal.example.com:6443 的信息

注意事项

• 该镜像仅用于内部客户集群环境，禁止在公网环境部署
• 敏感信息（如AUTH_TOKEN）需通过环境变量或密钥管理工具注入，避免明文存储
• 建议为代理容器配置资源限制，避免影响集群整体性能：-m 512m --memory-swap=1g