Dominando Controle de Versão: Guia Prático de Git e GitHub para Desenvolvedores

A vida de programador já é difícil o suficiente. Por que não facilitar e terceirizar o controle de versão dos seus projetos para serviços dedicados? A maioria dos programadores de TI conhece Git, mas para alguns programadores de OT desta comunidade, é conceito novo. Trabalhando com colegas no mesmo projeto, compartilhar código vira dor de cabeça; um serviço como GitHub facilita compartilhar e trabalhar juntos no mesmo código. Este blog guia seus primeiros passos usando Git e GitHub para manter seu código e projetos organizados.

---

Neste blog uso GitHub e o cliente GitHub para Windows, mas há mais opções incluindo GitLab. Gosto da facilidade de uso do GitHub Client!

---

Configurando repositório no GitHub

Passo 1 – Baixar e instalar GitHub Client para Windows

Na verdade, o primeiro passo seria criar conta no GitHub, mas isso foge do escopo deste blog.

1. Cliente pode ser baixado aqui.
2. Siga o Guia de Instalação
3. Faça login na sua conta GitHub

Passo 2 – Criar pasta ou repositório para seu projeto

Um repositório é onde seu projeto vive. Crie uma pasta para cada projeto! Toda vez que algo muda nesta pasta, o cliente GitHub detecta e você poderá salvar ou enviar suas alterações para o repositório online no GitHub.

1. Clique em "Create a New Repository on your hard drive..."
2. Dê nome e descrição ao novo repositório.
3. Pode alterar o caminho do repositório ou deixar padrão.
4. Marque "Initialize this repository with a README" (preguiça não significa não seguir boas práticas e documentar seu código!)
5. Crie o repositório

Passo 3 – Criar Projeto PLCnext

Git funciona bem com arquivos baseados em texto. Felizmente no PLCnext Engineer há opção de salvar projeto como muitos arquivos de texto, perfeito para Git e nosso cliente GitHub!

1. Abra PLCnext Engineer e crie projeto como de costume.
2. Quando pronto para salvar, escolha Save Project As (F12)
3. Navegue até seu repositório GitHub (padrão: This PC/documents/GitHub)
4. Salve seu projeto como "Uncompressed Project"

Passo 4 – Commit suas alterações

Para "salvar" alterações no repositório, você precisa fazer commit em um branch. O que exatamente é branch explico depois; por enquanto, lembre que precisa commitar alterações a um branch para salvá-las.

Dê ao commit um título novo e descrição curta para lembrar o que mudou!

Passo 5 – Publicar ou Push seu repositório

O passo final para criar repositório online é enviar nosso repositório local para GitHub. Tão fácil quanto apertar botão ou Ctrl+P. Escolha se código deve ser privado e se pertence a você ou organização.

Passo 6 – Documentar!

Pressione (Ctrl + Shift + G) para ver o repositório online no GitHub no navegador. Lá está seu Projeto PLCnext no GitHub. Lembra do "Initialize README"? É o texto que você vê agora. No README.md explique a estrutura do projeto, propósito e talvez informações de contato para referência futura.

Faça alterações no README.md clicando no lápis. O arquivo é "escrito" em MarkDown, mais info aqui.

Se fez alterações, novamente commit no branch master!

Passo 7 – Pull alterações para seu repositório local

O Cliente Windows detectará que alterações foram feitas no Repositório no GitHub. Não esqueça de pull para trabalhar na versão mais recente!

---

Dicas & Truques

Issue Tracker

GitHub tem um ótimo issue tracker, use para rastrear issues conhecidos no software e discutir soluções com stakeholders.

Projects

Use o Project Board integrado para acompanhar tarefas com kanban. Se quiser, pode automatizar seu kanban com triggers integrados.

Branches

Ah, aqui estamos. Disse que explicaria o que são branches! Bem, deixo o GitHub explicar...

Vai fazer muitas mudanças ou implementar nova feature? Crie branch para isolar suas mudanças e faça merge do "feature branch" no master via pull request.

Release

Pronto para deploy? Crie release para adicionar ao seu AS Build!