Controle de versão

O que é

O controle de versão, também chamado controle de revisão, refere-se ao controle de alterações de documentos, permitindo assim um ambiente para a produção colaborativa de conteúdo. Está presente em várias ferramentas, como por exemplo Microsoft Office (com SharePoint), Google Docs, a plataforma Sharelatex, e até esta página do wiki.

Por ser bastante utilizando no desenvolvimento de sistemas, possui significativa documentação disponível. Entretanto, cabe aqui destacar alguns conceitos importantes:

• Repositório: é o local de armazenamento para onde convergirão as alterações dos documentos. Deve, portanto, possuir um mecanismo para atender operações concorrentes, tratando tais operações ao longo de uma linha temporal. Os documentos em sua versão final são, portanto, o resultado das várias alterações desde a sua criação até o seu estado corrente.
• Versão (ou revisão): é uma alteração de um ou mais documentos a partir do seu estado (versão/revisão) anterior. Por tratar-se de uma ferramenta colaborativa e, portanto, multiusuário, deve registrar informações como:
  • O quê?: o conteúdo da alteração;
  • Quem?: o autor da alteração;
  • Quando?: data e hora para gerar a linha histórica de alterações.
• Linha mestre (trunk ou baseline): linha histórica principal do repositório. Pode haver ramificações, ou variantes da linha principal.
• Ramificação (branch): conjunto de alterações que divergem da linha mestre. Utilizada geralmente para testes e experimentos. Cabe ressaltar que é possível mesclar ramificações, gerando assim novas versões.
• Marcação (tag): uma vez a linha mestre e mesmo as ramificações podem se estender por várias versões, é recomendado marcar pontos ao longo da história dos documentos. Tais pontos auxiliam os editores no controle das alterações, e é comum utilizar um padrão numérico para tal.

Há várias implementações de controle de versão, desde sistemas centralizados como CVS e Subversion até distribuídos como Git, Bazaar e Mercurial. Para este semestre de 2011, foi adotado o Git como ferramenta padrão para os projetos de TCC I. O sistema já está em produção para projetos de pesquisa e trabalhos de conclusão de curso.

Dicionário de operações do Git Hub

O Git possui mais de uma centena de operações para manipular repositórios de arquivos. A seguir, os mais utilizados:

Comando	Descrição	Exemplo de uso
git init	Criação de um novo repositório local.	git init
git checkout	Atualiza os arquivos para uma determinada versão. Pode ser utilizado para verificar se o diretório de trabalho possui alterações não catalogadas (versionadas).	git checkout
git add	Adição de novos arquivos para controle de versão.	git add monografia.tex
git commit	Aplica as últimas alterações no repositório.	git commit -a -m "Revisado o primeiro capítulo."
git tag	Marca uma versão para facilitar a sua localização.	git tag -a v1.0
git log	Lista as versões aplicadas no repositório.	git log
git revert	Pode retroceder na linha histórica de versões, podendo reescrevê-la a partir de um dado ponto.	git revert HEAD~4
git branch	Cria ramos alternativos à linha mestre.	git branch teste
git clone	Copia um repositório remoto para outro, local.	git clone http://servidor/repo
git pull	Sincroniza repositórios (versões) no sentido remoto->local.	git pull
git push	Sincroniza repositórios (versões) no sentido local-> remoto.	git push

Usando pela primeira vez

Um cenário comum é o de múltiplos repositórios. Vamos usar como exemplo o ambiente de projetos de Tele: é criado um repositório remoto vazio para produção colaborativa de conteúdo.

1. Como o ambiente possui controle de acesso e HTTPS, é preciso criar dois arquivos no seu diretório pessoal:
   1. Usuário e senha para autenticação em ~/.netrc.
   2. Nome completo do usuário, email e permissão de certificado autoassinado em ~/.gitconfig.
2. Copiar o repositório remoto: git clone https://tele.sj.ifsc.edu.br/projetos/<nome_do_projeto>. O professor da disciplina de TCC I informará o nome do projeto para cada equipe.

Usando no dia a dia

1. Uma vez que várias pessoas participam dos projetos, é recomendado (porém não obrigatório) sincronizar o repositório local a partir do remoto: git pull.
2. Crie um ou mais arquivos e adicione-os ao controle: git add <arquivo>. Em diretórios, o processo é recursivo.
3. Edite os arquivos a vontade, com qualquer editor disponível.
4. Uma vez que há arquivos modificados (visíveis com o comando: git checkout), pode-se criar versões a partir desse novo conteúdo: git commit -a -m "<mensagem>".
5. Se esta última versão adicionada ao repositório é importante, como a versão final de um documento ou apresentação, é extremamente recomendado marcá-lo para facilitar a sua localização. Para isso, use o comando: git tag -a <tag> -m "<mensagem>". No caso do TCC I, somente as versões marcadas com:
   1. meta1;
   2. meta2;
   3. meta3 e
   4. meta4 serão consideradas versões finais para cada meta correspondente. Na ausência da marcação, a meta não será atingida.
6. Por último, pode-se sincronizar o repositório remoto a partir do local com: git push/tt>. Assim como git pull, esse comando não é obrigatório, mas agilizará na disseminação das versões para todos os colaboradores do projeto. Cabe destacar que se várias pessoas editarem arquivos ao mesmo tempo, haverá uma mescla (merge) do produto final, sem perdas. ATENÇÃO: a primeira que for digitar git push é preciso informar a origem, através do comando:

git push origin master

na primeira vez. Depois, todos os outros pushes se dão apenas com:

git push

Porém, quando houver um commit com marcador associado (tag), esse comando deve adicionar o argumento:

git push --tags

Ferramentas gráficas/Web

Há várias ferramentas gráficas e Web para manipular o repositório, e destacam-se:

• gitk: aplicativo gráfico em Tcl/Tk.
• gitg: aplicativo gráfico para Gnome.
• git-cola: aplicativo gráfico feito em Python.
• gitweb: ambiente Web. Disponível para os professores acompanharem todos os projetos e TCCs.

Referências

• LOELIGER, J. Version Control with Git: Powerful Tools and Techniques for Collaborative Software Development. O'Reilly Media. 2009.
• CHACO, S. Pro Git. Apress. 2009.
• LIVINGSTON-GRAY, S. Think Like (a) Git. Acessado em: 03/11/2011.
• DUDLER, R. git - guia prático. Acessado em 16/11/2015.

Este material foi produzido para a discplina TCC I.