Der offizielle Terraform-Anbieter für HCP Terraform und Terraform Enterprise.
Da Terraform Enterprise eine selbst gehostete Distribution von HCP Terraform ist, unterstützt dieser Anbieter sowohl Cloud- als auch Enterprise-Anwendungsfälle. In der gesamten/meisten Dokumentation wird die Plattform immer als „Terraform Enterprise“ angegeben – eine Funktion wird jedoch ausdrücklich als nur in der einen oder anderen unterstützt angegeben, sofern zutreffend (selten).
Beachten Sie, dass sich dieser Anbieter in der Betaphase befindet und Änderungen unterliegen kann (obwohl er im Allgemeinen recht stabil ist). Wir werden alle bahnbrechenden Änderungen durch die Veröffentlichung neuer Versionen bekannt geben. Bis zur Veröffentlichung von v1.0 weisen alle geringfügigen Versionsänderungen auf mögliche Breaking Changes hin. Patch-Versionsänderungen werden sowohl für Bugfixes als auch für nicht-unterbrechende Änderungen verwendet.
Deklarieren Sie den Anbieter in Ihrer Konfiguration und terraform init
ruft den Anbieter automatisch aus der Terraform-Registrierung ab und installiert ihn für Sie:
terraform {
required_providers {
tfe = {
version = " ~> 0.60.1 "
}
}
}
Für den Produktionseinsatz sollten Sie die akzeptablen Anbieterversionen über die Konfiguration (wie oben) einschränken, um sicherzustellen, dass neue Versionen mit Breaking Changes in Zukunft nicht automatisch von terraform init
installiert werden. Da sich dieser Anbieter noch in der Version Null befindet, sollten Sie die akzeptablen Anbieterversionen auf die Nebenversion beschränken.
Das obige Snippet mit required_providers
gilt für Terraform 0.13+; Wenn Sie Terraform Version 0.12 verwenden, können Sie eine Einschränkung vornehmen, indem Sie stattdessen die Versionseinschränkung zum provider
hinzufügen:
provider "tfe" {
version = " ~> 0.60.1 "
...
}
Seit v0.24.0 erfordert dieser Anbieter Terraform >= 0.12
Weitere Informationen zur Anbieterinstallation und zum Einschränken von Anbieterversionen finden Sie in der Dokumentation zu Anbieteranforderungen.
Erstellen Sie ein Benutzer- oder Team-API-Token in HCP Terraform oder Terraform Enterprise und verwenden Sie das Token im Anbieterkonfigurationsblock:
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" {
# ...
}
Abhängig von Ihrem Anwendungsfall gibt es mehrere andere Möglichkeiten, das Authentifizierungstoken zu konfigurieren. Weitere Methoden finden Sie in der Authentifizierungsdokumentation
Weitere Informationen zum Konfigurieren von Anbietern im Allgemeinen finden Sie in der Dokumentation zur Anbieterkonfiguration.
Wir haben einige Richtlinien entwickelt, die Ihnen dabei helfen sollen, mehr über das Kompilieren des Anbieters, seine lokale Verwendung und das Einbringen von Änderungsvorschlägen in den Beitragsleitfaden zu erfahren.