Blueprints no ambiente de execução de SaaS

Para usar o ambiente de execução de SaaS, é necessário usar uma configuração do Terraform para definir o aplicativo e a infraestrutura de SaaS que você quer implantar.

No ambiente de execução de SaaS, um blueprint é o termo usado para a configuração do Terraform empacotada que define a infraestrutura e o aplicativo que você implanta. As configurações do Terraform empacotadas são imagens da Open Container Initiative (OCI, na sigla em inglês) armazenadas no Artifact Registry.

Nesta página, descrevemos:

  • Os requisitos das configurações do Terraform ao usar o ambiente de execução de SaaS.
  • Como fornecer as configurações do Terraform ao ambiente de execução de SaaS.
  • Como o ambiente de execução de SaaS usa a configuração do Terraform.

Esta página pressupõe que você já conhece o Terraform. Para saber mais sobre o Terraform, comece com O que é o Terraform?.

Para detalhes sobre como criar uma imagem OCI usando uma configuração do Terraform, consulte Criar e fazer upload de um blueprint.

Requisitos do blueprint

O ambiente de execução de SaaS usa o Infrastructure Manager para implantar as configurações do Terraform em Google Cloud. Para detalhes sobre requisitos e restrições, consulte Restrições nas configurações do Terraform.

Para usar a configuração do Terraform, o ambiente de execução de SaaS usa um pacote da configuração do Terraform. Esse pacote é uma imagem OCI (Open Container Initiative) armazenada no Artifact Registry.

Você pode fornecer uma imagem OCI que contenha a configuração do Terraform. Caso contrário, você fornece a configuração do Terraform e o ambiente de execução de SaaS cria a imagem OCI. Para detalhes sobre como fornecer a configuração do Terraform, consulte a seção a seguir Como fornecer um blueprint.

Variáveis do Terraform em blueprints

As configurações do Terraform podem usar variáveis para personalizar implantações. O ambiente de execução de SaaS oferece maneiras flexíveis de gerenciar essas variáveis. Consulte Gerenciar variáveis.

Como fornecer um blueprint

Você pode fornecer o blueprint como uma configuração do Terraform ou uma imagem OCI que empacota a configuração do Terraform.

É possível fornecer um blueprint ao ambiente de execução de SaaS das seguintes maneiras:

  • Configuração do Terraform armazenada em um repositório externo.
  • Configuração do Terraform armazenada em um arquivo zip.
  • Usando a configuração do Terraform e o Cloud Build, crie a imagem OCI e envie-a para o Artifact Registry.
  • Automatize a criação da imagem OCI usando a configuração do Terraform e o Cloud Build. Esse método automatizado é útil para pipelines de CI/CD.

Como o ambiente de execução de SaaS usa o blueprint

Ao usar o ambiente de execução de SaaS, o blueprint é armazenado no Artifact Registry com o formato do Docker. O blueprint é implantado em Google Cloud usando o Infrastructure Manager.

Para detalhes sobre o repositório no Artifact Registry, consulte Criar um repositório para o ambiente de execução de SaaS.

Fazer upload de um blueprint

Você pode fornecer o blueprint como uma configuração do Terraform ou uma imagem OCI que empacota a configuração do Terraform.

Faça o upload do blueprint para o ambiente de execução de SaaS ao criar um tipo de unidade. É possível selecionar o blueprint de uma das seguintes maneiras:

  • Faça o upload da configuração do Terraform como um arquivo zip.
  • Vincule um repositório externo.
  • Selecione uma imagem atual do Artifact Registry.

Para mais detalhes, consulte Criar um tipo de unidade.

Provisionar o blueprint

O ambiente de execução de SaaS provisiona a infraestrutura descrita no blueprint ao criar uma unidade.

O ambiente de execução de SaaS usa o Infrastructure Manager para provisionar a infraestrutura. O Infrastructure Manager usa o Cloud Build como parte do fluxo de trabalho. Quando o ambiente de execução de SaaS cria uma unidade, as informações sobre o status da implantação estão disponíveis em todos os três serviços:

  • Ambiente de execução de SaaS
  • Infrastructure Manager
  • Cloud Build

Para mais detalhes sobre como o Infrastructure Manager implanta configurações do Terraform, consulte Visão geral do Infrastructure Manager

Controlar o controle de versões

O ambiente de execução de SaaS controla o controle de versões do blueprint ao versionar a imagem OCI com o Artifact Registry e usando uma versão no ambiente de execução de SaaS para apontar para uma versão específica do blueprint no Artifact Registry.

A seguir