Borra una implementación

Infrastructure Manager te permite quitar las implementaciones que ya no necesitas. Cuando borras una implementación, se quitan sus metadatos y su estado, y tienes la opción de borrar o conservar los recursos aprovisionados subyacentes.

En este documento, se supone que estás familiarizado con Terraform. Para obtener más detalles, consulta Terraform e Infra Manager.

Antes de comenzar

  1. Asegúrate de que Infra Manager esté habilitado.
  2. Asegúrate de tener los permisos de IAM necesarios para crear implementaciones: roles/config.admin.
  3. Asegúrate de que la cuenta de servicio que se usó por última vez para crear o actualizar la implementación siga siendo válida. Infra Manager usa esta cuenta de servicio para borrar la implementación.
  4. Asegúrate de que la configuración de Terraform que usó Infra Manager para crear o actualizar la implementación siga siendo válida. Infra Manager usa esta configuración para borrar la implementación.
  5. Identifica la implementación de Infra Manager que deseas borrar.
  6. Asegúrate de que la cuenta de servicio tenga los permisos de IAM necesarios para borrar recursos en los proyectos y las ubicaciones especificados.

Otorga permisos específicos para la configuración

Para borrar recursos de Google Cloud en una implementación específica, la cuenta de servicio que usas para llamar al Administrador de infraestructura necesita permisos específicos para lo que borras.

Estos permisos se suman a los necesarios para usar el servicio de Infra Manager.

Para obtener detalles sobre cómo otorgar permisos para los recursos de Google Cloud y asegurarte de tener acceso a los proyectos necesarios, consulta Configura la cuenta de servicio.

Borra una implementación

Cuando se crea una implementación de Infra Manager, Infra Manager almacena metadatos sobre la implementación, la configuración de Terraform que se implementa y el archivo de estado.

Cuando borras una implementación, se borran estos metadatos y archivos. También puedes borrar los recursos aprovisionados por la implementación o conservarlos.

Borra los recursos aprovisionados

Para borrar los metadatos de la implementación y los recursos aprovisionados, haz lo siguiente:

  1. De manera opcional, enumera los recursos aprovisionados por la implementación:

    gcloud infra-manager resources list --revision=projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID/revisions/REVISION_ID

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto en el que se ejecuta Infrastructure Manager.
    • LOCATION: la ubicación en la que se ejecuta Infra Manager. Consulta Ubicaciones de Infrastructure Manager para obtener la lista de ubicaciones válidas.
    • DEPLOYMENT_ID: Es el identificador de la implementación que especificas. Consulta Nombre de la implementación para obtener detalles sobre las restricciones del identificador de implementación.
    • REVISION_ID: Es el ID de revisión que representa una revisión específica de una implementación. Consulta Nombre de la implementación para obtener detalles sobre las restricciones del identificador de revisión.

  2. Obtén una vista previa de la eliminación de los recursos. Para obtener más información, consulta Obtén una vista previa de la eliminación de una implementación.

  3. Borra la implementación y los recursos aprovisionados:

    gcloud infra-manager deployments delete projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto en el que se ejecuta Infrastructure Manager.
    • LOCATION: la ubicación en la que se ejecuta Infra Manager. Consulta Ubicaciones de Infrastructure Manager para obtener la lista de ubicaciones válidas.
    • DEPLOYMENT_ID: Es el identificador de la implementación que especificas. Consulta Nombre de la implementación para obtener detalles sobre las restricciones del identificador de implementación.

Mantén los recursos aprovisionados

Es posible que quieras borrar la implementación y conservar los recursos de Google Cloud que se aprovisionaron con la implementación.

Por ejemplo, implementas una configuración desde los planos y módulos de Terraform para Google Cloud. Una vez que se implemente, querrás administrar los recursos a través de la consola y no usar la infraestructura como código (IaC). En este caso, es posible que quieras borrar la implementación, ya que no usas los metadatos de la implementación.

Para borrar los metadatos de la implementación y conservar los recursos aprovisionados, haz lo siguiente:

gcloud infra-manager deployments delete projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \
    --delete-policy=abandon

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que se ejecuta Infrastructure Manager.
  • LOCATION: la ubicación en la que se ejecuta Infra Manager. Consulta Ubicaciones de Infrastructure Manager para obtener la lista de ubicaciones válidas.
  • DEPLOYMENT_ID: Es el identificador de la implementación que especificas. Consulta Nombre de la implementación para obtener detalles sobre las restricciones del identificador de implementación.

¿Qué sigue?