El proveedor oficial de Terraform para HCP Terraform y Terraform Enterprise.
Como Terraform Enterprise es una distribución autohospedada de HCP Terraform, este proveedor admite casos de uso tanto en la nube como en la empresa. En toda o la mayor parte de la documentación, la plataforma siempre se indicará como 'Terraform Enterprise', pero se indicará explícitamente que una característica solo es compatible con una u otra, si corresponde (poco común).
Tenga en cuenta que este proveedor está en versión beta y está sujeto a cambios (aunque generalmente es bastante estable). Indicaremos cualquier cambio importante mediante el lanzamiento de nuevas versiones. Hasta el lanzamiento de la versión 1.0, cualquier cambio menor en la versión indicará posibles cambios importantes. Los cambios en la versión del parche se utilizarán tanto para correcciones de errores como para cambios importantes.
Declare el proveedor en su configuración y terraform init
buscará e instalará automáticamente el proveedor desde el Registro de Terraform:
terraform {
required_providers {
tfe = {
version = " ~> 0.60.1 "
}
}
}
Para uso en producción, debe restringir las versiones de proveedor aceptables a través de la configuración (como se indicó anteriormente), para garantizar que terraform init
no instale automáticamente nuevas versiones con cambios importantes en el futuro. Como este proveedor todavía está en la versión cero, debe restringir las versiones de proveedor aceptables en la versión secundaria.
El fragmento anterior que utiliza required_providers
es para Terraform 0.13+; Si está utilizando Terraform versión 0.12, puede restringir agregando la restricción de versión al bloque provider
:
provider "tfe" {
version = " ~> 0.60.1 "
...
}
Desde v0.24.0, este proveedor requiere Terraform >= 0.12
Para obtener más información sobre la instalación del proveedor y la restricción de versiones del proveedor, consulte la documentación de Requisitos del proveedor.
Cree un token API de usuario o equipo en HCP Terraform o Terraform Enterprise y use el token en el bloque de configuración del proveedor:
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" {
# ...
}
Hay varias otras formas de configurar el token de autenticación, según su caso de uso. Para otros métodos, consulte la documentación de autenticación.
Para obtener más información sobre la configuración de proveedores en general, consulte la documentación de Configuración de proveedores.
Hemos desarrollado algunas pautas para ayudarlo a aprender más sobre cómo compilar el proveedor, usarlo localmente y contribuir con los cambios sugeridos en la guía de contribución.