noose/kubectl-helm-aws

集成kubectl、Helm与AWS CLI v2的工具容器

镜像概述和主要用途

本镜像是一个预集成了kubectl（Kubernetes命令行工具）、Helm（Kubernetes包管理器）和AWS CLI v2（AWS命令行工具）的轻量级容器环境。旨在为用户提供一站式操作平台，无需在本地系统单独安装和配置上述工具，即可高效执行Kubernetes集群管理、Helm图表部署及AWS云资源操作等任务，确保操作环境的一致性和便捷性。

核心功能和特性

• 工具集成：包含最新稳定版kubectl、Helm及AWS CLI v2，满足Kubernetes与AWS生态的核心操作需求
• 轻量级基础：基于精简Linux基础镜像构建（如Alpine/Ubuntu Slim），镜像体积小，启动速度快
• 环境一致性：统一工具版本和运行环境，避免因本地工具版本差异导致的兼容性问题
• 即开即用：无需复杂配置，通过简单命令即可启动并使用所有集成工具
• 配置灵活性：支持挂载外部配置文件（如kubeconfig、AWS凭证）及工作目录，适配个性化需求

使用场景和适用范围

• CI/CD流水线：在自动化部署流程中执行Kubernetes资源部署（kubectl apply）、Helm图表安装（helm install）及AWS资源配置（如S3上传、EKS集群管理）
• 开发调试环境：开发人员快速启动工具环境，调试Kubernetes应用部署逻辑或AWS资源交互代码
• 临时管理任务：运维人员执行临时性集群检查（kubectl get pods）、Helm版本升级（helm upgrade）或AWS资源查询（aws ec2 describe-instances）
• 多环境隔离：通过挂载不同配置文件，在单一主机上切换Kubernetes集群上下文或AWS账户，实现多环境管理隔离

使用方法和配置说明

基础使用命令

通过docker run命令直接调用工具：

bash
# 查看kubectl版本
docker run --rm <镜像名称> kubectl version --client

# 查看Helm版本
docker run --rm <镜像名称> helm version

# 查看AWS CLI版本
docker run --rm <镜像名称> aws --version

挂载配置文件

1. Kubernetes集群配置（kubeconfig）

挂载本地kubeconfig文件以访问目标Kubernetes集群：

bash
# 查看集群节点信息（默认挂载~/.kube/config）
docker run --rm -v ~/.kube/config:/root/.kube/config <镜像名称> kubectl get nodes

# 挂载自定义kubeconfig路径
docker run --rm -v /path/to/custom/kubeconfig:/root/.kube/config <镜像名称> kubectl config view

2. AWS凭证配置

挂载AWS凭证文件以认证AWS服务访问：

bash
# 列出S3存储桶（默认挂载~/.aws目录）
docker run --rm -v ~/.aws:/root/.aws <镜像名称> aws s3 ls

# 指定AWS区域环境变量
docker run --rm -e AWS_REGION=us-west-2 -v ~/.aws:/root/.aws <镜像名称> aws ec2 describe-instances

交互式终端使用

启动交互式终端以连续执行多个命令：

bash
docker run -it --rm \
  -v ~/.kube/config:/root/.kube/config \
  -v ~/.aws:/root/.aws \
  -v $(pwd):/workspace \
  -w /workspace \
  <镜像名称> /bin/sh

进入终端后可执行组合操作：

bash
# 示例：使用Helm部署应用并通过AWS CLI记录部署日志
helm install my-app ./charts/my-app && \
aws cloudwatch put-log-events --log-group-name my-app-deploy --log-stream-name deploy-log --events file://deploy-events.json

持久化工作目录

挂载本地工作目录以处理Helm图表或Kubernetes清单文件：

bash
# 验证本地Helm图表
docker run --rm -v $(pwd):/workspace -w /workspace <镜像名称> helm lint ./my-chart

# 应用本地Kubernetes清单
docker run --rm -v ~/.kube/config:/root/.kube/config -v $(pwd):/workspace -w /workspace <镜像名称> kubectl apply -f ./k8s/deployment.yaml

环境变量配置

支持通过环境变量自定义工具行为：

• KUBECONFIG：指定kubeconfig文件路径（默认：/root/.kube/config）
• AWS_REGION：设置AWS默认区域（默认：us-east-1）
• AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY：直接注入AWS访问凭证（优先级高于挂载文件）

示例：通过环境变量注入AWS凭证

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID=<your-access-key> \
  -e AWS_SECRET_ACCESS_KEY=<your-secret-key> \
  -e AWS_REGION=eu-west-1 \
  <镜像名称> aws s3 ls