kubectl-aws-cli 镜像文档

1. 镜像概述

kubectl-aws-cli是一个轻量级Docker镜像，旨在提供构建时最新版本的kubectl（Kubernetes命令行工具）和awscli（AWS命令行工具）。该镜像专注于精简体积，适合需要在单一环境中同时管理Kubernetes集群和AWS资源的场景。

2. 核心功能与特性

• 轻量级设计：采用精简基础镜像，最小化体积和资源占用
• 工具集成：包含构建时最新版本的kubectl和awscli，无需额外安装
• 版本同步：工具版本在镜像构建时确定，确保使用当时最新稳定版

3. 使用场景

• 多云管理任务：需同时操作Kubernetes集群（如EKS）和AWS服务（如S3、EC2）的场景
• CI/CD流水线：在自动化流程中集成Kubernetes部署与AWS资源配置步骤
• 本地开发调试：开发者本地环境快速获取完整工具链，避免系统环境依赖冲突
• 临时运维操作：用于临时诊断或管理任务，无需在主机系统安装工具

4. 使用方法

4.1 拉取镜像

从镜像仓库拉取最新版本（假设仓库为wialus/kubectl-aws-cli）：

bash
docker pull wialus/kubectl-aws-cli

4.2 基本命令执行

需挂载本地配置文件以授权工具访问目标资源：

4.2.1 执行kubectl命令

挂载Kubernetes配置文件（kubeconfig）以操作集群：

bash
docker run --rm \
  -v ~/.kube/config:/root/.kube/config \  # 挂载本地kubeconfig
  wialus/kubectl-aws-cli \
  kubectl get namespaces  # 示例：查看命名空间

4.2.2 执行awscli命令

挂载AWS凭证文件以访问AWS资源：

bash
docker run --rm \
  -v ~/.aws/credentials:/root/.aws/credentials \  # 挂载AWS凭证
  -v ~/.aws/config:/root/.aws/config \            # 可选：挂载AWS配置
  wialus/kubectl-aws-cli \
  aws s3 ls  # 示例：列出S3存储桶

4.2.3 组合操作

同时执行Kubernetes和AWS命令：

bash
docker run --rm \
  -v ~/.kube/config:/root/.kube/config \
  -v ~/.aws/credentials:/root/.aws/credentials \
  wialus/kubectl-aws-cli \
  sh -c "kubectl get pods -n default && aws ec2 describe-regions"

4.3 交互式使用

通过-it参数进入容器交互式终端：

bash
docker run -it --rm \
  -v ~/.kube/config:/root/.kube/config \
  -v ~/.aws/credentials:/root/.aws/credentials \
  wialus/kubectl-aws-cli /bin/sh

5. 注意事项

• 版本兼容性：工具版本为镜像构建时的最新版，如需特定版本请查看镜像标签或联系维护者
• 凭证安全：挂载本地配置文件时，确保文件权限限制（如chmod 600 ~/.aws/credentials）
• 网络访问：容器需具备访问目标Kubernetes集群和AWS服务的网络连通性
• 配置持久化：长期使用可通过数据卷挂载配置目录，避免重复挂载操作