terraform provider tfe

HCP Terraform e provedor Terraform Enterprise

O provedor oficial do Terraform para HCP Terraform e Terraform Enterprise.

Como o Terraform Enterprise é uma distribuição auto-hospedada do HCP Terraform, este provedor oferece suporte a casos de uso de nuvem e corporativo. Em toda/na maior parte da documentação, a plataforma sempre será indicada como 'Terraform Enterprise' - mas um recurso será explicitamente indicado como suportado apenas em um ou outro, se aplicável (raro).

Observe que este provedor está em versão beta e sujeito a alterações (embora geralmente seja bastante estável). Indicaremos quaisquer alterações importantes lançando novas versões. Até o lançamento da v1.0, quaisquer pequenas alterações na versão indicarão possíveis alterações significativas. As alterações na versão do patch serão usadas para correções de bugs e alterações ininterruptas.

• Documentação: https://registry.terraform.io/providers/hashicorp/tfe/latest/docs
• Site : https://registry.terraform.io/providers/hashicorp/tfe / https://www.terraform.io
• Fórum de discussão : https://discuss.hashicorp.com/c/terraform-providers

Instalação

Declare o provedor em sua configuração e terraform init irá buscar e instalar automaticamente o provedor para você no Terraform Registry:

 terraform {
  required_providers {
    tfe = {
      version = " ~> 0.60.1 "
    }
  }
}

Para uso em produção, você deve restringir as versões aceitáveis ​​do provedor por meio da configuração (como acima), para garantir que novas versões com alterações significativas não sejam instaladas automaticamente pelo terraform init no futuro. Como este provedor ainda está na versão zero, você deve restringir as versões aceitáveis ​​do provedor na versão secundária.

O trecho acima usando required_providers é para Terraform 0.13+; se você estiver usando o Terraform versão 0.12, poderá restringir adicionando a restrição de versão ao bloco provider :

 provider "tfe" {
  version = " ~> 0.60.1 "
  ...
}

Desde a v0.24.0, este provedor requer Terraform >= 0,12

Para obter mais informações sobre a instalação do provedor e a restrição de versões do provedor, consulte a documentação Requisitos do Provedor.

Uso

Crie um token de API de usuário ou equipe no HCP Terraform ou Terraform Enterprise e use o token no bloco de configuração do provedor:

 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" {
  # ...
}

Existem várias outras maneiras de configurar o token de autenticação, dependendo do seu caso de uso. Para outros métodos, consulte a documentação de autenticação

Para obter mais informações sobre como configurar provedores em geral, consulte a documentação Configuração do Provedor.

Desenvolvimento

Desenvolvemos algumas diretrizes para ajudá-lo a aprender mais sobre como compilar o provedor, usá-lo localmente e contribuir com alterações sugeridas no guia de contribuição.