Primeiros passos com o Node.js na Apigee Edge

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.
  1. No assistente "Criar um proxy", selecione App Node.js.
  2. Clique em Next.
  3. 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.
  4. 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".
  5. 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 proxy hello, 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.