GitLab Terraform Registry无法通过PAT下载嵌套目录模块

1. 正确配置模块源路径 #

你的目录结构是stack仓库根目录下直接包含vpc、db、dns子模块目录，引用子模块时，只需在GitLab模块源后添加//子模块目录名指定子路径，同时用标准的version参数绑定版本（对应Git仓库的标签），不需要在source里加?ref=xxx：

module "my_vpc" {
  source  = "gitlab.com/xfinity/stack//vpc"
  version = "1.0.0"
}

module "my_db" {
  source  = "gitlab.com/xfinity/stack//db"
  version = "1.0.0"
}

2. 配置PAT自动认证 #

在本地Terraform配置文件（Linux/macOS为~/.terraformrc，Windows为%APPDATA%\terraform.rc）中添加GitLab凭证配置，Terraform拉取模块时会自动用该PAT通过HTTPS完成认证，无需手动编写带凭证的URL或使用SSH：

credentials "gitlab.com" {
  token = "你的个人访问令牌（PAT）"
}

注意：你的PAT需要拥有read_repository权限，确保能读取GitLab上的模块仓库。

3. 绑定版本标签 #

version = "1.0.0"对应GitLab仓库中已推送的标签，需先在本地仓库打标签并推送到远端：

git tag 1.0.0
git push origin 1.0.0

关键说明 #

• Terraform的GitLab模块源简写（gitlab.com/组名/仓库名//子路径）底层自动使用HTTPS协议，配合credentials配置即可用PAT完成认证，完全避开手动写HTTPS完整URL或SSH的限制。
• 不要在source中混用?ref=xxx参数，Terraform模块源的版本管理优先使用version参数，推荐用Git标签做版本标识。

内容的提问来源于stack exchange，提问作者Abhi.G