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

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

  • 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 Google Cloud para vários locais e vários projetos. Algumas considerações:

  • Os recursos específicos precisam estar disponíveis nos locais. Por exemplo, consulte Locais do Cloud Run para ver 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 fazer a implantação 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 no local em que ele é executado. Depois que a implantação é criada, os artefatos do Infrastructure Manager ficam neste bucket de armazenamento, que tem o nome: gs://PROJECT_NUMBER-LOCATION-blueprint-config.

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 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 a ele, consulte Gerenciar o arquivo de estado do Terraform.

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

ID de implantação

O ID da implantação é o identificador especificado pelo usuário para um recurso de implantação. Use o ID da implantação para se referir a uma implantação usando o formato:

projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID

Substitua:

  • PROJECT_ID é o ID do projeto em que o Infra Manager é executado.
  • LOCATION é o local em que o Infra Manager é executado. Consulte Locais do Infrastructure Manager para conferir a lista de locais válidos.
  • DEPLOYMENT_ID é o ID da implantação, que é um nome especificado pelo usuário. Esse ID precisa:
    • conter apenas letras minúsculas, números ou hífens.
    • 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, ela também é uma revisão e tem o ID 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 Infrastructure Manager 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 Infrastructure Manager.

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 ativar 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.

Visualizar metadados

O Infra Manager cria um bucket de armazenamento no projeto e no local em que ele é executado. Depois que a prévia é criada, os artefatos do Infra Manager ficam neste bucket de armazenamento, que tem 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 visualizar uma atualização de uma implantação atual. Para essas prévias destinadas a uma implantação atual, os artefatos são armazenados no mesmo bucket 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 Infrastructure 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 prévia é:

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 Infrastructure Manager para conferir a lista de locais válidos.
  • PREVIEW_ID é o identificador da prévia e um nome especificado pelo usuário. O nome precisa:
    • conter apenas letras minúsculas, números ou hífens.
    • 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