Borra una implementación

En esta página, se describe cómo borrar una implementación de Infrastructure Manager.

En esta página, se supone que estás familiarizado con Terraform. Para obtener más detalles, consulta Terraform y el Administrador de infraestructura.

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 de la configuración

Para borrar los recursos de Google Cloud en una implementación específica, la cuenta de servicio que usas para llamar a Infra Manager 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 Cómo configurar la cuenta de servicio.

Borra una implementación

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

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

Borra recursos aprovisionados

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

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

    gcloud infra-manager resources list 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 el Administrador de infraestructura.
    • LOCATION: Es 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 implementación que especifiques. 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 el Administrador de infraestructura.
    • LOCATION: Es 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 implementación que especifiques. Consulta Nombre de la implementación para obtener detalles sobre las restricciones del identificador de implementación.

Cómo conservar los recursos aprovisionados

Te recomendamos que borres la implementación y que conserves los recursos de Google Cloud que aprovisionó 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 desees borrar la implementación, ya que no usas los metadatos de la implementación.

Para borrar los metadatos de 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 el Administrador de infraestructura.
  • LOCATION: Es 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 implementación que especifiques. Consulta Nombre de la implementación para obtener detalles sobre las restricciones del identificador de implementación.

¿Qué sigue?