cloudkats/ci-tools

CI工具镜像

镜像概述和主要用途

本Docker镜像集成了多种自动化工具，旨在为CI/CD流程提供一站式的工具支持。通过将各类常用工具集中在单一镜像中，简化自动化任务的环境配置，提高开发和运维效率。主要用于自动化脚本执行、数据处理、版本控制、云服务交互及网络诊断等场景。

核心功能和特性

已安装工具

系统工具（OS tools）

• jq：轻量级JSON处理器，用于解析和转换JSON数据
  （项目地址：https://stedolan.github.io/jq/%EF%BC%89

• Git：分布式版本控制系统，用于代码管理和版本控制
  （参考教程：[***]

• Netcat：网络工具，支持TCP/UDP连接、端口扫描和数据传输
  （使用示例：[***]

Python工具

• aws-cli：AWS命令行工具，用于管理AWS云服务资源
  （项目地址：https://github.com/aws/aws-cli%EF%BC%89

• aws boto3：AWS SDK for Python，用于通过Python代码与AWS服务交互
  （快速入门：[***]

• PyYAML：Python YAML解析库，用于处理YAML格式数据
  （PyPI地址：[***]

• yq：YAML处理器，基于jq语法的YAML数据查询和转换工具
  （PyPI地址：[***]

• python-nmap：Nmap网络扫描工具的Python接口，用于网络探测和安全审计
  （PyPI地址：[***]

使用场景和适用范围

• CI/CD流水线：在自动化构建、测试、部署流程中执行脚本和工具命令
• 云服务管理：通过aws-cli和boto3自动化AWS资源操作
• 数据处理：使用jq、yq、PyYAML处理JSON/YAML格式的配置文件或数据
• 版本控制：通过Git进行代码拉取、提交和版本管理
• 网络诊断：使用Netcat和python-nmap进行端口检测和网络扫描

适用用户：开发团队、运维团队、DevOps工程师，以及需要在统一环境中执行自动化任务的场景。

使用方法和配置说明

基本使用

启动容器

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

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

工具使用示例

1. 使用jq处理JSON数据：

   bash
   echo '{"name": "CI Tools", "version": "1.0"}' | jq '.name'
   # 输出："CI Tools"
   

2. 使用aws-cli配置AWS凭证：

   bash
   aws configure
   # 按提示输入AWS Access Key ID、Secret Access Key、默认区域和输出格式
   

3. 使用Git克隆代码仓库：

   bash
   git clone https://github.com/example/repo.git
   

4. 使用Netcat测试端口连通性：

   bash
   nc -zv example.com 80
   # 输出：Connection to example.com 80 port [tcp/http] succeeded!
   

Docker Compose配置示例

创建docker-compose.yml文件，集成该镜像到服务中：

yaml
version: '3'
services:
  ci-tools:
    image: [镜像名称]
    volumes:
      - ./scripts:/scripts  # 挂载本地脚本目录
      - ~/.aws:/root/.aws    # 挂载AWS凭证目录（可选）
    command: /scripts/automation.sh  # 执行自动化脚本

启动服务：

bash
docker-compose up

注意事项

• 若需持久化工具配置（如Git用户信息、AWS凭证），建议通过挂载卷（Volume）实现
• 部分工具（如aws-cli）需要提前配置凭证或环境变量，可通过-e参数传入环境变量：

  bash
  docker run -it --rm -e AWS_ACCESS_KEY_ID=xxx -e AWS_SECRET_ACCESS_KEY=xxx [镜像名称] aws s3 ls