Acompanhe online o evento final da Maratona Behind the Code 2020 Inscreva-se já!



Crie um aplicativo Starter do Node-RED

Neste tutorial, será possível aprender como criar um aplicativo Starter do Node-RED no IBM Cloud, incluindo um banco de dados Cloudant para armazenar a configuração do fluxo do aplicativo.

Objetivos do aprendizado

Neste tutorial, será possível aprender como:

  • Criar um aplicativo Starter do Node-RED em execução no IBM Cloud
  • Proteger o aplicativo
  • Customizar o Kit Starter do Node-RED incluindo nós adicionais

Pré-requisitos

Para concluir este tutorial, é necessária uma conta do IBM Cloud (uma conta paga ou de teste do IBM Cloud Lite).

Tempo estimado

É possível concluir este tutorial em menos de 20 minutos.

Etapas

  1. Localizar o Starter do Node-RED no catálogo do IBM Cloud
  2. Configurar o aplicativo
  3. Ativar o recurso Entrega Contínua
  4. Abrir o aplicativo do Node-RED
  5. Configurar o aplicativo do Node-RED
  6. Incluir nós adicionais à paleta do Node-RED

Etapa 1. Localizar o Starter do Node-RED no catálogo do IBM Cloud

  1. Efetue login no IBM Cloud.

  2. Abra o catálogo e procure por node-red.

  3. Clique no bloco Node-RED App.

Essa opção mostrará uma visão geral do Kit Starter e o que ele oferece.

Etapa 2. Configurar o aplicativo

Agora é necessário configurar o aplicativo Starter do Node-RED.

  1. Na página Detalhes do aplicativo, um nome gerado aleatoriamente será sugerido – Node RED SSLPD na captura de tela abaixo. Aceite o nome padrão ou forneça um nome exclusivo para o aplicativo (1). Esse nome fará parte da URL do aplicativo.

    Note: Se o nome não for exclusivo, aparecerá uma mensagem de erro e será necessário inserir um nome diferente para continuar.

  2. O aplicativo Starter do Node-RED exige uma instância do serviço de banco de dados Cloudant para armazenar a configuração do fluxo do aplicativo. Selecione a região (2) em que o serviço deverá ser criado e qual plano de precificação ele deverá usar.

    Note: É possível ter somente uma instância do Cloudant usando o plano Lite. Se você já tiver uma instância, será possível marcá-la na caixa de seleção Pricing plan (3). É possível ter mais de um aplicativo Starter do Node-RED usando a mesma instância de serviço do Cloudant.

  3. Clique no botão Create para continuar. Isso criará o aplicativo, mas ele ainda não será implementado no IBM Cloud.

Etapa 3. Ativar o recurso Entrega Contínua

Neste momento, você já criou o aplicativo e os recursos necessários, mas ainda não o implementou em nenhum lugar para execução. Esta etapa mostra como configurar o recurso Entrega Contínua que implementará o aplicativo no espaço Cloud Foundry do IBM Cloud.

  1. Na próxima tela, clique no botão Deploy your app (1) para ativar o recurso Entrega Contínua para o aplicativo.

  2. Será necessário criar uma chave de IBM Cloud API para permitir que o processo de implementação acesse os recursos. Clique no botão New (1) para criar a chave. Um diálogo de mensagem será exibido. Leia o que ele diz e, em seguida, confirme e feche o diálogo.

  3. Aumente a régua de controle Memory allocation per instance (2) para 256 MB. Se você não aumentar a alocação de memória, o aplicativo do Node-RED poderá não ter memória suficiente para ser executado com sucesso.

  4. O kit Starter do Node-RED dá suporte somente para a implementação no espaço Cloud Foundry do IBM Cloud. Selecione a region (3) para deploy your application to. Essa região deve corresponder à região na qual a instância do Cloudant foi criada. Talvez os usuários do Lite possam implementar somente na região padrão.

    Clique Next para continuar.

  5. Selecione a region (4) na qual a DevOps toolchain será criada.

Clique em Create (5). Essa opção retornará à página de detalhes do aplicativo.

  1. Em alguns instantes, a seção Entrega Contínua será atualizada com os detalhes da Cadeia de ferramentas recém-criada. O campo Status do Pipeline de Entrega mostrará In progress. Isso significa que o aplicativo ainda está sendo criado e implementado.

    Clique no link In progress para ver o status completo do Pipeline de Entrega.

  2. O estágio Implementação levará alguns minutos para ser concluído. É possível clicar no link View logs and history para verificar seu andamento. Finalmente, o estágio Implementação ficará verde para mostrar que foi concluído. Isso significa que o aplicativo Starter do Node-RED está em execução agora.

Etapa 4. Abrir o aplicativo do Node-RED

Agora que você já implementou o aplicativo do Node-RED, vamos abri-lo!

  1. De volta à página de detalhes do aplicativo, você deve ver os campos App URL, Source e Deployment target fields preenchidos.

  2. Clique no App URL para abrir seu aplicativo Node-RED em uma nova guia do navegador.

Etapa 5. Configurar o aplicativo do Node-RED

Na primeira vez que você abrir o aplicativo do Node-RED, será necessário configurá-lo e definir a segurança.

  1. Uma nova guia do navegador será aberta com a página inicial do Node-RED.

    Configure o aplicativo do Node-RED

  2. Na página inicial, clique em Next para continuar.

  3. Proteja o editor do Node-RED fornecendo um username e uma password. Se for necessário mudar esses dados em algum momento, será possível editar os valores no banco de dados Cloudant ou substituí-los usando variáveis de ambiente. A documentação no nodered.org descreve como fazer isso. Clique em Next para continuar.

  4. A tela final resume as opções que você escolheu e destaca as variáveis de ambiente que poderão ser usadas para mudar as opções futuramente. Clique em Finish para continuar.

  5. O Node-RED salvará as mudanças e, em seguida, carregará o aplicativo principal. Aqui, é possível clicar no botão Go to your Node-RED flow editor para abrir o editor.

    Botão para ativar o editor de fluxo do Node-RED

    O editor do Node-RED é aberto mostrando o fluxo padrão.

    Fluxo padrão no editor de fluxo do Node-RED

Etapa 6. Incluir nós adicionais na paleta do Node-RED

O Node-RED fornece o recurso gerenciador de paleta que permite instalar nós adicionais diretamente do editor baseado em navegador. Isso é útil para testar os nós, mas pode causar problemas devido à limitação de memória do aplicativo Starter do Node-RED padrão.

A abordagem recomendada é editar o arquivo package.json do aplicativo para incluir os módulos de nós adicionais e, em seguida, reimplementar o aplicativo.

Esta etapa mostra como fazer isso para incluir o módulonode-red-dashboard.

  1. Na página de detalhes do aplicativo, clique na URL na caixa Entrega contínua. Isso o levará à um repositório Git no qual é possível editar o código-fonte do aplicativo usando o navegador.

  2. Role a lista de arquivos para baixo e clique em package.json. Esse arquivo lista as dependências do módulo do aplicativo.

    Na lista de arquivos, localize o arquivo package.json

  3. Clique no botão Edit

    Botão Editar do arquivo package.json

  4. Inclua a seguinte entrada na parte superior da seção dependencies (1):

     "node-red-dashboard": "2.x",
    

    Note: Não se esqueça da vírgula (,) no final da linha para separá-la da próxima entrada.

    Inclua uma Commit message (2) e clique em Commit changes (3)

    Editando o arquivo package.json

  5. Neste momento, o pipeline de Entrega Contínua será executado automaticamente para desenvolver e implementar essa mudança no aplicativo. Se você visualizar o Pipeline de Entrega, poderá acompanhar o andamento. A seção Compilação mostra a última confirmação feita (1), e a seção Implementação mostra o andamento da reimplementação do aplicativo (2).

    Status do aplicativo Starter do Node-RED no pipeline de entrega contínua

  6. Quando o estágio Implementação for concluído, o aplicativo terá sido reiniciado e estará com os nós node-red-dashboard pré-instalados.

Note: se você tiver uma conta Lite, estará limitado a 256 MB de memória total para seus aplicativos em execução. O padrão o comportamento do pipeline é iniciar uma segunda instância do aplicativo antes de mover a URL e excluir o instância antiga. Isso minimiza o tempo de inatividade durante uma implantação, mas requer o dobro da memória. Se você criou seu aplicativo com 256 MB de memória originalmente, você precisará interromper o aplicativo antes que o pipeline seja executado. Para fazer isso, clique no link Deployment Target na página de detalhes do aplicativo. Isso abre a página de detalhes do aplicativo Cloud Foundry. Nessa página, selecione a opção Stop no menu Actions.

Resumo

Parabéns! Você criou um aplicativo do Node-RED hospedado no IBM Cloud. Você também aprendeu como editar o código-fonte do aplicativo e implementar as mudanças automaticamente.

Aviso

O conteúdo aqui presente foi traduzido da página IBM Developer US. Caso haja qualquer divergência de texto e/ou versões, consulte o conteúdo original.