neuralegion/devops

DevOps 工具集成镜像

1. 镜像概述和主要用途

1.1 概述

本镜像为集成式 DevOps 工具容器，基于轻量级 Linux 发行版（Alpine/Debian Slim）构建，包含开发、构建、部署、运维全流程常用工具，旨在提供一致的运行环境，简化 DevOps 流程落地。

1.2 主要用途

• 本地开发环境快速标准化（统一工具版本和配置）
• CI/CD 流水线任务执行（如代码拉取、构建、测试、部署）
• 自动化脚本运行（基础设施管理、应用发布）
• 跨环境一致性验证（开发/测试/生产环境工具链对齐）

2. 核心功能和特性

2.1 集成工具集

• 版本控制：Git（含 Git LFS）、SVN
• 容器化工具：Docker CLI、Docker Compose、buildx
• 编排工具：kubectl（Kubernetes 客户端）、helm
• IaC 工具：Terraform、Ansible、Packer
• 构建工具：Maven、Gradle、npm、yarn、pip
• CI/CD 组件：GitLab Runner 核心依赖、Jenkins Agent 基础库
• 实用工具：curl、wget、jq、sed、awk、vim、ssh-client、ping、telnet

2.2 特性

• 多架构支持：amd64/arm64 架构兼容
• 轻量级基础：基于 Alpine 3.18（默认）或 Debian Slim，镜像体积优化
• 版本可控：工具版本预定义，支持通过标签指定工具版本组合（如 :v1.2-git2.40-terraform1.5）
• 可扩展配置：支持通过环境变量、挂载配置文件自定义工具行为
• 安全加固：非 root 用户运行（默认 devops 用户，UID 1000），最小权限原则

3. 使用场景和适用范围

3.1 典型场景

• 本地开发调试：快速拉起包含全套工具的环境，避免本地工具版本冲突
• CI/CD 流水线：作为 GitLab CI、GitHub Actions、Jenkins 的执行环境，运行构建/测试/部署脚本
• 基础设施即代码（IaC）执行：批量运行 Terraform apply、Ansible playbook
• 跨环境一致性验证：在开发、测试、生产环境使用相同镜像，消除"在我这能跑"问题

3.2 适用人群

• 开发工程师（需要统一开发环境）
• DevOps 工程师（自动化流程设计与执行）
• SRE（基础设施运维与监控）
• CI/CD 平台管理员（流水线环境标准化）

4. 使用方法和配置说明

4.1 获取镜像

bash
# 拉取最新版
docker pull devops-image:latest

# 拉取指定工具版本组合（示例：Git 2.40 + Terraform 1.5）
docker pull devops-image:v1.2-git2.40-terraform1.5

4.2 基本运行

4.2.1 交互式终端（本地开发调试）

bash
docker run -it --rm \
  --name devops-tools \
  -v $(pwd):/workspace \  # 挂载当前目录到容器工作区
  -v ~/.ssh:/home/devops/.ssh:ro \  # 只读挂载 SSH 密钥（用于 Git 认证）
  devops-image:latest \
  /bin/bash  # 启动 bash 终端

4.2.2 直接运行命令（CI/CD 流水线）

bash
# 示例：运行 Terraform 初始化
docker run --rm \
  -v $(pwd):/workspace \
  -e TF_VAR_env=prod \  # 传递 Terraform 变量
  devops-image:latest \
  terraform -chdir=/workspace init

# 示例：构建 Maven 项目
docker run --rm \
  -v $(pwd):/workspace \
  -v ~/.m2:/home/devops/.m2 \  # 挂载 Maven 缓存，加速构建
  devops-image:latest \
  mvn -f /workspace/pom.xml clean package

4.3 Docker Compose 配置

创建 docker-compose.yml：

yaml
version: '3.8'
services:
  devops:
    image: devops-image:latest
    volumes:
      - ./workspace:/workspace:rw  # 工作目录（读写）
      - /var/run/docker.sock:/var/run/docker.sock:ro  # 只读挂载 Docker  socket（如需在容器内操作宿主机 Docker）
      - ~/.kube:/home/devops/.kube:ro  # 挂载 K8s 配置（如需 kubectl 操作集群）
      - ~/.terraform.d:/home/devops/.terraform.d:rw  # Terraform 插件缓存
    environment:
      - DOCKER_HOST=unix:///var/run/docker.sock  # Docker 守护进程地址
      - KUBECONFIG=/home/devops/.kube/config  # kubeconfig 路径
      - NPM_CONFIG_PREFIX=/home/devops/.npm-global  # npm 全局安装路径
    user: devops  # 非 root 用户运行（默认 UID 1000）
    working_dir: /workspace  # 工作目录
    tty: true  # 保持终端连接

启动服务：

bash
docker-compose up -d  # 后台运行
docker-compose exec devops /bin/bash  # 进入容器终端

4.4 关键配置说明

4.4.1 环境变量

4.4.2 推荐挂载卷