mrkaran/eks-gitops

eks-gitops

镜像概述和主要用途

基于Alpine的Docker镜像，集成了kubectl、aws CLI、aws-iam-authenticator和kubeval工具。主要用于EKS（Amazon Elastic Kubernetes Service）集群的持续部署（CD）环境，提供与EKS集群交互所需的核心工具链。镜像预配置KUBECONFIG以使用aws-iam-authenticator，适配EKS集群默认认证机制。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 完整工具链：包含EKS部署所需关键工具：
  • kubectl：Kubernetes命令行工具，用于集群管理
  • aws：AWS CLI，用于AWS资源操作
  • aws-iam-authenticator：EKS集群身份验证工具
  • kubeval：Kubernetes配置验证工具
• 预配置认证：自动配置KUBECONFIG使用aws-iam-authenticator，无需手动设置
• AWS认证兼容：支持所有AWS官方认证方式（环境变量、IAM角色、凭证文件等）

使用场景和适用范围

• EKS集群的持续部署（CD）流程
• CI/CD管道中执行Kubernetes资源部署、AWS操作或配置验证
• 需要在容器环境中临时使用EKS工具链的场景
• 自动化脚本中集成EKS集群管理操作

使用方法和配置说明

拉取镜像

bash
docker pull mrkaran/eks-gitops:latest

基本运行方式

容器运行需满足两个条件：

1. 提供CLUSTER_REGION和CLUSTER_NAME环境变量
2. 容器可访问AWS认证凭证（通过环境变量、IAM角色或挂载凭证文件）

示例：使用环境变量提供AWS凭证

bash
docker run -it \
  -e CLUSTER_REGION=us-west-2 \
  -e CLUSTER_NAME=my-eks-cluster \
  -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE \
  -e AWS_SECRET_ACCESS_KEY=secretkeyexample \
  mrkaran/eks-gitops:latest

示例：使用IAM角色（适用于EC2或EKS Pod）

bash
docker run -it \
  -e CLUSTER_REGION=us-east-1 \
  -e CLUSTER_NAME=production-cluster \
  mrkaran/eks-gitops:latest

环境变量说明

典型应用示例：在CI/CD管道中使用

以下为GitLab CI/CD配置示例：

yaml
deploy_to_eks:
  image: mrkaran/eks-gitops:latest
  variables:
    CLUSTER_REGION: us-west-2
    CLUSTER_NAME: my-eks-cluster
  script:
    - kubectl apply -f k8s/deployment.yaml
    - kubectl rollout status deployment/my-app
  only:
    - main

注意事项

• 容器必须能够访问至少一种AWS支持的认证凭证，否则无法与EKS集群建立连接
• CLUSTER_REGION和CLUSTER_NAME为ENTRYPOINT脚本的必填参数，未设置将导致容器启动失败
• 工具版本随镜像更新而更新，如需特定版本请使用带标签的镜像（如mrkaran/eks-gitops:v1.0.0）