Junto Seguros DevOps Docker 镜像文档

1. 镜像概述和主要用途

1.1 概述

本镜像由 Junto Seguros DevOps 团队（维护***：***）维护，基于 Alpine Linux 系统构建，标签为 dotnet。镜像旨在提供一站式的构建与部署工具环境，集成了多种开发运维（DevOps）常用工具，适用于自动化构建、部署及基础设施管理场景。

1.2 基础信息

2. 核心功能和特性

2.1 集成工具集

镜像预装了以下关键工具（完整版本信息见附录）：

• 云服务与基础设施：AWS CLI、Terraform
• 容器化工具：Docker、docker-compose
• 构建与部署：OpenJDK 1.8、ghr（GitHub Release 工具）
• 数据处理：jq（JSON 处理）、json（JSON 工具）
• 版本控制与发布：git 相关工具（间接支持，通过基础环境）

2.2 特性

• 轻量级基础：基于 Alpine Linux，系统体积小，资源占用低。
• 全栈工具链：覆盖从代码构建、容器化到云资源部署的全流程工具。
• 多语言支持：集成 OpenJDK 1.8，支持 Java 应用构建。

2. 核心功能和特性

2.1 集成工具集

镜像预装了以下关键工具（完整版本信息见附录）：

• 云服务与基础设施：AWS CLI、Terraform
• 容器化工具：Docker、docker-compose
• 构建与部署：OpenJDK 1.8、ghr（GitHub Release 工具）
• 数据处理：jq（JSON 处理）、json（JSON 工具）
• 版本控制与发布：git 相关工具（间接支持，通过基础环境）

2.2 特性

• 轻量级基础：基于 Alpine Linux，系统体积小，资源占用低。
• 全栈工具链：覆盖从代码构建、容器化到云资源部署的全流程工具。
• 多语言支持：集成 OpenJDK 1.8，支持 Java 应用构建。

3. 使用场景和适用范围

3.1 典型场景

• CI/CD 流程：作为持续集成/持续部署（CI/CD）流水线的执行环境，用于代码编译、测试、打包及部署。
• 自动化部署：通过 Terraform 管理云基础设施，结合 AWS CLI 操作 AWS 资源，实现自动化部署。
• 容器化构建：使用 Docker 和 docker-compose 构建、测试容器镜像，或编排多容器应用。
• 版本发布：通过 ghr 工具将构建产物发布至 GitHub Releases。

3.2 适用范围

• 开发团队：本地构建、测试环境一致性保障。
• DevOps 团队：自动化运维脚本执行、基础设施即代码（IaC）管理。

4. 使用方法和配置说明

4.1 镜像拉取

通过以下命令拉取镜像：

bash
docker pull [镜像仓库地址]/juntoseguros/devops:dotnet

注：实际使用时需替换 [镜像仓库地址] 为该镜像所在的 Docker 仓库地址（如 Docker Hub、私有仓库等）。

4.2 容器运行

4.2.1 基础运行示例

以交互式终端模式运行容器，挂载本地工作目录（/local/workdir）至容器内 /workspace：

bash
docker run -it --rm \
  -v /local/workdir:/workspace \
  --name devops-dotnet \
  [镜像仓库地址]/juntoseguros/devops:dotnet /bin/sh

进入容器后，可直接使用集成工具（如 terraform --version、aws --version 等）。

4.2.2 执行单命令示例

在容器内执行 Terraform 初始化命令：

bash
docker run --rm \
  -v /local/terraform/code:/workspace \
  [镜像仓库地址]/juntoseguros/devops:dotnet \
  sh -c "cd /workspace && terraform init"

4.3 docker-compose 配置示例

创建 docker-compose.yml 文件，定义服务及挂载目录：

yaml
version: '3'
services:
  devops-tools:
    image: [镜像仓库地址]/juntoseguros/devops:dotnet
    volumes:
      - ./local/workspace:/workspace
      - ~/.aws:/root/.aws  # 挂载本地 AWS 配置（可选，用于 AWS CLI 认证）
    working_dir: /workspace
    tty: true  # 保持终端交互

启动服务：

bash
docker-compose up -d

进入容器：

bash
docker-compose exec devops-tools /bin/sh

4.4 配置说明

• 数据持久化：建议通过 -v 参数挂载本地目录至容器内 /workspace，避免容器退出后数据丢失。
• 工具配置：如需自定义工具配置（如 AWS CLI 凭证、Terraform 后端配置），可挂载本地配置文件（如 ~/.aws/credentials）至容器对应路径（如 /root/.aws/credentials）。
• 环境变量：目前镜像无预设环境变量，如有特殊需求可通过 -e 参数传入（如 docker run -e "VAR=value" ...）。

5. 附录：集成工具版本列表

6. 参考信息

• Dockerfile 地址：[***]
• 维护团队：Junto Seguros DevOps（***）
• 最后修改时间：2019年10月23日