Terraform Provider包复用可行性及配置方案问询

问题背景 #

我有两个Terraform项目A和B，二者可能存在共用的Provider。当前每个项目的Provider二进制文件都存储在项目本地的.terraform/providers/目录，Terraform会按版本管理这些文件，比如http Provider同时有3.0.0和3.1.0版本，目录结构如下：

${path.module} ==> tree .terraform/providers/
.terraform/providers/
└── registry.terraform.io
    └── hashicorp
        ├── http
        │   ├── 3.0.0
        │   │   └── darwin_arm64
        │   │       └── terraform-provider-http_v3.0.0_x5
        │   └── 3.1.0
        │       └── darwin_arm64
        │           └── terraform-provider-http_v3.1.0_x5
        └── null
            └── 3.1.1
                ├── darwin_amd64
                │   └── terraform-provider-null_v3.1.1_x5
                └── darwin_arm64
                    └── terraform-provider-null_v3.1.1_x5

11 directories, 4 files

我希望能配置Terraform，让所有项目下载的Provider二进制文件都存储在一个公共位置，就像Maven的本地仓库~/.m2那样，核心目的是避免重复文件占用不必要的磁盘空间。

我不确定这个复用方案是否可行，如果不可行，希望了解背后的设计策略。

注：远程模块需保持原有路径${path.module}/.terraform/modules/不变，当前模块目录结构如下：

${path.module} ==> tree .terraform/modules/
.terraform/modules/
├── modules.json
└── vpc
    ├── CHANGELOG.md
    ├── LICENSE
    ├── README.md
    ├── UPGRADE-3.0.md
    ├── ......

解答 #

这个方案完全可行，Terraform本身就支持配置全局的Provider缓存目录，具体配置方式如下：

1. 配置全局Provider缓存 #

你有两种方式配置公共缓存目录：

• 通过环境变量临时/永久生效

  # Linux/macOS 终端临时生效
  export TF_PLUGIN_CACHE_DIR="$HOME/.terraform.d/plugin-cache"
  
  # 永久生效可添加到shell配置文件（比如~/.bashrc或~/.zshrc）
  echo 'export TF_PLUGIN_CACHE_DIR="$HOME/.terraform.d/plugin-cache"' >> ~/.zshrc
  

• 通过全局配置文件生效
  在Linux/macOS的~/.terraformrc或Windows的%APPDATA%\terraform.rc文件中添加以下内容：

  plugin_cache_dir = "$HOME/.terraform.d/plugin-cache"
  

配置完成后，所有Terraform项目在下载Provider时，会先检查这个公共缓存目录，若已存在对应版本、对应架构的Provider二进制文件，会直接复用，不会重复下载到项目本地的.terraform/providers/目录。

2. 验证缓存生效 #

执行terraform init后，日志会提示使用了缓存目录，示例如下：

Initializing provider plugins...
- Reusing previous version of hashicorp/http from the dependency lock file
- Using cached hashicorp/http v3.1.0 from $HOME/.terraform.d/plugin-cache

此时项目本地的.terraform/providers/目录只会保留指向公共缓存文件的软链接（Linux/macOS）或引用（Windows），不会存储完整二进制文件，从而节省磁盘空间。

3. 关于“不可行”的误解说明 #

若有人认为该方案不可行，大概率是混淆了Provider缓存和模块存储的区别：

• Provider缓存是全局可复用的：Provider二进制文件的版本、架构是唯一标识，不同项目使用同一版本同一架构的Provider完全可以复用，不存在冲突风险。
• 远程模块需保留在项目本地：模块属于代码依赖，不同项目可能对同一模块有不同版本需求或本地修改，Terraform默认将模块存储在项目本地，避免全局复用带来的版本冲突，但这和Provider缓存逻辑不冲突。

注意事项 #

• 清理公共缓存目录时需谨慎，确保没有正在运行的项目依赖该目录中的Provider版本。
• 若需为特定项目禁用缓存，可执行terraform init -plugin-dir=<项目专属Provider目录>，或临时取消TF_PLUGIN_CACHE_DIR环境变量。

内容的提问来源于stack exchange，提问作者Ashish Kumar