Node-RED: Gerir projetos

Como usar "Projects" no Node-RED

👋 Bem-vindo à documentação da Stackhero!

A Stackhero oferece uma solução Node-RED cloud pronta a usar que proporciona uma série de benefícios, incluindo:

  • Servidor MQTT incluído (Mosquitto).
  • Acesso completo à interface de administração do Node-RED.
  • Dashboard do Node-RED incluído.
  • Servidor de email SMTP ilimitado e dedicado incluído.
  • Atualizações sem esforço com apenas um clique.
  • Nome de domínio personalizável seguro com HTTPS (por exemplo, https://node-red.sua-empresa.com).
  • Desempenho ótimo e segurança robusta alimentados por uma VM privada e dedicada.

Poupe tempo e simplifique a sua vida: leva apenas 5 minutos para experimentar a solução de hospedagem em cloud Node-RED da Stackhero!

"Projects" no Node-RED é uma funcionalidade avançada que integra de forma transparente o controlo de versão baseado em Git no seu fluxo de trabalho. Ao aproveitar esta funcionalidade, pode gerir e sincronizar eficientemente os seus fluxos com repositórios Git externos, promovendo práticas de desenvolvimento colaborativas e estruturadas.

Para começar, inicie sessão na sua instância do Node-RED. Localize o ícone do menu "hamburger" no canto superior esquerdo, navegue até "Projects" e selecione "New".

Ecrã de boas-vindasEcrã de boas-vindas

Antes de criar ou clonar um projeto, precisa de gerar uma chave pública. Selecione a opção Not right now. Depois, abra o menu (o botão "hamburger" no canto superior direito), navegue até Settings e aceda à secção Git config.

Na secção "Committer Details", forneça o seu nome de utilizador Git e endereço de email. Estes detalhes associam os seus commits Git à sua identidade. Para consistência, pode escolher Node-RED como nome de utilizador e usar um formato de email como nodered@xxxxx.stackhero-network.com, substituindo xxxxx.stackhero-network.com pelo domínio da sua instância Node-RED.

Painel de configuração GitPainel de configuração Git

Clique no botão Add key, atribua um nome significativo à chave e depois clique em Generate key. Use a opção Copy public key to clipboard para copiar a chave e feche o painel.

Para configurar um repositório remoto, siga estes passos adaptados para o GitHub (passos semelhantes aplicam-se a outras plataformas):

  1. Adicione a chave pública nas definições da plataforma.
  2. Obtenha o URL SSH do seu repositório.

Pode criar um novo repositório ou usar um existente. No GitHub, navegue até ao seu repositório, clique em Settings, depois em Deploy keys, e selecione Add deploy key. Cole a chave pública que copiou anteriormente, atribua-lhe um nome descritivo como "Node-RED", marque a caixa Allow write access e clique em Add key.

Adicionar chave pública no GitHubAdicionar chave pública no GitHub

Volte ao separador Code do seu repositório e copie o URL SSH. Este URL geralmente parece-se com git@github.com:<yourOrganization>/<yourRepositoryName>.git. Para repositórios existentes, clique no botão Clone or download para localizar este URL.

No Node-RED, abra o menu (ícone hamburger no canto superior direito), navegue até Projects e selecione "New".

Escolha Clone Repository e certifique-se de que as suas definições de nome de utilizador e email estão corretas. Cole o URL SSH do seu repositório no campo Git repository URL (por exemplo, git@github.com:<yourOrganization>/<yourRepositoryName>.git) e clique em Clone Project.

Para novos repositórios, o Node-RED pode solicitar que crie ficheiros de projeto padrão. Se solicitado, selecione Create default project file.

O Node-RED oferece uma opção para encriptar os seus ficheiros de credenciais de fluxo antes de os adicionar ao Git. Ativar a encriptação é altamente recomendado para proteger dados sensíveis. Armazene a chave de encriptação de forma segura, pois será necessária para a desencriptação.

Finalmente, clique em Create project files para completar a configuração.

Para orientações mais detalhadas, consulte a documentação oficial do Node-RED sobre Projetos: Documentação de Projetos do Node-RED.

Também pode achar este tutorial em vídeo esclarecedor: Introdução aos Projetos Node-RED (YouTube).