a5grid/azure_iac_toolkit

Azure 基础设施即代码工具包

镜像概述和主要用途

综合Docker镜像，包含用于Azure基础设施自动化和管理的必备工具，适用于Azure资源的IaC开发、部署和管理场景，提供一站式的Azure工具链支持。

核心功能和特性

包含工具

• Terraform：用于定义和部署云基础设施的IaC工具
• Packer：用于创建机器镜像的工具
• PowerShell：跨平台任务自动化和配置管理框架
• Azure CLI：用于管理Azure资源的命令行工具
• Python：通用编程语言，支持Azure SDK和自动化脚本开发
• Docker CLI：用于容器管理的命令行工具

PowerShell模块

• Az Module：官方Azure PowerShell模块，用于管理Azure资源
• PnP.PowerShell：用于管理Microsoft 365和SharePoint Online的模块
• GuestConfiguration：用于Azure虚拟机 guest 配置管理的模块

关键特性

• 基于Ubuntu构建，提供稳定的Linux运行环境
• 非root用户设置（AzDevOps），增强安全性
• 内置Docker CLI，支持容器化工作流集成
• 定期健康检查，确保工具可用性
• 全面的Azure工具集，满足各类自动化需求
• 包含Python环境及pip包管理器，支持自定义脚本开发

使用场景和适用范围

• Azure基础设施的自动化部署和管理
• 使用Terraform定义和管理Azure资源
• 通过Packer创建和定制Azure虚拟机镜像
• 利用PowerShell和Azure CLI执行Azure资源操作
• 开发和测试Azure IaC脚本
• CI/CD流水线中的Azure资源部署步骤
• Azure环境的日常管理和维护任务

使用方法和配置说明

基础使用

通过以下命令运行镜像并进入交互式终端：

bash
docker run -it --rm docker.xuanyuan.run/azure-iac-toolkit:latest

挂载工作目录

为了持久化工作文件，可将本地目录挂载到容器中：

bash
docker run -it --rm -v $(pwd):/workspace -w /workspace docker.xuanyuan.run/azure-iac-toolkit:latest

配置Azure认证

可通过环境变量传递Azure凭据以进行认证：

bash
docker run -it --rm \
  -e AZURE_CLIENT_ID=your_client_id \
  -e AZURE_CLIENT_SECRET=your_client_secret \
  -e AZURE_TENANT_ID=your_tenant_id \
  docker.xuanyuan.run/azure-iac-toolkit:latest

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  azure-iac:
    image: docker.xuanyuan.run/azure-iac-toolkit:latest
    volumes:
      - ./iac-scripts:/workspace
    environment:
      - AZURE_CLIENT_ID=your_client_id
      - AZURE_CLIENT_SECRET=your_client_secret
      - AZURE_TENANT_ID=your_tenant_id
    working_dir: /workspace
    tty: true

启动服务：

bash
docker-compose up -d
docker-compose exec azure-iac bash

验证工具版本

进入容器后，可验证工具是否正常安装：

bash
terraform --version
az --version
packer --version
pwsh -v
python --version