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
によって自動的にインストールされないようにする必要があります。このプロバイダーはまだバージョン 0 であるため、許容可能なプロバイダーのバージョンをマイナー バージョンに制限する必要があります。
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" {
# ...
}
ユースケースに応じて、認証トークンを構成するには他にもいくつかの方法があります。他の方法については、認証のドキュメントを参照してください。
プロバイダーの構成全般の詳細については、プロバイダー構成ドキュメントを参照してください。
プロバイダーのコンパイル、ローカルでの使用、およびコントリビューション ガイドでの提案された変更のコントリビューションについて詳しく学ぶために、いくつかのガイドラインを作成しました。