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.
- Como o ambiente possui controle de acesso e HTTPS, é preciso criar dois arquivos no seu diretório pessoal:
- Usuário e senha para autenticação em ~/.netrc.
- Nome completo do usuário, email e permissão de certificado autoassinado em ~/.gitconfig.
- 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
- 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.
- Crie um ou mais arquivos e adicione-os ao controle: git add <arquivo>. Em diretórios, o processo é recursivo.
- Edite os arquivos a vontade, com qualquer editor disponível.
- 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>".
- 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:
- meta1;
- meta2;
- meta3 e
- meta4 serão consideradas versões finais para cada meta correspondente. Na ausência da marcação, a meta não será atingida.
- 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.