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 que provisionam recursos do Google Cloud , 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 compatíveis do Terraform
O Infra Manager é compatível com as seguintes versões do Terraform:
| Versão do Terraform | Data de lançamento | Data da suspensão do uso | Data de término do suporte | Migrar automaticamente para a versão |
|---|---|---|---|---|
1.2.3 |
21/08/2023 | 08/01/2026 | 08/02/2026 | 1.5.7 |
1.3.10 |
14/03/2024 | A definir | TBD | A definir |
1.4.7 |
14/03/2024 | A definir | TBD | A definir |
1.5.7 |
14/03/2024 | A definir | TBD | TBD |
Use a flag --tf-version-constraint para especificar a versão do
Terraform que o Infra Manager usa para
criar uma implantação.
Antes de usar o Infrastructure Manager para implantar uma configuração do Terraform, verifique se ela tem as seguintes restrições:
Se você não especificar uma versão do Terraform, a versão mais recente compatível será usada por padrão.
Ao atualizar uma implantação, é possível fazer upgrade para uma versão mais recente do Terraform, mas não downgrade para uma versão anterior compatível. Para informações sobre a suspensão de uso da versão do Terraform, consulte a documentação da política de gerenciamento de versões 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 nas 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 sensíveis ou de identificação pessoal nos valores de configuração do Terraform. Para mais informações, consulte Valores de configuração do Terraform e dados sensíveis.
- É necessário fornecer um módulo raiz do Terraform válido. Não há suporte para modelos ou geração do Terraform.
- A configuração precisa ser acionável por uma versão compatível do Terraform.
- Os blocos de back-end não podem ser definidos.
- Não recomendamos o uso de provisionadores. Se possível, use outra solução. Para mais informações sobre essa recomendação, consulte Provisionadores são um último recurso. Se você estiver usando provisionadores, observe que o ambiente de execução do Gerenciador de infraestrutura pode mudar a qualquer momento.
Valores de configuração do Terraform e dados sensíveis
Não inclua informações sensíveis ou de identificação pessoal nos valores de configuração do Terraform.
A documentação do provedor Google Cloud 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
Se quiser, use CLI gcloud para configurar implantações e pré-visualizações para usar provedores Terraform mantidos pelo Infra Manager para Google Cloud.
O Infra Manager é compatível com provedores do Terraform para Google Cloud:
googlegoogle-beta
Omita este campo para usar o provedor do 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 Gerenciador de infraestrutura é compatível, consulte o manifest.json no
bucket do Cloud Storage mantido pelo Gerenciador de infraestrutura
associado à região da sua implantação no formato:
https://storage.googleapis.com/LOCATION-im-providers/hashicorp/PROVIDER_VERSION/manifest.json
Confira 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.
- Atualizar uma implantação.
- Conferir o estado de uma implantação.
- Excluir uma implantação.