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" {
# ...
}
根據您的使用場景,還有多種其他方法可以配置身份驗證令牌。其他方法請參閱認證文檔
有關一般配置提供者的更多信息,請參閱提供程序配置文件。
我們制定了一些指南來幫助您了解有關編譯提供者、在本地使用它以及在貢獻指南中提出建議的更改的更多資訊。