Para trabalhar com o Infrastructure Manager (Infra Manager), você precisa conhecer o Terraform. Para saber mais sobre o Terraform, confira o artigo O que é o Terraform? (em inglês) do HashiCorp.
O Infra Manager implanta recursos e configurações de infraestrutura definidos em uma configuração do Terraform. Essas configurações podem consistir em vários arquivos e diretórios, mas o ponto de entrada precisa ser um módulo raiz do Terraform.
O Infra Manager usa o termo modelo para se referir a uma configuração do Terraform.
Para saber mais sobre o Terraform com Google Cloud, consulte Terraform no Google Cloud.
Módulos do Terraform para Google Cloud
Para um conjunto de módulos para provisionar Google Cloud recursos, consulte Modelos e módulos do Terraform para o Google Cloud.
Você também pode criar seus próprios módulos do Terraform para Google Cloud. Para mais detalhes, consulte Como criar módulos.
Versões do Terraform com suporte
O Infra Manager é compatível com as seguintes versões do Terraform:
- Versão 1.2.3 do Terraform
- Versão 1.3.10 do Terraform
- Versão 1.4.7 do Terraform
- Versão 1.5.7 do Terraform
Use a flag --tf-version-constraint para especificar a versão do Terraform que o Infra Manager usa para criar uma implantação.
Se você não especificar uma versão do Terraform, a versão de suporte mais recente será usada por padrão.
Ao atualizar uma implantação, você pode mudar a versão do Terraform para uma versão mais recente. Não é possível mudar para uma versão anterior com suporte do Terraform.
Para conferir a versão do Terraform usada para criar uma implantação ou revisão específica, consulte Conferir os detalhes de uma implantação e Conferir os detalhes de uma revisão.
Restrições nas configurações do Terraform
Para usar o Infrastructure Manager para implantar uma configuração do Terraform, a configuração tem as seguintes restrições.
- Não inclua informações pessoais ou sensíveis nos valores de configuração do Terraform. Para mais informações, consulte a seção Valores de configuração do Terraform e dados sensíveis.
- Um módulo raiz do Terraform válido precisa ser fornecido. Não é possível criar modelos ou gerar o Terraform.
- A configuração precisa ser ativado por uma versão com suporte do Terraform.
- Os blocos de back-end não precisam ser definidos.
- O uso de provisioners não é recomendado. Use outra solução, se possível. Consulte Provisionadores são um último recurso para mais detalhes. Se você estiver usando provisionadores, observe que o ambiente de execução do Infra Manager pode mudar a qualquer momento.
Valores de configuração do Terraform e dados sensíveis
Não inclua informações pessoais ou sensíveis nos valores de configuração do Terraform.
A documentação do Google Cloud provider indica valores de configuração que podem incluir informações sensíveis.
Por exemplo, o recurso google_storage_bucket_object permite
a criação de um objeto do Cloud Storage usando o argumento content. Esse
argumento é marcado como sensível na
página google_storage_bucket_object da documentação do provedor Google Cloud .
Você pode usar esses rótulos para ajudar a criar configurações do Terraform ou revisar uma configuração existente antes do uso.
Consulte o Aviso de privacidade doGoogle Cloud para saber como o Google Cloud processa as informações pessoais que ele coleta ou gera durante a provisão e administração dos Serviços do Cloud.
A seguir
- Saiba mais sobre o Infrastructure Manager.
- Crie uma implantação.
- Atualizar uma implantação.
- Conferir o estado de uma implantação.
- Excluir uma implantação.