Para trabalhar com o Infrastructure Manager (Infra Manager), você precisa ter familiaridade com o Terraform. Para saber mais sobre o Terraform, comece com O que é o Terraform?.
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 blueprint para se referir a uma configuração do Terraform.
Para saber mais sobre o Terraform com o Google Cloud, consulte Terraform no Google Cloud.
Módulos do Terraform para Google Cloud
Para um conjunto de módulos para provisionar recursos do Google Cloud , consulte Modelos e módulos do Terraform para o Google Cloud.
Também é possível criar seus próprios módulos do Terraform para Google Cloud. Para mais detalhes, consulte Como criar módulos.
Versões compatíveis do Terraform
O Infra Manager é compatível com as seguintes versões do Terraform:
- Versão 1.2.3 do Terraform
- Terraform versão 1.3.10
- 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, é possível mudar a versão do Terraform para uma versão mais recente. Não é possível mudar para uma versão anterior compatível do Terraform.
Para conferir a versão do Terraform usada para criar uma implantação ou revisão específica, consulte Ver detalhes de uma implantação e Ver detalhes de uma revisão.
Restrições em configurações do Terraform
Para usar o Infrastructure Manager e implantar uma configuração do Terraform, ela precisa ter 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.
- É necessário fornecer um módulo raiz do Terraform válido. Não é possível usar modelos ou gerar Terraform.
- A configuração precisa ser acionável por uma versão compatível do Terraform.
- Os blocos de back-end não devem ser definidos.
- Não é recomendável usar provisionadores. Use outra solução, se possível. Consulte Os provisionadores são um último recurso para mais detalhes sobre eles. 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 é rotulado como sensível na página google_storage_bucket_object da Google Cloud documentação do provedor.
Use esses rótulos como orientação ao criar configurações do Terraform ou ao revisar uma configuração existente antes de usar.
Consulte o Aviso de privacidade doGoogle Cloud para saber como o Google Cloud processa as informações pessoais coletadas ou geradas durante a prestação e administração dos Serviços do Cloud.
Usar o provedor do Terraform para Google Cloud
É possível configurar implantações e visualizações para usar provedores do Terraform mantidos pelo Infra Manager para Google Cloud.
Esse campo opcional permite especificar o uso dos provedores do Terraform mantidos pelo Infra Manager para criar ou atualizar uma implantação ou uma implantação de visualização. É possível especificar um provedor do Terraform usando CLI gcloud.
O Infra Manager é compatível com provedores do Terraform para Google Cloud:
googlegoogle-beta
Omita este campo para usar o provedor Terraform mantido pela HashiCorp para Google Cloud.
Para saber como especificar o uso de um provedor do Terraform mantido pelo Infra Manager, consulte Implantar infraestrutura usando o Infrastructure Manager, Atualizar uma implantação ou Visualizar uma implantação.
Verificar as versões compatíveis do provedor
Para verificar as versões de um provedor do Terraform para Google Cloud que
o Infra Manager oferece suporte, consulte o
manifest.json no bucket do Cloud Storage mantido pelo Infra Manager
associado à região da sua implantação no formato:
https://storage.googleapis.com/LOCATION-im-providers/hashicorp/PROVIDER_VERSION/manifest.json
Encontre uma lista completa das versões compatíveis no campo versions do arquivo manifest.json.
Por exemplo, se sua implantação estiver localizada na região africa-south1 e você estiver usando o provedor google-beta, acesse https://storage.googleapis.com/africa-south1-im-providers/hashicorp/google-beta/manifest.json para conferir as regiões disponíveis.
A seguir
- Saiba mais sobre o Infrastructure Manager.
- Crie uma implantação.
- Atualize uma implantação.
- Ver o estado de uma implantação.
- Excluir uma implantação.