visol/devops-toolbox Docker 镜像 - 轩辕镜像

Ubuntu 22.04 工具集镜像

镜像概述

本镜像基于Ubuntu 22.04 LTS构建，预装了一系列开发与运维常用工具，包括Kubernetes管理工具（kubectl、helm）、云存储操作工具（gsutil）及数据格式处理工具（yq、jq）。旨在为用户提供开箱即用的一体化环境，简化Kubernetes集群管理、云资源操作及数据处理任务。

核心功能与特性

• Kubernetes管理工具

  • kubectl：Kubernetes集群命令行管理工具，支持集群资源创建、查看、更新及删除
  • helm：Kubernetes包管理器，用于定义、安装和升级Kubernetes应用发布包

• 云存储操作工具

  • gsutil：Google Cloud Storage命令行工具，支持云存储桶管理、文件上传/下载、权限配置等

• 数据格式处理工具

  • yq：轻量级YAML/JSON处理工具，支持查询、修改、转换YAML/JSON文件
  • jq：命令行JSON处理器，支持JSON数据解析、过滤、转换及格式化

• 基础系统环境
  基于Ubuntu 22.04 LTS，包含bash、curl、wget等基础工具，兼容主流Linux命令行工作流

使用场景

• Kubernetes集群管理：直接通过kubectl执行集群资源操作（如kubectl get pods），或使用helm部署应用（如helm install myapp ./chart）
• 云存储操作：通过gsutil管理GCP云存储资源（如gsutil cp localfile gs://bucket/path）
• 数据格式处理：使用jq解析JSON响应（如curl api.example.com | jq '.data'），或通过yq修改YAML配置文件（如yq eval '.spec.replicas=3' deployment.yaml）
• CI/CD工作流集成：作为CI/CD流水线中的基础镜像，执行集群部署、配置更新、数据验证等自动化任务

使用方法与配置说明

基本使用

通过以下命令启动容器并进入交互式终端：

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

说明：--rm参数表示容器退出后自动清理，适合临时任务；如需持久化操作，可移除该参数。

工具版本验证

容器启动后，可通过以下命令验证工具是否正常安装：

bash
# 验证kubectl版本
kubectl version --client

# 验证helm版本
helm version

# 验证gsutil版本
gsutil version

# 验证yq版本
yq --version

# 验证jq版本
jq --version

持久化配置

如需持久化工具配置（如kubectl集群配置、gsutil凭证），可通过挂载主机目录实现：

bash
# 挂载kubectl配置目录（~/.kube）
docker run -it --rm -v ~/.kube:/root/.kube [镜像名称] bash

# 挂载gsutil配置目录（~/.config/gcloud）
docker run -it --rm -v ~/.config/gcloud:/root/.config/gcloud [镜像名称] bash

典型操作示例

1. Kubernetes资源管理

bash
# 查看集群节点
kubectl get nodes

# 使用helm部署应用
helm repo add bitnami [***]
helm install my-nginx bitnami/nginx

2. 云存储操作（GCP）

bash
# 列出GCS存储桶
gsutil ls

# 上传文件至存储桶
gsutil cp local-file.txt gs://my-bucket/path/

3. 数据格式处理

bash
# 使用jq解析JSON（提取用户列表）
echo '{"users": [{"name": "Alice"}, {"name": "Bob"}]}' | jq '.users[].name'

# 使用yq修改YAML（更新副本数）
yq eval '.spec.replicas = 5' deployment.yaml -i

环境变量配置

本镜像支持通过环境变量自定义基础行为，常用变量如下：

• TIMEZONE：设置容器时区（如Asia/Shanghai），默认使用UTC
  示例：docker run -it -e TIMEZONE=Asia/Shanghai [镜像名称] bash

注意事项

• 本镜像未包含任何云服务凭证或Kubernetes集群配置，需通过挂载主机配置文件或环境变量注入
• gsutil需预先在主机端完成GCP认证（gcloud init），再通过挂载配置目录复用凭证
• 工具版本随镜像构建更新，如需固定版本，建议在使用时通过apt或工具自身命令升级/降级