alpine/gitlab-ansible-terraform

多功能DevOps工具集成镜像

1. 镜像概述与主要用途

1.1 概述

本Docker镜像集成了多种常用DevOps工具，旨在为基础设施即代码（IaC）管理、配置管理及云资源操作等任务提供统一的运行环境。当前镜像通过手动方式推送至仓库，未来计划实现自动化构建流程。

1.2 主要用途

• 支持基础设施即代码（Terraform）的编写、验证与部署
• 提供Ansible配置管理能力，实现自动化运维
• 集成AWS CLI v1，支持AWS云资源的命令行操作
• 兼容GitLab CI/CD流水线，通过预定义标签对接GitLab CI模板

2. 核心功能与特性

2.1 集成工具及版本信息

• Python 3：基础脚本运行环境
• Ansible：自动化配置管理工具
• Terraform：基础设施即代码工具（构建时最新版本为1.1.9，镜像标签包含"terraform"）
• gitlab-terraform：GitLab官方Terraform辅助脚本（来源：[***]
• AWS CLI v1：Amazon Web Services命令行工具

2.2 标签支持

提供两个标签版本，分别对应不同的GitLab CI模板：

• base：对应GitLab Terraform基础CI模板
  链接：[***]
• base.latest：对应GitLab Terraform最新基础CI模板
  链接：[***]

3. 使用场景与适用范围

3.1 适用场景

• GitLab CI/CD流水线：执行Terraform部署、Ansible配置管理等自动化任务
• 基础设施即代码管理：通过Terraform进行云资源编排与版本控制
• 配置管理：使用Ansible实现服务器集群的批量配置与应用部署
• AWS资源操作：通过AWS CLI v1管理AWS云服务（如EC2、S3、IAM等）
• 本地开发环境：统一团队工具版本，避免环境差异导致的兼容性问题

3.2 适用范围

• DevOps工程师、SRE（站点可靠性工程师）
• 基础设施即代码（IaC）项目开发与部署流程
• 需要集成Terraform、Ansible、AWS CLI的自动化工作流
• GitLab CI/CD流水线环境标准化

4. 使用方法与配置说明

4.1 镜像拉取

根据需求拉取对应标签的镜像：

bash
# 拉取base标签镜像
docker pull [镜像仓库地址]/[镜像名]:base

# 拉取base.latest标签镜像
docker pull [镜像仓库地址]/[镜像名]:base.latest

注：请将[镜像仓库地址]和[镜像名]替换为实际的仓库地址和镜像名称。

4.2 容器运行示例

4.2.1 基础交互式终端

启动容器并进入交互式终端，直接使用集成工具：

bash
docker run -it --rm [镜像仓库地址]/[镜像名]:base /bin/bash

进入容器后可验证工具版本：

bash
# 验证Terraform版本
terraform --version  # 应输出1.1.9版本信息

# 验证Ansible版本
ansible --version

# 验证AWS CLI版本
aws --version  # 应输出aws-cli/1.x.x版本信息

4.2.2 挂载本地项目目录（如Terraform项目）

将本地IaC项目目录挂载至容器，执行部署命令：

bash
# 挂载当前目录至容器/workspace，执行terraform init
docker run -it --rm -v $(pwd):/workspace -w /workspace [镜像仓库地址]/[镜像名]:base terraform init

# 执行Ansible playbook
docker run -it --rm -v $(pwd):/workspace -w /workspace [镜像仓库地址]/[镜像名]:base ansible-playbook site.yml

• -v $(pwd):/workspace：挂载本地当前目录至容器内/workspace
• -w /workspace：设置工作目录为/workspace

4.3 标签说明

4.4 工具配置方法

集成工具的配置遵循其原生方式，例如：

• AWS CLI：通过aws configure命令配置Access Key、Secret Key及区域
• Terraform：通过挂载.terraformrc文件或环境变量（如TF_VAR_*）配置
• Ansible：通过挂载ansible.cfg及inventory文件实现自定义配置

4.5 注意事项

• 当前镜像为手动构建推送，版本更新需手动触发，未来计划支持自动化构建
• Terraform版本固定为1.1.9（构建时最新版），如需更高版本需重新构建镜像
• 在GitLab CI/CD中使用时，建议直接参考标签对应的CI模板进行流水线配置
• 敏感信息（如AWS密钥）建议通过环境变量或外部配置文件挂载传入，避免硬编码