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 Infrastructure 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 Infra Manager usó 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 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 que se necesitan 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, 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, borras 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 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: 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 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 del borrado de los recursos. Para obtener más información, consulta Cómo obtener 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: 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 especificas. Consulta Nombre de la implementación para obtener detalles sobre las restricciones del identificador de implementación.

Conservar los recursos aprovisionados

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

Por ejemplo, implementas una configuración desde los planos y módulos de Terraform para Google Cloud. Una vez que se implementa, quieres administrar los recursos a través de la consola y no usar la infraestructura como código (IaC). En este caso, tal vez quieras borrar la implementación, ya que no necesitas 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: 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 especificas. Consulta Nombre de la implementación para obtener detalles sobre las restricciones del identificador de implementación.

¿Qué sigue?