Soluciona problemas de la instalación de Apigee

Estás viendo la documentación de Apigee X.
Consulta la documentación de Apigee Edge.

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

El problema habitual que puedes experimentar es el siguiente error 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)"

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 4: Configura las herramientas de redes de servicio.

    Para solicitar un rango nuevo del que Apigee elige una dirección IP para las conexiones del servicio privado, sigue estos pasos:

    1. Ejecuta el siguiente comando de gcloud:
      gcloud compute addresses create google-svcs-2
        --project=$PROJECT_ID --global --prefix-length=16
        --description="additional peering range for Google services" --network=default
        --purpose=VPC_PEERING

      Este comando crea un rango nuevo llamado google-svcs-2.

    2. Ejecuta el siguiente comando para actualizar tu solicitud de conexión:
      gcloud services vpc-peerings update
        --service=servicenetworking.googleapis.com --network=default
        --ranges=google-svcs,google-svcs-2 --project=$PROJECT_ID

      Nota: Debes especificar el nombre de tu primer rango (en este caso, google-svcs) y un nombre para el rango recién solicitado (en este caso, google-svcs-2). Para obtener más información, consultagcloud services vpc-peerings update.

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 API que se enumeran en el Paso 2: Habilita las API de Apigee 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úrese de haber habilitado todas las API, tal como se describe en el Paso 2: Habilita las API de Apigee.

Implementa muestras

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 Cloud Console.
  2. Verifica el estado del balanceador de cargas. En Cloud Console, 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.
  5. Intenta realizar un reinicio progresivo en el grupo de instancias en Cloud Console:
    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.