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 SaaS e a infraestrutura que você quer implantar.

No ambiente de execução do 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 empacotadas do Terraform são imagens da Open Container Initiative (OCI) armazenadas no Artifact Registry.

Nesta página, descrevemos:

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

Nesta página, presumimos 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 do OCI usando uma configuração do Terraform, consulte Criar e fazer upload de um blueprint.

Requisitos do blueprint

O ambiente de execução do SaaS usa o Infrastructure Manager para implantar as configurações do Terraform no 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 do 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 saber 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

É possível 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 para o Artifact Registry.
  • Automatize a criação da imagem do 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 SaaS Runtime, o blueprint é armazenado no Artifact Registry no formato 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 do SaaS.

Fazer upload de um blueprint

É possível fornecer o blueprint como uma configuração do Terraform ou uma imagem OCI que empacota a configuração do Terraform.

Você faz 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 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 quando cria uma unidade.

O ambiente de execução do 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 ficam disponíveis nos 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 SaaS Runtime controla o controle de versões do blueprint ao versionar a imagem OCI com o Artifact Registry e ao usar uma versão no SaaS Runtime para apontar para uma versão específica do blueprint no Artifact Registry.

A seguir