Versionando seu projeto Node-RED

Diego Telles
Diego Telles
Published in
4 min readJun 17, 2019
.git

Muito se falava antigamente sobre “COMO VOU TRABALHAR COM UM TIME NESSA FERRAMENTA?”.

Bom, graças ao update da versão 0.18.0 temos o poder de trabalhar com o git em nossos projetos, essa feature foi criada com o nome de Projects, nela temos o poder de gerenciar diversos projetos em um ambiente e também nos possibilita a trabalhar usando o Git flow.

Mas para habilitar essa função vamos ter que alterar algumas configurações do seu Node-RED, sega esses passos a baixo:

Habilitando o Projects:

Primeiro precisamos saber onde está o arquivo que vamos configurar, assim que damos start no nosso Node-RED ele apresenta vários logs e vai ser aqui que vamos achar o nosso settings.js :

Para habilitar o Project’s, habilite ele no settings.js, vá até o trecho do module.exports coloque essas configurações e reinicie seu Node-RED.

Abra o arquivo em um editor de sua preferencia, eu uso o VS Code:

> code/Users/diegotelles/.node-red/settings.js

Após ter feito isso você vai abrir esse arquivo em seu editor de texto.

Vá até a linha com esse código:

Veja que onde está com a flag de false, vai ser aqui que vamos alterar para true.

Feito isso reinicie o Node-RED, assim que entrarmos na aplicação teremos a seguinte informação:

Aqui você tem 2 opções:

  • Criar um novo projeto
  • Clonar um Repositório já existente

Vamos ver um pouco de cada uma delas.

Create Project

Aqui nessa opção temos a possibilidade de criar um novo projeto e colocar suas configs do git (Username e email). Assim como fazemos via CLI para passar as configs de usuário, mas como o nosso Node-RED é visual evitamos isso. =D

Logo em seguida temos o seguinte passo:

Passo 2: Create Project

Informamos o nome do projeto e uma Descrição, que é opcional.

No proximo passo:

Passo 3: criar nosso arquivo flow

Nesse passo, vamos informar qual vai ser o nome do nosso arquivo flow, como trabalhamos com json no Node-RED, vamos setar o nome que queremos em seguida .json na sua extensão.

Nesse ultimo e importante passo, podemos setar qual o tipo de credencial de acesso para esse projeto, ou até mesmo deixar sem nenhuma.

4º e Ultimo passo: Create Project

Feito isso é so começar a desenvolver!

Clone Repository

Quando vamos clonar um repositório, imaginamos ja ter algo desenvolvido e commitado em seu git ou em outro repositório.

Aqui teremos as seguintes informações:

Passo 1: Clone Repository

Primeiro vamos Configurar nosso git, como no passo de Criação de projetos, afinal esse passo é fundamental.

No nosso proximo e ultimo passo vamos ter que passar o nome do projeto (como queremos chamar ele), seguido das informações da URL do repositório e da credencial que foi configurada(ou não). Em seguida sá clonar e continuar o desenvolvimento.

Clonar projeto

Obs. Para clonar um repositório, o mesmo tem que ser um repositório de fluxos do Node-Red, caso tente clonar um repositório comum a ferramenta bloqueará esse processo até que você informe um repositório correto.

Menu Project

Uma das novidades do projects é que após você realizar todas essas configurações você pode criar, abrir e até configurar novos projetos com facilidade usando o menu da plataforma:

Menu Projects

Repetindo os passos acima logo após clicar em New.

Depois de configurar todos esses passo, temos aqui na nossa aba lateral a opção de versionamento:

Sempre que você alterar um arquivo de projeto, por exemplo, implantando uma nova configuração de fluxo, ele será listado na seção “Local changes”. Você pode clicar no nome do arquivo para ver uma comparação do que foi alterado. Ao passar o cursor do mouse sobre o arquivo, você verá um botão “+” que clicará no arquivo, movendo-o para a lista “Alterações para confirmar”.

Quando você tiver preparado os arquivos que deseja confirmar, clique no botão de confirmação, insira uma mensagem e confirme.

Com isso temos também o histórico de commits feitos nessa branch do repositório, caso precise dar rollback ou até mesmo consultar o que ja foi realizado em algum momento.

Bom, pessoal espero que tenham curtido e que tirem suas duvidas sobre trabalhar com versionamento.

Qualquer duvida podem publicar nos comentários que responderei assim que possível, abraços.

--

--

Diego Telles
Diego Telles

Pós-graduando em IA, exp. em NodeJs e IoT, palestrante, voluntário na Mozilla e fundador da @JScriptWorld e @NodeREDBrasil .