Archivos de configuración incorrectos

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

Síntoma

El router de Edge se implementa con NGINX. Durante el proceso de actualización de Edge o cuando cambias la configuración del router, es posible que veas errores de configuración de NGINX. Cuando se producen estos errores, Edge marca todos los archivos de configuración de NGINX que causaron el problema en /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 tus proxies de API 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 establecen valores incorrectos en las propiedades de NGINX en el archivo/opt/apigee/customer/application/router.properties o se realizan cambios incorrectos en un host virtual.

Diagnóstico

1. Quita el sufijo .bad de los nombres de archivo en el /opt/nginx/conf.d directorio para que terminen en .conf.

2. Ejecuta la herramienta configtest de NGINX para determinar el motivo de la falla:

   /opt/nginx/scripts/apigee-nginx configtest

Solución

1. Si la prueba de configuración identifica el motivo de los archivos de configuración incorrectos, soluciona el problema realizando los cambios adecuados en la propiedad específica del archivo /opt/apigee/customer/application/router.properties o el host virtual.

2. Quita el directorio /opt/nginx/conf.d:

   rm -rf /opt/nginx/conf.d

3. Reinicia el router:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart

4. Ya no deberías ver archivos de configuración incorrectos en el /opt/nginx/conf.d directorio.

Si el problema persiste, comunícate con el equipo de asistencia de Apigee Edge.

Este es un ejemplo que muestra cómo solucionar el problema en función de la información proporcionada por la prueba de configuración de NGINX.

Ejemplo 1: Valor incorrecto establecido para una propiedad de NGINX

1. Supongamos que actualizaste la propiedad “proxy_busy_buffers_size” a 128K 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 hizo que los archivos de configuración se marcaran como incorrectos en /opt/apigee/nginx/conf.d directorio.

2. Ejecuta el comando configtest de NGINX para determinar el motivo de la falla:

   /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 que se estableció con un valor incorrecto.

3. Verifica los valores establecidos para las propiedades proxy_buffer_size y proxy_busy_buffers_size en el 0-default.conf archivo:

   proxy_buffer_size 512k;
   proxy_busy_buffers_size 128k;

4. Actualiza el valor de proxy_busy_buffers_size a 512K en el /opt/apigee/customer/application/router.properties archivo:

   conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=512k

5. Quita la carpeta /opt/nginx/conf.d:

   rm -rf /opt/nginx/conf.d

6. Reinicia el router:

   /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 en la nube privada 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

Esta falla indica que el proceso no pudo actualizar NGINX de la versión 1.10.x a la 1.12.x. Existe un error conocido relacionado con la actualización de Edge para la nube privada a la versión 18.01.

Para diagnosticar correctamente este problema (solo si usas la nube privada 18.01), haz lo siguiente:

rpm -aq | grep apigee-nginx

Este comando debería mostrar el rpm instalado como la versión 1.12.x. Si no lo hace, sigue estos pasos:

1. Detén el componente edge-router.
2. Crea una copia de seguridad del componente edge-router.
3. Ejecuta este comando para actualizar a apigee-nginx 1.2.x:

sudo yum update apigee-nginx

4. Borra todos los archivos *.bad en /opt/apigee/nginx/conf.d.
5. Reinicia el componente edge-router.