Visão geral de implantações, revisões e prévias

Esta página descreve implantações e revisões, incluindo:

  • Lista de metadados armazenados para cada implantação.
  • O formato do nome da implantação e da revisão.

Implantações

O Infra Manager provisiona recursos no Google Cloud como uma implantação.

Uma implantação pode provisionar recursos do Google Cloud em vários locais e em vários projetos. Observações:

  • Os recursos específicos precisam estar disponíveis nos locais. Por exemplo, consulte Locais do Cloud Run para conferir a lista de locais em que o Cloud Run está disponível.
  • A conta de serviço precisa ter as permissões necessárias para implantar nos projetos especificados. Para mais detalhes, consulte Configurar a conta de serviço.

Metadados de implantação

O Infra Manager cria um bucket de armazenamento no projeto e local em que ele é executado. Depois que a implantação é criada, os artefatos do Infrastructure Manager ficam neste bucket de armazenamento com o nome gs://PROJECT_NUMBER-LOCATION-blueprint-config.

O Infra Manager usa o termo modelo para se referir a uma configuração do Terraform.

Onde você substitui o seguinte:

  • PROJECT_ID: o ID do projeto em que o Infra Manager é executado.
  • LOCATION: o local em que o Infra Manager é executado.

Os artefatos de implantação no bucket de armazenamento incluem:

  • Registros do Cloud Build.
  • Registros do Terraform.
  • Uma cópia da configuração do Terraform.

O Infra Manager também armazena uma cópia do arquivo de estado do Terraform. Para detalhes sobre o arquivo de estado, incluindo o acesso ao arquivo, consulte Gerenciar o arquivo de estado do Terraform.

As revisões são versões de uma implantação. Por isso, o Infra Manager armazena esses metadados de implantação para cada revisão.

Nome da implantação

O formato do nome da implantação é:

projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID

Em que:

  • PROJECT_ID é o ID do projeto em que o Infra Manager é executado.
  • LOCATION é o local em que o Infra Manager é executado. Consulte Locais do Gerenciador de infraestrutura para ver a lista de locais válidos.
  • DEPLOYMENT_ID é o identificador de implantação e é um nome especificado pelo usuário. Esse nome precisa:
    • conter apenas letras minúsculas, números ou hifens.
    • Comece com uma letra minúscula.
    • Terminar com um número ou uma letra minúscula
    • Não pode ser a string archived-deployments ou archived-previews
    • Precisa ser exclusivo no projeto e no local em que o Infra Manager é executado.

Exemplo:

projects/my-project/locations/us-central1/deployments/my-deployment

Revisões

As revisões são versões de uma implantação. Quando você cria uma implantação pela primeira vez, ela também é uma revisão e tem o ID de revisão r-0.

Nome da revisão

Quando você cria uma implantação do Infra Manager, ela recebe automaticamente o identificador de revisão r-0. Se você atualizar a implantação, o Gerenciador de infraestrutura vai criar uma nova revisão com o identificador r-1. Para cada nova revisão, o identificador aumenta em um. O identificador de revisão só pode ser definido pelo Gerenciador de infraestrutura.

Por exemplo, um nome de revisão pode ser:

projects/my-project/locations/us-central1/deployments/my-deployment/revisions/r-1

Visualizações

Uma prévia descreve as ações para acionar uma configuração específica do Terraform. Antes de criar ou atualizar uma implantação, é possível visualizar a implantação para verificar os recursos que serão provisionados.

Prévia de metadados

O Infra Manager cria um bucket de armazenamento no projeto e local em que ele é executado. Depois que a visualização é criada, os artefatos do Infra Manager ficam neste bucket de armazenamento com o nome: gs://PROJECT_NUMBER-LOCATION-blueprint-config.

Para uma prévia de uma nova implantação, os metadados são organizados com um prefixo new-previews, por exemplo: gs://PROJECT_NUMBER-LOCATION-blueprint-config/new-previews/preview-name

Também é possível conferir uma prévia da atualização de uma implantação. Para essas visualizações que segmentam uma implantação existente, os artefatos são armazenados no mesmo bucket de armazenamento que os artefatos de implantação. O bucket de armazenamento com o nome: gs://PROJECT_ID-LOCATION-blueprint-config/deployment-ID/previews/preview-ID.

O Infra Manager usa o termo blueprint para se referir a uma configuração do Terraform.

Substitua:

  • PROJECT_ID: o ID do projeto em que o Infra Manager é executado.
  • LOCATION: o local em que o Infra Manager é executado.

Os artefatos de visualização no bucket de armazenamento incluem:

  • Registros do Cloud Build.
  • Registros do Terraform.
  • Uma cópia da configuração do Terraform.

Nome do pré-lançamento

O formato do nome da visualização é:

projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID

Em que:

  • PROJECT_ID é o ID do projeto em que o Infra Manager é executado.
  • LOCATION é o local em que o Infra Manager é executado. Consulte Locais do Gerenciador de infraestrutura para ver a lista de locais válidos.
  • PREVIEW_ID é o identificador de implantação e é um nome especificado pelo usuário. Esse nome precisa:
    • conter apenas letras minúsculas, números ou hifens.
    • Comece com uma letra minúscula.
    • Terminar com um número ou uma letra minúscula
    • Não pode ser a string archived-deployments ou archived-previews
    • Precisa ser exclusivo no projeto e no local em que o Infra Manager é executado.

Exemplo:

projects/my-project/locations/us-central1/previews/my-preview

A seguir