Estás viendo la documentación de Apigee Edge.
Ve a la
Documentación de Apigee X. información
Síntoma
El router perimetral se implementa mediante NGINX. Durante el proceso de actualización de Edge o cuando
si cambias la configuración del router, es posible que veas errores de configuración de NGINX. Cuando estos
si ocurren errores, Edge marca todos los archivos de configuración de NGINX que causaron el problema
/opt/nginx/conf.d
:
-rw-r--r-- 1 apigee apigee 522 Jul 20 08:41 0-default.conf.bad -rw-r--r-- 1 apigee apigee 577 Jul 20 08:42 0-fallback.conf -rw-r--r-- 1 apigee apigee 1062 Jul 20 08:18 0-map.conf -rw-r--r-- 1 apigee apigee 1887 Jul 20 08:42 custorg_test_default.conf.bad
Mensajes de error
No verás ningún mensaje de error. Sin embargo, es posible que no puedas ejecutar tu API a través de proxies debido a los archivos de configuración incorrectos.
Causas posibles
Por lo general, los archivos de configuración de NGINX se marcan como incorrectos porque se configuraron valores incorrectos
Las propiedades de NGINX en el archivo /opt/apigee/customer/application/router.properties
o se realizan cambios incorrectos en un host virtual.
Diagnóstico
- Quita el sufijo .bad de los nombres de archivos de la
/opt/nginx/conf.d
para que terminen en .conf.
- Ejecuta la herramienta configtest de NGINX para determinar el motivo del error:
/opt/nginx/scripts/apigee-nginx configtest
Solución
- Si la prueba de configuración identifica el motivo de los archivos de configuración incorrectos, corrige el problema de la siguiente manera:
realizar los cambios adecuados a la propiedad específica
/opt/apigee/customer/application/router.properties
o un host virtual.
- Quita el directorio
/opt/nginx/conf.d
:rm -rf /opt/nginx/conf.d
- Reinicia el router:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- Ya no deberías ver los archivos de configuración incorrectos en el
/opt/nginx/conf.d
.
Si el problema persiste, comunícate con el equipo de asistencia de Apigee Edge.
Aquí te mostramos un ejemplo de cómo solucionar el problema según la información proporcionada por la prueba de configuración de NGINX.
Ejemplo 1: Conjunto de valores incorrectos para una propiedad NGINX
- Supongamos que actualizaste la propiedad “proxy_busy_buffers_size”.
a 128 K en el archivo
/opt/apigee/customer/application/router.properties
, como se muestra a continuación:conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=128k
Esto provocó que los archivos de configuración se marcaran como incorrectos en /opt/apigee/nginx/conf.d
.
.
- Ejecuta el comando NGINX configtest para determinar el motivo del error:
/opt/nginx/scripts/apigee-nginx configtest nginx: [emerg] "proxy_busy_buffers_size" must be equal to or greater than the maximum of the value of "proxy_buffer_size" and one of the "proxy_buffers" in /opt/nginx/conf/nginx.conf:47 nginx: configuration file /opt/nginx/conf/nginx.conf test failed
Los resultados de configtest indican que el valor de la propiedad proxy_busy_buffers_size debe ser igual o mayor que proxy_buffer_size, pero parece estar configurada con un valor incorrecto.
- Verifica los valores establecidos para las propiedades
proxy_buffer_size y proxy_busy_buffers_size
En el archivo
0-default.conf
, haz lo siguiente:proxy_buffer_size 512k; proxy_busy_buffers_size 128k;
- Actualiza el valor de proxy_busy_buffers_size a 512K en el
Archivo
/opt/apigee/customer/application/router.properties
:conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=512k
- Quita la carpeta
/opt/nginx/conf.d
:rm -rf /opt/nginx/conf.d
- Reinicia el router de la siguiente forma:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
Se solucionó el problema y se quitaron los archivos de configuración incorrectos.
Ejemplo 2: El proceso no puede actualizar NGINX (solo Cloud Private Cloud 18.01)
Supongamos que ejecutas configtest
y obtienes las siguientes respuestas:
/apigee-nginx configtest nginx: the configuration file /opt/nginx/conf/nginx.conf syntax is ok nginx: [emerg] zero size shared memory zone "perclient" nginx: configuration file /opt/nginx/conf/nginx.conf test failed
Este error indica que el proceso no pudo actualizar NGINX de 1.10.x a 1.12.x. Hay un error conocido relacionado con la actualización de la nube privada perimetral a la versión 18.01.
Para diagnosticar este problema de forma correcta (solo si usas la nube privada 18.01), haz lo siguiente:
rpm -aq | grep apigee-nginx
Este comando debería mostrar las rpm instaladas como versión 1.12.x. De lo contrario, sigue estos pasos:
- Detén el componente del router perimetral.
- Crea una copia de seguridad del componente del router perimetral.
- Ejecuta este comando para actualizar a apigee-nginx 1.2.x:
- Borrar los
*.bad
archivos en/opt/apigee/nginx/conf.d.
- Reinicia el componente del router perimetral.
sudo yum update apigee-nginx