Soluciona problemas de la instalación de Apigee

Esta página se aplica a Apigee, pero no a Apigee Hybrid.

Consulta la documentación de Apigee Edge.

En este documento, se enumeran los errores comunes y se describen las posibles soluciones de instalación y configuración de Apigee.

Crea una instancia nueva

En esta sección, se describen errores comunes y posibles soluciones después de enviar una solicitud a Apigee para crear una instancia nueva:

  • 401 (UNAUTHENTICATED) indica que es posible que se haya agotado el tiempo de espera de tus credenciales. Intenta renovar el token de autorización, como se muestra en el siguiente ejemplo: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • RANGES_EXHAUSTED indica que el rango de direcciones IP que solicitaste al principio no se pudo alojar y que debes solicitar un rango nuevo. En un principio, creaste una solicitud de rango en el Paso 2: Configura las herramientas de red.
    1. Crea estas variables de entorno
      2. RANGE_NAME_1=YOUR_RANGE_NAME_1
  RANGE_NAME_2=YOUR_RANGE_NAME_2
  NETWORK_NAME=YOUR_NETWORK_NAME
    2. Verifica los detalles de los rangos de direcciones existentes y asegúrate de que no se superpongan con el rango nuevo. 
      3.  gcloud compute addresses list --global --project=$PROJECT_ID
       
       gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID
    3. Para solicitar un rango nuevo del que Apigee elija una dirección IP para las conexiones de servicios privados, ejecuta el siguiente comando gcloud: 
      4.  gcloud compute addresses create $RANGE_NAME_2
            --project=$PROJECT_ID --global --prefix-length=16
            --description="additional peering range for Google services" --network=$NETWORK_NAME
            --purpose=VPC_PEERING

      Este comando crea un rango nuevo llamado $RANGE_NAME_2.

    4. Verifica los detalles del rango de direcciones anterior y nuevo 
      5.  gcloud compute addresses list --global --project=$PROJECT_ID 
       gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID 
       gcloud compute addresses describe $RANGE_NAME_2 --global --project=$PROJECT_ID
    5. Verifica los detalles del intercambio de tráfico de VPC existentes: 
      6.  gcloud services vpc-peerings list \
            --network=$NETWORK_NAME \
            --service=servicenetworking.googleapis.com \
            --project=$PROJECT_ID
    6. Ejecuta el siguiente comando para actualizar tu solicitud de conexión: 
      7.  gcloud services vpc-peerings update
            --service=servicenetworking.googleapis.com --network=$NETWORK_NAME
            --ranges=$RANGE_NAME_1,$RANGE_NAME_2 --project=$PROJECT_ID
    7. Verifica los detalles del intercambio de tráfico de VPC existentes: 
      8.  gcloud services vpc-peerings list \
            --network=$NETWORK_NAME \
            --service=servicenetworking.googleapis.com \
            --project=$PROJECT_ID

Crea una organización de Apigee

En el siguiente ejemplo, se muestra un error común que Apigee puede mostrar cuando intentas crear una organización por primera vez:

Error de creación de la organización

Esto significa que una o más de las API requeridas no están habilitadas. Revisa las APIs que se enumeran en el Paso 1: Habilita las API necesarias y asegúrate de que todas las API estén habilitadas antes de continuar.

Además, es posible que obtengas uno de los siguientes errores de HTTP:

  • 401 (UNAUTHENTICATED) indica que es posible que se haya agotado el tiempo de espera de tus credenciales. Intenta renovar el token de autorización, como se muestra en el siguiente ejemplo: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • 404 (Not Found) puede ser el resultado de lo siguiente:
    • Ingresaste la URL del extremo o la solicitud incorrectos. Verifica que hayas especificado apigee.googleapis.com para el dominio de la llamada a la API.
    • Es posible que tu proyecto aún no esté aprovisionado. Comunícate con Ventas de Apigee.
  • 409 (Conflict) suele indicar que el nombre de la organización en particular ya existe. Los nombres de las organizaciones deben ser únicos a nivel global. Elige otro nombre para la organización y vuelve a emitir el comando. (Especifica el nombre en la carga útil de la solicitud si creas una organización en la línea de comandos. Ten en cuenta que debes crear una organización que tenga el mismo nombre que tu proyecto, por lo que esto no debería suceder, a menos que haya un error tipográfico.)

El siguiente es un error posible que Apigee podría mostrar cuando verifiques el estado de una nueva solicitud de la organización:

  • 403 (Permission Denied) podría indicar que la organización aún no se creó. Espera un minuto y vuelve a intentarlo. Si Apigee muestra un error 403 cuando intentas crear la organización nueva por primera vez, puede significar que una o más de tus API no se habilitaron. Asegúrate de haber habilitado todas las APIs como se describe en el Paso 1: Habilita las APIs necesarias.

Implementa muestras

El balanceador de cargas no está en buen estado

Cuando implementas un proxy de muestra, Apigee podría mostrar un error de HTTP 502 (Bad Gateway). En este caso, intenta lo siguiente:

  1. Abre la consola de Cloud.
  2. Verifica el estado del balanceador de cargas. En la consola de Cloud, selecciona Servicios de red > Balanceo de cargas. En la pestaña Balanceador de cargas, se muestran todos los balanceadores de cargas del proyecto y sus estados. Un triángulo amarillo indica que el servicio de backend del balanceador de cargas no está en buen estado.
  3. Después de confirmar un problema con el balanceador de cargas, verifica las VM en tu instancia de entorno de ejecución para asegurarte de que estén en funcionamiento.
  4. Consulta los archivos de registro para ver si puedes encontrar un error o algún otro tipo de inconveniente que pueda ocasionar un problema. Para obtener más información sobre cómo habilitar y ver los registros, consulta Visualiza los registros.
  5. Intenta realizar un reinicio progresivo en el grupo de instancias en la consola de Cloud:
    1. Selecciona Compute Engine > Grupos de instancias.
    2. En la lista de grupos de instancias, haz clic en el que no responda en la columna Nombre.
    3. Haz clic en Reiniciar o reemplazar de manera progresiva, como se muestra en el siguiente ejemplo:

      Reinicio progresivo de Compute Engine

    4. En la siguiente pantalla, haz clic en Reiniciar.

      Esto reinicia la instancia de Envoy.

IP de instancia incorrecta

Si en algún momento borras y vuelves a crear tu instancia de Apigee, la IP de la instancia cambiará y podría desincronizarse con la IP de extremo de la plantilla del grupo de instancias administrado (MIG). Por ejemplo, la plantilla del MIG seguirá teniendo la IP anterior de la instancia borrada. La plantilla del MIG se creó durante el proceso de aprovisionamiento de Apigee. En este caso, prueba los siguientes pasos para actualizar la plantilla del MIG con la IP de Apigee correcta:

  1. Abre la IU de Apigee.

    Ir a la IU de Apigee

  2. Ve a Admin > Instances.
  3. Anota la dirección IP de la instancia. Deberás conocer esta IP en un paso posterior. Por ejemplo: 10.117.200.2.

  4. En la consola de Google Cloud, ve a la página Plantillas de instancia.

    Ir a Plantillas de instancia

  5. Abre la plantilla de instancia. Debes abrir la plantilla de instancia que usa el backend asignado a tu balanceador de cargas.
  6. Desplázate hacia abajo para encontrar la IP ENDPOINT en la sección Metadatos personalizados.
  7. Si la IP de extremo difiere de la que anotaste en la IU de Apigee, debes cambiar la IP de la plantilla de instancia para que coincida con la IP de la instancia de Apigee. Consulta Cambia las IP de instancias.