teutonet/ci-tools

ci-tools 镜像文档

镜像概述

ci-tools 是一个集成了多种CI/CD常用工具的Docker容器，旨在为持续集成和持续部署流程提供便捷的工具环境。该镜像预装了docker、kubectl、kustomize等核心工具，可直接用于执行容器构建、Kubernetes资源管理等操作，简化CI/CD流水线中的工具依赖配置。

核心功能和特性

• 工具集成：包含docker（容器引擎）、kubectl（Kubernetes命令行工具）、kustomize（Kubernetes配置管理工具）等常用CI/CD工具
• 环境一致性：提供统一的工具版本和运行环境，避免因工具版本差异导致的构建或部署问题
• 轻量级设计：在满足功能需求的前提下，保持镜像体积精简，适合在CI/CD环境中快速拉取和启动

使用场景和适用范围

• CI/CD流水线：在Jenkins、GitLab CI、GitHub Actions等CI/CD平台中作为执行环境，运行容器构建、镜像推送、Kubernetes部署等任务
• 自动化部署：用于自动化脚本中，执行kubectl命令管理Kubernetes集群资源或通过kustomize定制配置
• 本地开发辅助：作为临时工具环境，避免在本地系统直接安装多种工具

使用方法和配置说明

基本使用

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

bash
docker run -it --rm ci-tools /bin/bash

挂载Docker Socket（如需使用docker命令）

若需在容器内使用docker命令操作宿主机Docker引擎，需挂载宿主机的Docker socket：

bash
docker run -it --rm -v /var/run/docker.sock:/var/run/docker.sock ci-tools /bin/bash

挂载Kubernetes配置（如需使用kubectl）

将本地Kubernetes配置文件挂载到容器中，以使用kubectl操作集群：

bash
docker run -it --rm -v ~/.kube/config:/root/.kube/config ci-tools /bin/bash

执行命令示例

在CI/CD流水线中直接执行命令：

bash
# 构建Docker镜像
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock ci-tools docker build -t my-app:latest .

# 使用kubectl查看集群节点
docker run --rm -v ~/.kube/config:/root/.kube/config ci-tools kubectl get nodes

# 使用kustomize构建Kubernetes配置
docker run --rm -v $(pwd)/kustomize:/kustomize ci-tools kustomize build /kustomize

环境变量

目前该镜像未定义特殊环境变量，工具配置主要通过挂载配置文件或命令行参数实现。