swcc/terraform-makefile

Terraform用户的Makefile

![构建状态]([***]

本仓库提供一个Makefile，为Terraform提供简单的操作接口，旨在简化Terraform命令行操作流程，提升团队协作效率。

核心功能与特性

• 简化CLI操作：提供统一接口，减少Terraform命令的重复输入
• DRY原则实践：避免重复编写复杂的Terraform命令
• 新手友好：降低Terraform学习门槛，便于团队新成员快速上手
• 文档化用法：内置常见操作文档，统一团队操作规范
• 多方式凭证管理：支持多种云提供商（AWS、Azure、DigitalOcean、Google、Hetzner、Scaleway）的凭证管理：
  • 环境变量传递：如<PROVIDER>_<ENV>_SECRET映射为对应提供商的凭证变量
  • 本地密钥管理器：通过pass管理本地凭证
  • 分布式密钥管理：通过vault获取远程凭证（目前仅支持AWS）

使用场景与适用范围

适用于需要管理多个云提供商和环境的Terraform用户，特别适合：

• 多环境（开发、测试、生产）基础设施管理
• 多云架构（混合使用AWS、Azure等多个云平台）
• 团队协作场景，需要标准化Terraform操作流程
• 希望简化Terraform命令行操作的个人用户

安装方法

包安装

（目前包仅在https://github.com/paulRbr/terraform-makefile/releases%E5%8F%91%E5%B8%83%EF%BC%89

bash
wget https://github.com/paulRbr/terraform-makefile/releases/download/<version>/tf-make_<version>_amd64.deb
dpkg -i tf-make_<version>.deb

手动安装

将核心文件下载到指定目录：

bash
mkdir -p /opt/terraform
cd /opt/terraform
wget -N https://raw.githubusercontent.com/paulRbr/terraform-makefile/master/{Makefile,terraform.sh}

将tf-make脚本添加到系统PATH（需修改脚本中的Makefile路径）。

目录结构约定

Makefile要求Terraform配置文件遵循以下目录结构：

providers/<provider>/<env>/*.tf

示例目录结构：

providers/
├── aws
│   ├── prod
│   │   └── config.tf
│   └── test
│       └── config.tf
├── do
│   └── prod
│       └── config.tf
├── google
│   ├── prod
│   │   └── config.tf
│   └── test
│       └── config.tf
├── hetzner,scaleway
│   └── test
│       └── config.tf
├── hetzner
│   └── prod
│       └── config.tf
└── scaleway
    └── prod
        └── config.tf

注意：多云环境中，provider名称可使用逗号分隔的多个提供商组合，如hetzner,scaleway。

可用命令

执行make可查看所有可用命令：

bash
> make
Terraform-makefile v0.14.7

console                        控制台查看基础设施资源
destroy                        销毁资源
dry-run                        预览资源变更（dry run）
fmt                            将配置重写为规范格式
import                         导入基础设施资源
install                        安装Terraform及依赖
lint                           检查HCL代码
raw                            发送原始命令给Terraform
refresh                        刷新基础设施资源
run                            执行资源变更
show                           列出基础设施资源
state                          检查或更改资源的远程状态
taint                          标记资源为tainted
validate                       基本语法检查
workspace                      管理工作区

配置变量