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 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, consulta gcloud 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

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:

Abre la consola de Cloud.
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.
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.
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.
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:
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:

Abre la IU de Apigee.

Ir a la IU de Apigee
Ve a Admin > Instances.
Anota la dirección IP de la instancia. Deberás conocer esta IP en un paso posterior. Por ejemplo: 10.117.200.2.
En la consola de Google Cloud, ve a la página Plantillas de instancia.

Ir a Plantillas de instancia
Abre la plantilla de instancia. Debes abrir la plantilla de instancia que usa el backend asignado a tu balanceador de cargas.
Desplázate hacia abajo para encontrar la IP ENDPOINT en la sección Metadatos personalizados.
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.