Cloud-Toolbox 镜像文档

镜像概述

Cloud-Toolbox是一个集成了Azure、AWS、Google Cloud等主流云服务CLI，以及Docker、Kubernetes、OpenShift、Helm、Ansible、Terraform、HashiCorp Vault等工具的Docker镜像。它提供包含zsh和bash的平台无关开发环境，旨在解决跨操作系统的工具链一致性问题，适用于日常云服务管理、容器编排和自动化部署工作。

核心功能与特性

全面的工具链集成

• 云服务CLI：Azure CLI（az）、AWS CLI、Google Cloud CLI（gcloud）
• 容器与编排工具：Docker、kubectl、oc-cli（OpenShift CLI）、Helm、crictl、Velero、Stern、KubeLogin
• 自动化与IaC工具：Ansible、Terraform、Jinja2、Sentinel
• 安全工具：HashiCorp Vault、OpenSSH
• 其他工具：zsh、bash等shell环境

多平台支持

自2022-08-25_01版本起，支持arm64/aarch64和amd64架构，已在Linux/amd64和Macbook M1（arm64）设备上验证兼容性。

版本变体

提供三种版本满足不同需求：

• base：基于Ubuntu，包含核心工具集，版本标签格式为YYYY-MM-dd_base（如2023-03-15_base）
• complete：在base版本基础上扩展更多工具，标签格式为YYYY-MM-dd_complete
• minimal：基于Alpine，包含最小化工具集，适用于自动化场景，注重低漏洞风险

灵活配置能力

• 自定义CA证书：主机~/ca-certificates目录下的证书会被自动挂载到容器并信任
• 启动脚本：.autoexec.sh文件可挂载到容器，在bash和zsh启动时自动执行，支持自定义环境变量、别名等

便捷的容器管理

提供run.sh脚本简化容器操作：自动检查并附加到运行中的容器，或拉取最新镜像启动新容器。

使用场景

• 多云管理：统一操作Azure、AWS、Google Cloud等多云平台资源
• Kubernetes开发：使用kubectl、Helm、oc-cli等工具进行集群管理和应用部署
• 基础设施即代码（IaC）：通过Terraform、Ansible实现环境自动化构建与配置
• 跨平台开发：在Linux、macOS等不同系统上提供一致的工具链环境
• 自动化脚本执行：minimal版本可用于CI/CD流水线等自动化场景，减少依赖冲突

使用方法

默认Shell与启动配置

• 默认shell为sh，但容器启动时默认执行/bin/bash
• 支持zsh，可通过zsh命令切换
• 自定义启动脚本：将主机的.autoexec.sh挂载到容器，脚本会在bash/zsh启动时自动加载

run.sh脚本使用

1. 检查是否存在运行中的toolbox容器
2. 若存在，附加到容器并启动/bin/bash
3. 若不存在，拉取最新镜像并启动交互式容器，默认使用/bin/zsh

手动启动容器示例

bash
# 启动最新base版本
docker run -it --rm ksandermann/cloud-toolbox:latest

# 启动complete版本
docker run -it --rm ksandermann/cloud-toolbox:complete

# 启动特定版本
docker run -it --rm ksandermann/cloud-toolbox:2023-03-15_complete

# 挂载自定义CA证书和启动脚本
docker run -it --rm \
  -v ~/ca-certificates:/usr/local/share/ca-certificates \
  -v ~/.autoexec.sh:/root/.autoexec.sh \
  ksandermann/cloud-toolbox:latest

版本历史

最新版本信息

• latest=2023-03-15_base
• complete=2023-03-15_complete

工具版本明细（部分）

完整版本历史

2022-10-10之前的版本历史