protometa/infra-tools

infra-tools 镜像文档

镜像概述

infra-tools 是一个集成了多种基础设施管理工具的Docker环境，包含Docker、aws-cli、kops、kubectl、helm、Node.js和Pulumi。该镜像旨在为CI/CD流水线提供统一的工具链，简化基础设施相关的自动化任务执行。

核心功能和特性

• 多工具集成：包含基础设施管理所需的核心工具，无需单独安装配置
• Docker环境：内置Docker引擎，支持容器化操作
• 云服务管理：通过aws-cli实现AWS资源的管理和操作
• Kubernetes工具链：集成kops（集群部署）、kubectl（集群管理）和helm（包管理）
• 开发环境：提供Node.js运行环境，支持JavaScript/TypeScript开发
• 基础设施即代码：包含Pulumi，支持通过代码定义和管理云基础设施

使用场景和适用范围

• CI/CD流水线：在持续集成/持续部署流程中执行基础设施部署、配置和管理任务
• 基础设施自动化：通过Pulumi实现基础设施即代码（IaC）的自动化部署
• Kubernetes集群管理：使用kops创建和管理Kubernetes集群，通过kubectl和helm进行日常运维
• 云资源操作：通过aws-cli执行AWS资源的创建、配置和维护

使用方法和配置说明

基本使用（docker run）

bash
docker run --rm -it docker.xuanyuan.run/infra-tools [command]

示例：执行aws-cli命令

bash
docker run --rm -it docker.xuanyuan.run/infra-tools aws --version

示例：执行kubectl命令

bash
docker run --rm -it docker.xuanyuan.run/infra-tools kubectl version --client

在CI环境中使用

可将该镜像作为CI作业的基础环境，例如在GitLab CI中的配置：

yaml
stages:
  - infrastructure

deploy-infrastructure:
  stage: infrastructure
  image: docker.xuanyuan.run/infra-tools
  script:
    - pulumi login
    - pulumi up --yes
    - kubectl apply -f k8s/deployment.yaml
    - helm upgrade my-app ./charts/my-app

工具版本说明

该镜像包含以下工具（具体版本可能随镜像更新而变化）：

• Docker
• aws-cli
• kops
• kubectl
• helm
• Node.js (LTS版本)
• Pulumi

环境变量配置

可通过环境变量配置工具行为，例如：

• AWS_ACCESS_KEY_ID：aws-cli的访问密钥ID
• AWS_SECRET_ACCESS_KEY：aws-cli的密钥
• KUBECONFIG：kubectl的配置文件路径
• PULUMI_CONFIG_PASSPHRASE：Pulumi的配置密码

注意事项

• 运行时可能需要挂载宿主机的Docker socket以使用Docker功能：-v /var/run/docker.sock:/var/run/docker.sock
• 敏感信息（如AWS密钥、Pulumi凭证）建议通过环境变量或CI/CD系统的保密变量传递
• 根据实际需求，可能需要在容器中持久化配置文件或工具状态