Você está vendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. informações
Neste tópico, explicamos a maneira mais simples de unir um aplicativo Node.js em um proxy de API usando a interface de gerenciamento.
Introdução
É provável que o primeiro app Node.js que você criou tenha sido um servidor HTTP que responde a solicitações com "Hello World!" A maneira mais simples de testar o Node.js no Apigee Edge é fazer algo muito semelhante. Com apenas alguns cliques, você terá um servidor HTTP Node.js com proxy em execução no Edge. Depois disso, é possível usar o editor de código na IU para modificar o app Node.js, adicionar outros arquivos Node.js, adicionar políticas e assim por diante.
Criação do exemplo "Hello World!" Proxy de API
Nesta seção, explicamos como criar um proxy da API Edge que interage com um servidor HTTP Node.js. O código do servidor HTTP Node.js já foi escrito e será implantado automaticamente no Edge quando você seguir estas etapas simples.- No assistente "Criar um proxy", selecione App Node.js.
- Clique em Next.
- Siga as etapas do assistente "Criar um proxy" e faça as seleções a seguir.
Campo Seleção Detalhes Nome do proxy Digite Nodejs-Hello
. O nome exibido para sua API.Caminho base de proxy Digite nodejs-hello Origem Selecione Exemplo"Hello World". Discutiremos as outras opções posteriormente neste tópico. Descrição Insira uma descrição para a API. Segurança Passar (nenhum) Selecione Passar (nenhum). Cria um proxy de passagem simples. Hosts virtuais padrão, seguro Não altere os padrões. Para saber mais sobre hosts virtuais, consulte Sobre hosts virtuais (Beta). Build Implantar ambientes Selecione teste. - Clique em Build and Deploy.
Em resposta, você verá uma confirmação de que seu novo proxy de API foi criado e implantado com sucesso no ambiente de "teste". - Clique em Ver o proxy de <nome do proxy> no editor para acessar a página de detalhes do proxy de API.
Como invocar o proxy "Hello"
Quando você chama o proxyhello
, o aplicativo Node.js é executado automaticamente, respondendo com "Hello, World!". A menos que você especifique o contrário, o aplicativo Node.js é implantado no ambiente chamado test. Aqui está a chamada básica com Curl (substitua o nome da sua organização por myorg).
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!
Como visualizar e editar o código Node.js
Vejamos o código Node.js que foi adicionado ao proxy de API. Acesse a página de resumo do proxy Hello World e clique em Develop.
Isso abre a visualização "Develop", que inclui um editor de código. Você pode editar o código diretamente lá.
Por exemplo, altere a resposta de Hello, World!
para outra coisa, como
Hello, Node!
, e clique em Salvar. O proxy é
salvo e reimplantado.
Por fim, invoque novamente o proxy para verificar a mudança:
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, Node!
Mais informações sobre como executar aplicativos Node.js no Apigee Edge
Como todos os aplicativos Node.js, os aplicativos Node.js em execução no Apigee Edge são executados em uma única linha de execução de controle. Não é necessário (e, na verdade, nenhuma capacidade) iniciar outra linha de execução ou sincronizar variáveis entre elas. Como o Node.js aplica uma programação sem bloqueio, um único script pode aceitar milhares de solicitações simultâneas. Isso porque o script libera a CPU sempre que precisa esperar por algo e é notificado mais tarde quando isso acontece.
Para usar o Node.js no Apigee Edge, você precisa especificar um arquivo de script Node.js principal. Esse script precisa ser configurado para processar solicitações recebidas, o que é feito normalmente com os módulos http
ou https
, a criação de um cliente e assim por diante. Se o script principal não estiver configurado dessa maneira, ele será executado e fechado após a implantação. No Apigee Edge, cada script de aplicativo Node.js é iniciado desde o início, quando o proxy é implantado, e interrompido quando o proxy é removido. No meio, ele aguardará novas solicitações e as processará. Para mais informações, consulte "Como invocar um arquivo Node.js importado" em
Como implantar um aplicativo
Node.js autônomo.
Próximas etapas
Também é possível criar e implantar aplicativos Node.js independentes diretamente do seu sistema de arquivos.
No próximo tópico, Como implantar um
app Node.js independente, explicamos como usar o comando apigeetool
para implantar um
app Node.js usando a linha de comando.