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, você aprenderá como:

  • Criar um aplicativo Starter do Node-RED que pode ser executado na IBM Cloud
  • Proteger o aplicativo
  • Personalizar o Kit Starter do Node-RED incluindo nós adicionais

Pré-requisitos

Para concluir este tutorial, é necessário abrir uma conta na IBM Cloud.

Este tutorial requer uma conta pré-paga da IBM Cloud. Para fazer upgrade da sua conta Lite, acesse as suas account settings. Na seção Account Upgrade, clique em Adicionar cartão de crédito para fazer upgrade para uma conta pré-paga ou clique em Upgrade para uma conta de Assinatura. Consulte Upgrading your account para obter mais informações.

Este tutorial Starter do Node-RED oferece instruções sobre a implementação do aplicativo no IBM Cloud Code Engine, que é uma plataforma totalmente gerenciada e sem servidor que executa suas cargas de trabalho conteinerizadas e gerencia a infraestrutura fundamental para você. O IBM Cloud Code Engine oferece 100.000 segundos de vCPU por mês e sem custo. Seu fluxo do Node-RED frequentemente ajustará a escalar para 0, o que significa que você não vai incorrer em nenhum encargo por uso leve ou moderado. Verifique seu consumo e confirme sua fatura periodicamente.

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. Criar seu 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. Criar seu aplicativo

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

1. Na guia Create, será sugerido um Nome de aplicativo gerado aleatoriamente. É possível aceitar esse nome padrão ou fornecer um nome exclusivo para o seu aplicativo. Isso passará a fazer 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 antes de continuar.

2. O aplicativo Starter do Node-RED exige uma instância do serviço de banco de dados Cloudant com credenciais IAM e Cloudant da IBM Cloud para armazenar a sua configuração de fluxo do aplicativo. Selecione a região em que o serviço deverá ser criado e qual o plano de precificação que ele deverá utilizar.

Note: É possível ter apenas uma instância do Cloudant usando o plano Cloudant Lite. Se você já tiver uma instância, será possível marcá-la na caixa de seleção Pricing plan. É 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. Esta ação resultará na criação do seu aplicativo e, se necessário, uma instância de serviço do banco de dados Cloudant, mas ainda não estará implementado na 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 local para execução. Esta etapa mostra como configurar o recurso de Entrega Contínua que implementará o aplicativo no espaço Code Engine da IBM Cloud.

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

2. Na próxima tela, clique no quadro Code Engine.

3. Role para baixo após selecionar o quadro Code Engine. 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 para criar a chave. Um diálogo de mensagem será exibido. Aceite os valores padrão e confirmar para fechar o diálogo.

4. Selecione a Region e Container registry region na qual deseja implementar seu aplicativo. Essa região deve corresponder à região na qual a instância do Cloudant foi criada.

5. Forneça um nome exclusivo para Project ou aceite o ‘project-name’ padrão

Clique em Next para continuar.

6. Configure a DevOps toolchain selecionando a region na qual ela deverá ser criada. Tente corresponder novamente à região que você selecionou anteriormente.

Clique em Create. Essa opção irá direcioná-lo à página de detalhes do aplicativo. A página de detalhes do aplicativo oferece uma visão geral útil de seu aplicativo incluindo detalhes de sua URL externa e dos serviços adicionais. Adicione esta página aos favoritos, pois será necessário acessá-la mais tarde.

7. Depois de alguns instantes, a seção Deployment Automation será atualizada com os detalhes do seu Pipeline de Entrega recém-criado. O campo Status do pipeline será exibido como In progress. Isso significa que o aplicativo está sendo criado e implementado.

8. A etapa Deploy levará alguns minutos até que seja concluída. Clique no link Status do ci-pipeline para verificar o andamento do Pipeline de Entrega. Finalmente, a etapa Deploy exibirá um sinal de visto na cor verde e uma mensagem Success para mostar que foi aprovada. Isto significa que o seu aplicativo Starter do Node-RED está em execução.

Etapa 4. Abrir o aplicativo do Node-RED

Agora que você já implementou o aplicativo do Node-RED, vamos abri-lo! Pode ser necessário ter que atualizar sua página.

Na página de detalhes do aplicativo, você poderá ver os campos preenchidos App URL, Source e Deployment target.

Página de detalhes do aplicativo do Node-RED

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

Etapa 5. Configurar o aplicativo do Node-RED

Ao abrir o aplicativo do Node-RED pela primeira vez, será necessário configurá-lo e definir as opções de segurança.

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

Configurar o aplicativo do Node-RED

2. Na tela inicial, clique em Next para continuar.

3. Proteja o seu editor Node-RED fornecendo um nome de usuário e uma senha. Se for necessário alterar estes dados em algum momento, edite os valores no banco de dados Cloudant ou substitua-os usando variáveis de ambiente. A documentação em 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 alterar 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 iniciar 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ódulo node-red-dashboard.

1. Na página de detalhes do aplicativo, clique na URL de Source. Essa ação irá direcioná-lo à 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. Este arquivo lista as dependências do módulo do aplicativo.

Na lista de arquivos, encontre 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",

Nota: 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)

Editar 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. Consulte o Pipeline de Entrega para acompanhar o progresso. 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 Status do aplicativo Starter do Node-RED em pipeline de entrega contínua

6. Após a etapa Deploy ser concluída, o aplicativo será reiniciado e os nós do node-red-dashboard estarão pré-instalados.

Resumo

Parabéns! Você agora criou um aplicativo do Node-RED hospedado na IBM Cloud. Você também aprendeu a editar o código-fonte do aplicativo e implementar as alterações automaticamente.