Descripción general de las implementaciones, revisiones y vistas previas

En esta página, se describen las implementaciones y las revisiones, incluidos los siguientes temas:

  • Es la lista de metadatos almacenados para cada implementación.
  • Es el formato del nombre de la implementación y el nombre de la revisión.

Implementaciones

Infra Manager aprovisiona recursos en Google Cloud como una implementación.

Una implementación puede aprovisionar Google Cloud recursos en varias ubicaciones y en varios proyectos. Ten en cuenta lo siguiente:

  • Los recursos específicos deben estar disponibles en las ubicaciones. Por ejemplo, consulta Ubicaciones de Cloud Run para ver la lista de ubicaciones en las que está disponible Cloud Run.
  • La cuenta de servicio debe tener los permisos necesarios para realizar la implementación en los proyectos especificados. Para obtener más información, consulta Configura la cuenta de servicio.

Metadatos de la implementación

Infra Manager crea un bucket de almacenamiento en el proyecto y la ubicación donde se ejecuta Infra Manager. Después de crear la implementación, los artefactos de Infrastructure Manager se encuentran en este bucket de almacenamiento, que tiene el nombre gs://PROJECT_NUMBER-LOCATION-blueprint-config.

Infra Manager usa el término blueprint para hacer referencia a una configuración de Terraform.

En el ejemplo anterior, deberías reemplazar los siguientes elementos:

  • PROJECT_ID: Es el ID del proyecto en el que se ejecuta Infra Manager.
  • LOCATION: Es la ubicación en la que se ejecuta Infra Manager.

Los artefactos de implementación en el bucket de almacenamiento incluyen lo siguiente:

  • Registros de Cloud Build
  • Registros de Terraform
  • Copia de la configuración de Terraform

Infra Manager también almacena una copia del archivo de estado de Terraform. Para obtener detalles sobre el archivo de estado, incluido el acceso al archivo, consulta Administra el archivo de estado de Terraform.

Las revisiones son versiones de una implementación, por lo que Infra Manager almacena los metadatos de esta implementación para cada revisión.

ID de implementación

El ID de la implementación es el identificador especificado por el usuario para un recurso de implementación. Usa el ID de implementación para hacer referencia a una implementación con el siguiente formato:

projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID

Reemplaza lo siguiente:

  • PROJECT_ID es el ID del proyecto en el que se ejecuta Infra Manager.
  • LOCATION es la ubicación en la que se ejecuta Infra Manager. Consulta las ubicaciones de Infrastructure Manager para ver la lista de ubicaciones válidas.
  • DEPLOYMENT_ID es el ID de la implementación, que es un nombre especificado por el usuario. Este ID debe cumplir con los siguientes requisitos:
    • Contener solo letras minúsculas, números o guiones
    • Comienza con una letra en minúscula.
    • Termina con un número o una letra minúscula
    • No puede ser la cadena archived-deployments ni archived-previews
    • Debe ser único dentro del proyecto y la ubicación en la que se ejecuta Infra Manager.

Por ejemplo:

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

Revisiones

Las revisiones son versiones de una implementación. Cuando creas una implementación por primera vez, esta también es una revisión y tiene el ID de revisión r-0.

Nombre de la revisión

Cuando creas una implementación de Infra Manager, se le asigna automáticamente el identificador de revisión r-0. Si actualizas la implementación, Infrastructure Manager crea una revisión nueva con el identificador r-1. El identificador aumenta en uno con cada revisión nueva. Solo Infrastructure Manager puede establecer el identificador de revisión.

Por ejemplo, el nombre de una revisión podría ser el siguiente:

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

Vistas previas

Una vista previa describe las acciones para activar una configuración específica de Terraform. Antes de crear o actualizar una implementación, puedes obtener una vista previa de ella para verificar los recursos que se planean aprovisionar.

Obtén una vista previa de los metadatos

Infra Manager crea un bucket de almacenamiento en el proyecto y la ubicación donde se ejecuta Infra Manager. Después de crear la vista previa, los artefactos de Infra Manager se encuentran en este bucket de almacenamiento, que tiene el nombre gs://PROJECT_NUMBER-LOCATION-blueprint-config.

En el caso de la vista previa de una implementación nueva, los metadatos se organizan con un prefijo new-previews, por ejemplo: gs://PROJECT_NUMBER-LOCATION-blueprint-config/new-previews/preview-name

También puedes obtener una vista previa de una actualización de una implementación existente. En el caso de estas vistas previas dirigidas a una implementación existente, los artefactos se almacenan en el mismo bucket de almacenamiento que los artefactos de la implementación. El bucket de almacenamiento que tiene el nombre gs://PROJECT_ID-LOCATION-blueprint-config/deployment-ID/previews/preview-ID.

Infrastructure Manager usa el término blueprint para hacer referencia a una configuración de Terraform.

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que se ejecuta Infra Manager.
  • LOCATION: Es la ubicación en la que se ejecuta Infra Manager.

Los artefactos de vista previa en el bucket de almacenamiento incluyen lo siguiente:

  • Registros de Cloud Build
  • Registros de Terraform
  • Copia de la configuración de Terraform

Nombre de la vista previa

El formato del nombre de la vista previa es el siguiente:

projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID

Aquí:

  • PROJECT_ID es el ID del proyecto en el que se ejecuta Infra Manager.
  • LOCATION es la ubicación en la que se ejecuta Infra Manager. Consulta las ubicaciones de Infrastructure Manager para ver la lista de ubicaciones válidas.
  • PREVIEW_ID es el identificador de la versión preliminar y es un nombre especificado por el usuario. El nombre debe cumplir con los siguientes requisitos:
    • Contener solo letras minúsculas, números o guiones
    • Comienza con una letra en minúscula.
    • Termina con un número o una letra minúscula
    • No puede ser la cadena archived-deployments ni archived-previews
    • Debe ser único dentro del proyecto y la ubicación en la que se ejecuta Infra Manager.

Por ejemplo:

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

¿Qué sigue?