Archivos de configuración incorrectos

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

  1. Quita el sufijo .bad de los nombres de archivos de la /opt/nginx/conf.d para que terminen en .conf.
  1. Ejecuta la herramienta configtest de NGINX para determinar el motivo del error:
    /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, 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.
  1. Quita el directorio /opt/nginx/conf.d:
    rm -rf /opt/nginx/conf.d
    
  1. Reinicia el router:
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
    
  1. 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

  1. 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. .

  1. 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.

  1. 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;
    
  1. 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
    
  1. Quita la carpeta /opt/nginx/conf.d:
    rm -rf /opt/nginx/conf.d
    
  1. 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:

  1. Detén el componente del router perimetral.
  2. Crea una copia de seguridad del componente del router perimetral.
  3. Ejecuta este comando para actualizar a apigee-nginx 1.2.x:
  4. sudo yum update apigee-nginx
  5. Borrar los *.bad archivos en /opt/apigee/nginx/conf.d.
  6. Reinicia el componente del router perimetral.