配置文件错误

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档
信息

问题

边缘路由器使用 NGINX 实现。在 Edge 升级过程中或 更改路由器配置,则可能会看到 NGINX 配置错误。当这些 Edge 会标记导致此问题的所有 NGINX 配置文件, /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

错误消息

您不会看到任何错误消息。不过,您可能无法执行自己的 API, 因为配置文件有问题。

可能的原因

通常,NGINX 配置文件会被标记为错误,原因可能是设置为不正确的值, /opt/apigee/customer/application/router.properties 文件中的 NGINX 属性 或对虚拟主机进行了错误的更改。

诊断

  1. .bad /opt/nginx/conf.d 目录中,使其以 .conf 结尾。
  1. 运行 NGINX configtest 工具以确定失败原因:
    /opt/nginx/scripts/apigee-nginx configtest
    

分辨率

  1. 如果配置测试确定了配置文件错误的原因,可以执行以下操作来解决问题: 对 /opt/apigee/customer/application/router.properties 文件或虚拟主机。
  1. 移除 /opt/nginx/conf.d 目录:
    rm -rf /opt/nginx/conf.d
    
  1. 重启路由器:
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
    
  1. 您应该不会再在 /opt/nginx/conf.d 目录中。

如果问题仍然存在,请与 Apigee Edge 支持团队联系。

下面举例说明如何根据 执行 NGINX 配置测试

示例 1:为 NGINX 属性设置的值不正确

  1. 假设您更新了属性“proxy_busy_buffers_size” 大小达到 128K,如下所示:/opt/apigee/customer/application/router.properties 如下:
    conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=128k 
    

这会导致配置文件在 /opt/apigee/nginx/conf.d 中被标记为错误 目录。

  1. 运行 NGINX configtest 命令以确定失败原因:
    /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
    

configtest 结果会表明,属性的值 proxy_busy_buffers_size 应等于或大于 proxy_buffer_size,但设置的值似乎不正确。

  1. 检查为属性设置的值 proxy_buffer_sizeproxy_traffic_buffers_size0-default.conf 文件中:
    proxy_buffer_size 512k;
    proxy_busy_buffers_size 128k;
    
  1. /opt/apigee/customer/application/router.properties 文件:
    conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=512k
    
  1. 移除 /opt/nginx/conf.d 文件夹:
    rm -rf /opt/nginx/conf.d
    
  1. 重启路由器:
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
    

该问题现已解决,错误的配置文件已被移除。

示例 2:进程未能升级 NGINX(仅限 Private Cloud 18.01)

假设您运行 configtest 并得到以下响应:

/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

此失败表明进程无法将 NGINX 从 1.10.x 升级到 1.12.x。 存在一个与将 Edge 私有云升级到版本 18.01 相关的已知错误。

如需正确诊断此问题(仅当您使用 Private Cloud 18.01 时),请执行以下操作:

rpm -aq | grep apigee-nginx

此命令应返回 1.12.x 版中已安装的 rpm。如果没有,请按照以下步骤操作:

  1. 停止 Edge-router 组件。
  2. 备份 Edge-router 组件。
  3. 运行以下命令以升级到 apigee-nginx 1.2.x:
  4. sudo yum update apigee-nginx
  5. 删除 /opt/apigee/nginx/conf.d. 下的所有 *.bad 文件
  6. 重启 Edge-router 组件。