Você está vendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. informações
Sintoma
O roteador de borda é implementado com o NGINX. Durante o processo de upgrade do Edge ou ao alterar a configuração do roteador, talvez você veja erros de configuração do NGINX. Quando esses
erros ocorrem, o Edge marca todos os arquivos de configuração do NGINX que causaram o 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
Mensagens de erro
Nenhuma mensagem de erro vai aparecer. No entanto, talvez não seja possível executar os proxies da API devido aos arquivos de configuração inválidos.
Causas possíveis
Normalmente, os arquivos de configuração do NGINX são marcados como inválidos. Isso ocorre porque valores incorretos são definidos nas propriedades do NGINX no arquivo /opt/apigee/customer/application/router.properties
ou alterações incorretas são feitas em um host virtual.
Diagnóstico
- Remova o sufixo .bad dos nomes de arquivo no diretório
/opt/nginx/conf.d
para que terminem em .conf.
- Execute a ferramenta configtest do NGINX para determinar o motivo da falha:
/opt/nginx/scripts/apigee-nginx configtest
Resolução
- Se o teste de configuração identificar o motivo dos arquivos de configuração incorretos, corrija o problema
fazendo as mudanças apropriadas na propriedade específica no
arquivo
/opt/apigee/customer/application/router.properties
ou no host virtual.
- Remova o diretório
/opt/nginx/conf.d
:rm -rf /opt/nginx/conf.d
- Reinicie o roteador:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- Você não verá mais arquivos de configuração inválidos no diretório
/opt/nginx/conf.d
.
Se o problema persistir, entre em contato com o suporte do Apigee Edge.
Veja um exemplo que mostra como corrigir o problema com base nas informações fornecidas pelo teste de configuração do NGINX.
Exemplo 1: valor incorreto definido para uma propriedade do NGINX
- Digamos que você atualizou a propriedade "proxy_busy_buffers_size"
para 128 K no arquivo
/opt/apigee/customer/application/router.properties
, conforme mostrado abaixo:conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=128k
Isso fez com que os arquivos de configuração fossem marcados como inválidos no diretório
/opt/apigee/nginx/conf.d
.
- Execute o comando configtest do NGINX para determinar o motivo da falha:
/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
Os resultados do Configtest indicam que o valor da propriedade proxy_busy_buffers_size precisa ser igual ou maior que proxy_busy_buffers_size, mas parece estar definido com um valor incorreto.
- Verifique os valores definidos para as propriedades
proxy_buffer_size e proxy_ Partner_buffers_size
no arquivo
0-default.conf
:proxy_buffer_size 512k; proxy_busy_buffers_size 128k;
- Atualize o valor de proxy_enabling_buffers_size para 512 K no arquivo
/opt/apigee/customer/application/router.properties
:conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=512k
- Remova a pasta
/opt/nginx/conf.d
:rm -rf /opt/nginx/conf.d
- Reinicie o roteador:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
O problema foi corrigido, e os arquivos de configuração incorretos foram removidos.
Exemplo 2: falha no upgrade do NGINX (somente nuvem privada 18.01)
Digamos que você execute configtest
e receba as seguintes respostas:
/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
Essa falha indica que o processo falhou ao fazer upgrade do NGINX de 1.10.x para 1.12.x. Há um bug conhecido relacionado ao upgrade do Edge Private Cloud para a versão 18.01.
Para diagnosticar adequadamente esse problema (apenas se você estiver na nuvem privada 18.01), faça o seguinte:
rpm -aq | grep apigee-nginx
Esse comando deve retornar o rpm instalado como versão 1.12.x. Caso contrário, siga estas etapas:
- Interrompa o componente do roteador de borda.
- Faça backup do componente do roteador de borda.
- Execute este comando para fazer upgrade para o apigee-nginx 1.2.x:
- Exclua todos os
*.bad
arquivos em/opt/apigee/nginx/conf.d.
- Reinicie o componente do roteador de borda.
sudo yum update apigee-nginx