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 más común que puedes experimentar es el siguiente error 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 inicialmente no se pudo adaptar y que debes solicitar un rango nuevo. Inicialmente, creaste una solicitud de rango en el Paso 4: Configura las Herramientas de redes de servicios.

    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 una solicitud de rango nueva.

      Ten en cuenta que debes especificar el nombre de tu primer rango (en este caso, “google-svcs”) y un nombre para el rango que solicitaste recientemente (en este caso, “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

      Ten en cuenta que el comando vpc-peerings update ahora especifica también los rangos de direcciones IP anteriores y nuevos.

      Para obtener más información, consulta gcloud services vpc-peerings update.

Crea una organización de Apigee

En el siguiente ejemplo, se muestra un error común que Apigee podría 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 enumeradas 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 403 la primera vez que intentas crear la organización nueva, es posible que no se haya habilitado una o más de tus API. Asegúrate de habilitar todas las API 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 HTTP 502 (Bad Gateway). En ese caso, pruebe lo siguiente:

  1. Abre Cloud Console.
  2. Comprueba el estado del balanceador de cargas. En Cloud Console, selecciona Servicios de red > Balanceo de cargas. La pestaña Balanceador de cargas muestra 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.