stagex/tofu

OpenTofu 镜像文档

镜像概述和主要用途

OpenTofu 是一个开源的基础设施即代码（IaC）工具，旨在以声明式方式管理云基础设施。通过定义配置文件描述基础设施的期望状态，OpenTofu 能够自动协调实际状态与期望状态，实现基础设施的自动化部署、更新和维护，支持主流云服务提供商，帮助团队高效管理复杂的云环境。

核心功能和特性

• 声明式配置：使用 HashiCorp 配置语言（HCL）定义基础设施，专注于"应该是什么"而非"如何做"
• 多云支持：兼容 AWS、Azure、Google Cloud 等主流云服务提供商，实现跨云资源统一管理
• 状态管理：通过状态文件（state file）跟踪基础设施当前状态，确保配置与实际环境一致
• 自动化操作：自动执行资源的创建、更新和删除，减少手动操作和人为错误
• 版本控制集成：支持与 Git 等版本控制系统协作，便于配置文件的版本管理和团队协作

使用场景和适用范围

• 云基础设施的自动化部署与管理
• 多云或混合云环境的统一资源管理
• 开发、测试、生产环境的一致性保障
• 基础设施配置的版本化和审计跟踪
• 快速复制或重建复杂的基础设施环境

使用方法和配置说明

基本使用（Docker Run）

通过 Docker 运行 OpenTofu 容器，挂载本地配置文件目录以执行相关操作：

bash
docker run -v $(pwd):/workspace -w /workspace docker.xuanyuan.run/opentofu/opentofu:latest init
docker run -v $(pwd):/workspace -w /workspace docker.xuanyuan.run/opentofu/opentofu:latest plan
docker run -v $(pwd):/workspace -w /workspace docker.xuanyuan.run/opentofu/opentofu:latest apply

• -v $(pwd):/workspace：将当前目录挂载到容器内的 /workspace 目录，用于访问配置文件
• -w /workspace：设置工作目录为 /workspace
• init：初始化工作目录，下载 providers 和模块
• plan：生成执行计划，预览将要进行的基础设施变更
• apply：应用执行计划，创建或更新基础设施

环境变量配置

可通过环境变量配置 OpenTofu 行为：

• TOFU_WORKSPACE：指定工作区名称（默认为 "default"）
• TOFU_CONFIG_DIR：指定配置文件目录（默认为当前工作目录）
• TOFU_LOG：设置日志级别（如 "TRACE"、"DEBUG"、"INFO" 等）

Docker Compose 示例

创建 docker-compose.yml 文件简化多命令执行：

yaml
version: '3'
services:
  opentofu:
    image: docker.xuanyuan.run/opentofu/opentofu:latest
    volumes:
      - ./:/workspace
    working_dir: /workspace
    environment:
      - TOFU_WORKSPACE=production

使用方式：

bash
docker-compose run --rm opentofu init
docker-compose run --rm opentofu plan
docker-compose run --rm opentofu apply