O HashiCorp Terraform é uma ferramenta de infraestrutura como código (IaC, na sigla em inglês) que permite provisionar e gerenciar a infraestrutura em nuvem. O Terraform fornece plug-ins chamados provedores, que permitem interagir com provedores de nuvem e outras APIs. É possível usar o provedor Terraform para Google Cloud para provisionar e gerenciar recursos do Google Cloud, incluindo o Cloud Build.
Como o Terraform funciona
O Terraform tem uma sintaxe declarativa e orientada por configuração, que pode ser usada para descrever a infraestrutura que você quer provisionar no seu projeto do Google Cloud. Depois de criar essa configuração em um ou mais arquivos de configuração do Terraform, é possível usar a CLI do Terraform para aplicá-la aos recursos do Cloud Build.
As etapas a seguir explicam como o Terraform funciona:
- Você descreve a infraestrutura que quer provisionar em um arquivo de configuração do Terraform. Você não precisa escrever código descrevendo como provisionar a infraestrutura. O Terraform provisiona a infraestrutura para você.
- Você executa o comando
terraform plan
, que avalia sua configuração e gera um plano de execução. É possível analisar o plano e fazer alterações conforme necessário. - Você executa o comando
terraform apply
, que realiza as seguintes ações:- Ele provisiona sua infraestrutura com base no plano de execução invocando as APIs do Cloud Build correspondentes em segundo plano.
- Ele cria um arquivo de estado do Terraform, que é um arquivo JSON que mapeia os recursos no seu arquivo de configuração para os recursos da infraestrutura do mundo real. O Terraform usa esse arquivo para manter um registro do estado mais recente da infraestrutura e para determinar quando criar, atualizar e destruir recursos.
- Quando você executa
terraform apply
, o Terraform usa o mapeamento no arquivo de estado para comparar a infraestrutura atual com o código e fazer atualizações conforme necessário: - Se um objeto de recurso for definido no arquivo de configuração, mas não existir no arquivo de estado, o Terraform o criará.
- Se um objeto de recurso existir no arquivo de estado, mas tiver uma configuração diferente do arquivo de configuração, o Terraform atualizará o recurso para corresponder ao arquivo de configuração.
- Se um objeto de recurso no arquivo de estado corresponder ao arquivo de configuração, o Terraform não vai mudar o recurso.
Guias baseados no Terraform para o Cloud Build
A tabela a seguir lista todos os guias de instruções e tutoriais baseados no Terraform para o Cloud Build:
Guia Detalhes Conectar-se a um repositório do GitHub Neste guia, explicamos como conectar um repositório do GitHub ao Cloud Build usando o Terraform. Fazer a implantação no Compute Engine Neste guia, explicamos como realizar implantações azul-verde sem inatividade nos grupos de instâncias gerenciadas (MIGs, na sigla em inglês) do Compute Engine usando o Cloud Build e o Terraform. Módulos e blueprints do Terraform para o Cloud Build
Os módulos e blueprints ajudam a automatizar o provisionamento e o gerenciamento de recursos do Google Cloud em grande escala. Um módulo é um conjunto reutilizável de arquivos de configuração do Terraform que cria uma abstração lógica dos recursos do Terraform. Um blueprint é um pacote de módulos implantáveis e reutilizáveis e uma política que implementa e documenta uma solução específica.
A tabela a seguir lista todos os módulos e blueprints relacionados ao Cloud Build:
Módulo ou projeto Detalhes Pipeline de CI/CD seguro Esse módulo permite que os clientes do Google Cloud implantem rapidamente um pipeline de CI/CD seguro, implementando muitas das funções descritas em Como mudar para a segurança. terraform-google-bootstrap
Este módulo ajuda a inicializar uma organização do Google Cloud, criando todos os recursos e permissões necessários para começar a usar o Cloud Foundation Toolkit (CFT). Para usuários que querem usar o Cloud Build e o Cloud Source Repositories para códigos básicos, este módulo contém um submódulo que inicializa todos os recursos necessários. Recursos do Terraform para o Cloud Build
Recursos são os elementos fundamentais da linguagem do Terraform. Cada bloco de recursos descreve um ou mais objetos de infraestrutura, como redes virtuais ou instâncias de computação.
A tabela a seguir lista os recursos do Terraform disponíveis para o Cloud Build:
Serviço do Cloud Build Recursos do Terraform Fontes de dados Cloud Build v1 google_cloudbuild_trigger
Cloud Build v2 google_cloudbuildv2_connection_iam_policy
A seguir