terraform provider tfe
v0.60.1
Le fournisseur Terraform officiel pour HCP Terraform et Terraform Enterprise.
Comme Terraform Enterprise est une distribution auto-hébergée de HCP Terraform, ce fournisseur prend en charge les cas d'utilisation Cloud et Enterprise. Dans toute/la plupart des documentations, la plate-forme sera toujours indiquée comme « Terraform Enterprise » - mais une fonctionnalité sera explicitement notée comme étant uniquement prise en charge dans l'un ou l'autre, le cas échéant (rare).
Notez que ce fournisseur est en version bêta et est susceptible de changer (bien qu'il soit généralement assez stable). Nous indiquerons toute modification importante en publiant de nouvelles versions. Jusqu'à la sortie de la version 1.0, toute modification mineure de la version indiquera d'éventuelles modifications majeures. Les modifications de version du correctif seront utilisées à la fois pour les corrections de bugs et les modifications ininterrompues.
Déclarez le fournisseur dans votre configuration et terraform init récupérera et installera automatiquement le fournisseur pour vous à partir du registre Terraform :
terraform {
required_providers {
tfe = {
version = " ~> 0.60.1 "
}
}
} Pour une utilisation en production, vous devez limiter les versions de fournisseur acceptables via la configuration (comme ci-dessus), pour vous assurer que les nouvelles versions avec des modifications importantes ne seront pas automatiquement installées par terraform init à l'avenir. Comme ce fournisseur est toujours à la version zéro, vous devez limiter les versions acceptables du fournisseur sur la version mineure.
L'extrait ci-dessus utilisant required_providers est pour Terraform 0.13+ ; si vous utilisez Terraform version 0.12, vous pouvez contraindre en ajoutant plutôt la contrainte de version au bloc provider :
provider "tfe" {
version = " ~> 0.60.1 "
...
}Depuis la v0.24.0, ce fournisseur nécessite Terraform >= 0.12
Pour plus d’informations sur l’installation du fournisseur et les versions contraignantes du fournisseur, consultez la documentation Exigences du fournisseur.
Créez un jeton API d'utilisateur ou d'équipe dans HCP Terraform ou Terraform Enterprise et utilisez le jeton dans le bloc de configuration du fournisseur :
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" {
# ...
}Il existe plusieurs autres façons de configurer le jeton d'authentification, en fonction de votre cas d'utilisation. Pour d'autres méthodes, consultez la documentation d'authentification
Pour plus d’informations sur la configuration des fournisseurs en général, consultez la documentation Configuration du fournisseur.
Nous avons développé quelques lignes directrices pour vous aider à en savoir plus sur la compilation du fournisseur, son utilisation locale et la contribution aux modifications suggérées dans le guide de contribution.
