Solução de problemas dos Destinos hospedados

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
info

Falha na criação/implantação devido à ausência de package.json

Um arquivo package.json é necessário no diretório raiz do app Node.js. Qualquer tentativa de criar/implantar um proxy sem um package.json vai falhar no tempo de build.

Recebimento de gateway inválido 502 do proxy

Um erro "502 Bad Gateway" pode ocorrer quando o processo não é iniciado. Para depurar isso, verifique os registros de execução e procure mensagens de erro ao iniciar. Um erro comum é um comando de início ausente ou inválido em o package.json. No mínimo, o package.json precisa especificar "start": "node ." na propriedade scripts. Exemplo:

{
  "name": "hello-world",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
   "start": "node ."
  },
  "author": "",
  "license": "",
  "description": "Hello World Application",
  "dependencies": {
  }
}

O proxy trava e retorna o tempo limite do gateway 504

Um erro "504 Gateway Timeout" pode ocorrer quando o app de destino dos destinos hospedados não responde dentro de um limite de tempo limite. Verifique se o aplicativo está detectando a porta definida na variável de ambiente PORT. É possível acessar essa variável com process.env.PORT no aplicativo. Caso contrário, verifique os registros de execução para outras mensagens de erro. Consulte também Variáveis de ambiente definidas no ambiente de execução do aplicativo.

Além disso, o Google App Engine (GAE) impõe um tempo limite de solicitação de 60 segundos. Consulte também Cotas e limites na documentação do GAE.

Caractere inválido no caminho

Se você encontrar um erro semelhante ao seguinte ao implantar um proxy com destinos hospedados, a causa pode ser que o nome do proxy contenha um espaço. Não use um espaço em um nome de proxy com destinos hospedados.

Illegal character in path at index 69:
https://my-domain.net/organizations/my-org/apps/MD5 Hash/revision/1733635923

npm ERR! rofs EROFS: sistema de arquivos somente leitura

Os aplicativos de destinos hospedados são executados em contêineres usando um sistema de arquivos tmpfs. Somente o /tmp diretório no sistema de arquivos pode ser gravado pelo aplicativo de destino hospedado. Infelizmente, as versões mais recentes do NPM tentam gravar em /root/.npm para o cache, registros etc. Para resolver esse problema, consulte Alterar o local do cache do NPM ou Executar o aplicativo sem tarefas do NPM.