HCP Terraform 和 Terraform Enterprise 的官方 Terraform 提供商。
由于 Terraform Enterprise 是 HCP Terraform 的自托管发行版,因此该提供商支持云和企业用例。在所有/大多数文档中,该平台将始终被表述为“Terraform Enterprise” - 但一项功能将明确指出仅在其中一个或另一个中受支持(如果适用)(罕见)。
请注意,该提供程序处于测试阶段,可能会发生变化(尽管它通常相当稳定)。我们将通过发布新版本来表明任何重大更改。在 v1.0 发布之前,任何较小的版本更改都将表明可能的重大更改。补丁版本更改将用于错误修复和非重大更改。
在您的配置中声明提供程序, terraform init
将自动从 Terraform 注册表中为您获取并安装提供程序:
terraform {
required_providers {
tfe = {
version = " ~> 0.60.1 "
}
}
}
对于生产使用,您应该通过配置限制可接受的提供程序版本(如上所述),以确保terraform init
将来不会自动安装具有重大更改的新版本。由于此提供程序仍处于版本零,因此您应该将可接受的提供程序版本限制在次要版本上。
上面使用required_providers
的代码片段适用于 Terraform 0.13+;如果您使用 Terraform 版本 0.12,则可以通过将版本约束添加到provider
程序块来进行约束:
provider "tfe" {
version = " ~> 0.60.1 "
...
}
自 v0.24.0 起,此提供程序需要 Terraform >= 0.12
有关提供程序安装和限制提供程序版本的更多信息,请参阅提供程序要求文档。
在 HCP Terraform 或 Terraform Enterprise 中创建用户或团队 API 令牌,并在提供程序配置块中使用该令牌:
provider "tfe" {
hostname = var . hostname # Optional, for use with Terraform Enterprise. Defaults to app.terraform.io.
token = var . token
}
# Create an organization
resource "tfe_organization" "org" {
# ...
}
根据您的使用场景,还有多种其他方法可以配置身份验证令牌。其他方法请参见认证文档
有关一般配置提供程序的更多信息,请参阅提供程序配置文档。
我们制定了一些指南来帮助您了解有关编译提供程序、在本地使用它以及在贡献指南中提出建议的更改的更多信息。