自定义Terraform Provider开发：如何跳过版本与包检查？

问题背景 #

开发自定义Terraform Provider，已配置development overrides，但执行terraform init时仍尝试查询远程Provider包，报错如下：

Error: Failed to query available provider packages
Could not retrieve the list of available versions for provider test1.abc.com/local/webvm: no available releases match the given constraints 0.0.1

Error: Failed to query available provider packages
Could not retrieve the list of available versions of provider hashicorp/webvm: no available releases match the given constraints

当前development overrides配置：

provider_installation {
   dev_overrides {
       "abc.com/local/webvm" = "C:/Users/xyz/AppData/Roaming/terraform.d/plugins/abc.com/local/webvm/0.0.1/windows_amd64"
   }
}

Terraform定义：

terraform {
   required_providers {
     test_provider1 = {
         source = "abc.com/local/webvm"
         version = "0.0.1"
     }
   }
}

1. 开发阶段是否可跳过该检查？ #

可以，但必须保证dev_overrides配置与required_providers中的source字段完全匹配。从你的报错和配置来看，当前匹配存在问题：

• 报错中出现了test1.abc.com/local/webvm，但你的dev_overrides仅配置了abc.com/local/webvm，缺少test1前缀，导致匹配失败
• 另一个报错hashicorp/webvm，说明Terraform尝试从官方仓库查找该Provider，可能是你在资源/Provider块中未正确关联自定义Provider的别名或source

正确配置匹配后，Terraform会自动跳过该Provider的远程包查询，直接使用本地路径的版本。另外也可以用临时命令跳过所有插件获取：

terraform init -get-plugins=false

但该命令会跳过所有插件的远程查询，仅适合本地已具备全部依赖的场景，不推荐作为开发阶段的常规方式。

2. 是否需要将Provider部署至Web服务器？ #

开发阶段完全不需要。通过development overrides直接指向本地编译好的Provider二进制文件路径即可，无需部署到远程服务器。只有当需要向团队其他成员分发、或正式发布Provider时，才需要部署到私有仓库或公开Registry。

3. terraform init默认会在HashiCorp查找Provider吗？若仅在公司内部使用，如何禁用该默认行为或更换仓库？ #

是的，Terraform默认优先从HashiCorp官方Registry查询Provider。如果仅在公司内部使用，可通过以下两种方式处理：

• 配置私有Registry：在terraform块中指定公司内部的Registry地址，示例：

terraform {
  required_providers {
    webvm = {
      source = "abc.com/local/webvm"
      version = "0.0.1"
    }
  }
  registry {
    private = true
    hostname = "your-company-registry.example.com"
  }
}

• 禁用远程查询，仅使用本地源：通过provider_installation配置指定本地文件系统镜像，禁用其他远程源，示例：

provider_installation {
  filesystem_mirror {
    path    = "C:/Users/xyz/AppData/Roaming/terraform.d/plugins"
    include = ["abc.com/local/*"]
  }
  direct {
    exclude = ["*"]
  }
}

额外修正建议（针对当前配置问题） #

从报错来看，你需要检查以下两点：

1. 确保required_providers中的source与dev_overrides的键完全一致，比如如果实际source是test1.abc.com/local/webvm，则dev_overrides需改为：

dev_overrides {
    "test1.abc.com/local/webvm" = "C:/Users/xyz/AppData/Roaming/terraform.d/plugins/abc.com/local/webvm/0.0.1/windows_amd64"
}

2. 确保Provider块与required_providers的别名对应，比如如果你的Provider名称是webvm，则required_providers应改为：

terraform {
  required_providers {
    webvm = {
      source = "abc.com/local/webvm"
      version = "0.0.1"
    }
  }
}

避免因别名不匹配导致Terraform默认尝试从官方仓库查找hashicorp/webvm。

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