Borra entornos

En este tema, se explica cómo borrar entornos en Apigee Hybrid. Consulta Información acerca de los entornos y grupos de entornos.

Acerca de la eliminación de entornos

La eliminación del entorno es el proceso inverso de la creación del entorno y, además, incluye las siguientes tareas:

  • Quita los componentes del entorno de ejecución del entorno de tu clúster y quita el entorno del archivo de anulaciones.
  • Borra el entorno del plano de administración con la IU de Apigee o la API de eliminación de entornos.

Cómo borrar un entorno

Supongamos que tienes dos entornos: prueba y producción. En tu archivo de anulación, las definiciones podrían verse de la siguiente manera:

...
envs:
  - name: test
    serviceAccountPaths:
      synchronizer: "your_keypath/PROJECT_ID-apigee-synchronizer.json"
      runtime: "your_keypath/PROJECT_ID-apigee-runtime.json"
      udca: "your_keypath/PROJECT_ID-apigee-udca.json"
  - name: prod
    serviceAccountPaths:
      synchronizer: "your_keypath/PROJECT_ID-apigee-synchronizer.json"
      runtime: "your_keypath/PROJECT_ID-apigee-runtime.json"
      udca: "your_keypath/PROJECT_ID-apigee-udca.json"
...

Para borrar el entorno de producción, sigue estos pasos:

  1. Obtén tus credenciales de autenticación de gcloud: 
    TOKEN=$(gcloud auth print-access-token)
  2. Como precaución, desconecta el entorno de cada grupo de entornos al que esté conectado. Esto evita que el tráfico se enrute al entorno antes de quitar sus componentes del entorno de ejecución.
    1. Enumera los adjuntos del grupo de entornos y anota el name (ID del adjunto) del adjunto cuyo environment es prod:

      Sin residencia de datos

      curl -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups/ENV_GROUP/attachments"

      Residencia de los datos

      curl -H "Authorization: Bearer $TOKEN" \
  "https://CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups/ENV_GROUP/attachments"

      El resultado es similar a lo siguiente:

      {
  "environmentGroupAttachments": [
    {
      "name": "f6f2958f-a0a1-4260-b9e9-80eead82ff1d",
      "environment": "prod",
      "createdAt": "1789700385118",
      "environmentGroupId": "ENV_GROUP"
    }
  ]
}
    2. Borra el adjunto:

      Sin residencia de datos

      curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups/ENV_GROUP/attachments/ATTACHMENT_ID"

      Residencia de los datos

      curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups/ENV_GROUP/attachments/ATTACHMENT_ID"

    Aquí:

    • ORG_NAME es el nombre de tu organización de Apigee.
    • ENV_GROUP es el nombre del grupo de entornos.
    • ATTACHMENT_ID es el name del archivo adjunto que se devolvió en el paso anterior. Este es un ID generado, no el nombre del entorno.
    • CONTROL_PLANE_LOCATION es la ubicación del plano de control de tu organización si usas la residencia de datos.

    Repite estos pasos para cada grupo de entornos al que esté conectado el entorno.

  3. Realiza una ejecución de prueba para probar la eliminación de los componentes del entorno de ejecución: 
    helm delete ENV_RELEASE_NAME -n APIGEE_NAMESPACE --dry-run
    • ENV_RELEASE_NAME es el nombre con el que se instaló el gráfico de apigee-env para este entorno. Por lo general, es el mismo que el nombre del entorno. Para enumerar los nombres de las versiones en tu espacio de nombres, ejecuta helm list -n APIGEE_NAMESPACE.
    • APIGEE_NAMESPACE es el espacio de nombres en el que instalaste Apigee Hybrid, apigee de forma predeterminada.

    La opción --dry-run simula la desinstalación sin quitar nada, y su resultado es el mismo que el de la desinstalación real. A diferencia de helm upgrade, helm delete no acepta un valor para --dry-run, como --dry-run=server. Por ejemplo:

    helm delete prod -n apigee --dry-run
release "prod" uninstalled
  4. Si la ejecución de prueba no tiene errores, quita los componentes de entorno de ejecución: 
    helm delete ENV_RELEASE_NAME -n APIGEE_NAMESPACE
  5. Abre el archivo de anulaciones y quita la definición del entorno prod de envs. Solo deja la definición test. Por ejemplo: 
    ...
envs:
  - name: test
    serviceAccountPaths:
      synchronizer: "your_keypath/PROJECT_ID-apigee-synchronizer.json"
      runtime: "your_keypath/PROJECT_ID-apigee-runtime.json"
      udca: "your_keypath/PROJECT_ID-apigee-udca.json"
...
  6. Guarda el archivo.
  7. Borra el entorno del plano de administración. Puedes usar la IU de Apigee o la API de eliminación de entornos.

    IU de Apigee

    1. En la consola de Google Cloud , ve a la página Apigee > Administración > Entornos.

      Ir a Entornos

    2. Selecciona el proyecto de tu organización de Apigee.
    3. En la fila del entorno prod, haz clic en Acciones > Borrar.

    API

    Sin residencia de datos:

    curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/prod"

    Residencia de los datos:

    curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/ORG_NAME/environments/prod"

    La llamada devuelve una operación de larga duración. La eliminación puede tardar unos minutos en completarse.