gtsopour/awscli-kubectl

镜像概述

本镜像基于Alpine Linux构建，采用最小化设计，集成了AWS CLI v2和kubectl工具。旨在提供轻量级、高效的容器环境，用于在各类场景中便捷地管理AWS云资源和Kubernetes集群。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，启动速度快，资源占用低
• 工具集成：预装AWS CLI v2（Amazon Web Services命令行工具）和kubectl（Kubernetes命令行工具）
• 兼容性：支持标准的AWS CLI和kubectl命令，可直接对接AWS服务和Kubernetes集群
• 灵活性：可作为独立工具容器使用，或集成到CI/CD流水线中执行自动化操作

使用场景

• CI/CD流水线：在持续集成/持续部署流程中，执行AWS资源部署（如S3、ECS、EC2等）和Kubernetes资源管理（如部署应用、查看集群状态等）
• 本地开发：为开发环境提供统一的AWS和K8s工具集，避免本地环境配置冲突
• 临时管理：快速启动容器进行AWS账户配置、Kubernetes集群故障排查等临时操作
• 自动化脚本：作为脚本运行环境，执行包含AWS和K8s操作的自动化任务

使用方法和配置说明

基本使用

直接运行容器

docker
docker run --rm -it [镜像名称] sh

进入容器后，可直接使用aws和kubectl命令：

bash
# 查看AWS CLI版本
aws --version

# 查看kubectl版本
kubectl version --client

挂载配置文件（推荐）

为持久化AWS和Kubernetes配置，可挂载本地配置目录：

docker
docker run --rm -it \
  -v ~/.aws:/root/.aws \  # 挂载AWS配置（包含credentials和config）
  -v ~/.kube:/root/.kube \  # 挂载Kubernetes配置（kubeconfig）
  [镜像名称] sh

环境变量配置

可通过环境变量传递AWS配置（适用于无需持久化配置的场景）：

docker
docker run --rm -it \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -e AWS_REGION="us-west-2" \
  [镜像名称] aws s3 ls  # 示例：列出S3存储桶

Docker Compose示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  aws-kubectl:
    image: docker.xuanyuan.run/[镜像名称]
    volumes:
      - ~/.aws:/root/.aws
      - ~/.kube:/root/.kube
    tty: true
    stdin_open: true

启动服务：

bash
docker-compose up -d
docker-compose exec aws-kubectl sh

注意事项

• 确保本地AWS配置文件（~/.aws/credentials）和Kubernetes配置文件（~/.kube/config）具有正确的权限
• 如需使用特定版本的AWS CLI或kubectl，建议查看镜像标签以获取对应版本信息
• 在生产环境中使用时，应避免将敏感凭证直接通过环境变量传递，优先采用挂载配置文件或使用 secrets 管理