curso de controle de versão

8/6/2019 curso de controle de verso

1/100

Sistema de Controle de Verso

Marcelo de Gomensoro [email protected]

UNIVATES


2/100

Sistema de Controle de Verso V SDSL


Roteiro do minicurso


3/100



Parte I: Importncia

Conceitos bsicos Ferramenta CVS:

Montando um repositrio local

Operaes avanadas Montando um repositrio remoto Limitaes


4/100



Parte II: Ferramenta Subversion:

Montando um repositrio local Branching Montando um repositrio remoto

Outros sistemas Desenvolvimento cooperativo Mais fontes de informao


5/100



Importncia


6/100


Motivao

Permitir que qualquer alterao feita em umconjunto de cdigos-fonte seja controlada edocumentada, criando um histrico demodificaes e tambm impondo um

mecanismo de controle de acesso


7/100


Importncia de controlar verses

Possibilitar compartilhamento de cdigo-fonte e desenvolvimento distribudo

Permitir controle de modificaes e trabalhoem paralelo Auxiliar na qualidade do cdigo e em sua

manuteno Atrair novos colaboradores para projetos

abertos e expor sua evoluo


8/100


Controle de verso em outras reas

Histrico de modificaes em documentosde texto (wikis)

Configuraes de um sistema computacional(snapshotsouprofiles): gerenciamento deconfiguraes de software (SCM)

Alterao de desenhos feitos em CAD Protocolos de comunicao Interfaces de programao (APIs)


9/100



Conceitos bsicos


10/100


Conceitos bsicos

Verso:Genericamente, o nome atribudo a um estado ou

contedo de um objeto em uma cadeia demudanas

Especificamente, indica um marcador (checkpoint)na evoluo ou desenvolvimento de um sistemacomputacional


11/100


Conceitos bsicos

Verses so tradicionalmente usadas pelaEngenharia de Software para indicarmudanas em programas

Tipos de verses: Simples: 10, 2003 Compostas: 0.9, 1.0rc1, 1.2.0, 2.6.11.354

major.minor[.micro[.build]] Datas: 20050720 Cdigos: XP, MX, CS


12/100


Conceitos bsicos

Reviso:Numerao incremental que especfica a um

componente de um software, normalmente semrelao direta com a verso global do mesmo

Tambm chamado de nmero de reviso ou nvelde reviso

1.1 1.2 1.3


13/100


Conceitos bsicos

Sistema de controle de verso (SCV):Ferramenta automatizada para atribuio e

gerenciamento de revises de componentes deum software

Normalmente o controle feito individualmentepara cada arquivo de cdigo-fonte

Permite disciplinar o acesso para edio destescomponentes


14/100


Conceitos bsicos

Funcionalidades de um SCV: Monitorar e registrar todas as alteraes em um

ou mais arquivos Permitir que as alteraes possam ser

examinadas individualmente e revertidas casonecessrio

Possibilita que a imagem de um arquivo possa

ser obtida para qualquer instante de sua histria Permite que vrios programadores trabalhem

simultaneamente sobre os arquivos


15/100


Conceitos bsicos

Caractersticas de um SCV: Pode ser centralizado ou no, onde as alteraes

sempre passam por um servidor central Pode permitir somente armazenamento de

arquivos texto ou tambm de binrios Pode implementar mecanismo de lockingpara

evitar acessos simultneos ou mergingpara

possibilitar edio concorrente Pode dispor ou no de autenticao e controle de

acesso


16/100


Terminologia

Repositrio:Local onde so armazenados os arquivos mantidos

sob controle de verso

rea de trabalho:Cpia local dos arquivos de um repositrio, utilizada

para o desenvolvimento propriamente dito

Mdulo ou projeto:Conjunto independente de arquivos; normalmente

um repositrio constitudo de muitos mdulos


17/100


Operaes fundamentais

Check-out:Operao inicial de criar uma rea de trabalho a

partir de um mdulo do repositrioUpdate:

Operao que atualiza a cpia local com eventuaismudanas ocorridas no repositrio

Commit:Operao de efetuar mudanas em um repositrio,

tambm chamada de check-in


18/100



Ferramenta CVS


19/100


Ferramenta CVS

Abreviao de Concurrent Versions System Iniciado em 1986, tomou sua forma atual a

partir de 1989 Herda caractersticas do programa RCS o sistema de controle de verso mais

usado no desenvolvimento de Software Livre Hoje usado nos maiores projetos de SL Verso atual: 1.11.20


20/100


Ferramenta CVS

Caractersticas: um sistema centralizado O repositrio pode ser local ou remoto O acesso ao repositrio nunca direto, mas feito

atravs de ferramentas do pacote CVS As revises sempre comeam em 1.1 Permite fazer tanto lockingquanto merging Permite atribuir rtulos (tags) Possibilita criar ramificaes (branches)


21/100


Ferramenta CVS

Principais vantagens: um sistema maduro e bem testado amplamente documentado o sistema em maior utilizao hoje, dispondo de

um grande nmero de ferramentas de apoio Est integrado nativamente com os principais

ambientes de desenvolvimento (IDEs) Permite execuo de check-outssem restries,

reduzindo a necessidade de locking, para isso seapoiando na capacidade de fazer merging


22/100


Usando o CVS

Foco inicial: uso das ferramentas de linha decomando programa cvs

A localizao do repositrio sempreindicada pela varivel $CVSROOT ou pelaopo -d


23/100


Estrutura de um repositrio

/usr/local/cvsroot/CVSROOT/gnu/

hello.c,vteste.txt,v

meta/Attic/help.php,v


24/100


Estrutura de uma rea de trabalho

/home/mgm/devel/gnu/

CVS/EntriesRepositoryRoot

hello.cteste.txt


25/100


Principais comandos

checkout: obter uma cpia de um mdulopara a rea de trabalho local

commit: enviar as alteraes da cpia localpara o repositrio update: atualizar a cpia local com eventuais

mudanas do repositrio add/remove: adicionar e remover arquivos

de um mdulo


26/100


Principais comandos

Ajuda do programa cvs: cvs --help: ajuda geral

cvs --help-commands: lista de comandos cvs --help-options: lista de opes cvs -H : opes do comando

especificado


27/100


Ferramenta CVS



28/100



Definir a localizao e criar um repositrio Criar e importar um mdulo

Fazer um checkout Efetuar alteraes nos fontes Fazer um commit

Atualizar rea de trabalho e ver alteraes Adicionar e remover arquivos


29/100


Definindo e inicializando

Defina a localizao do repositrio:$ export CVSROOT=~/cvs

Inicialize o repositrio:$ cvs init

Nota: este diretrio deve ter permisso deleitura e escrita por todos que tero acesso

ao CVS


30/100


Criando um mdulo simples

Crie um diretrio temporrio:$ mkdir ~/temp

Crie dentro dele um arquivo texto:$ printf "um\ndois\ntrs\n" > ~/temp/teste.txt


31/100


Importando arquivos

V at o diretrio que contm os arquivos aserem importados:$ cd ~/temp

Importe todos os arquivos e diretriospresentes no mdulo gnu:$ cvs import -m "Importao" gnu gnu start

A opo -m indica a mensagem a serregistrada para a operao de importao

A palavra start indica um release


32/100


Criando uma rea de trabalho

Crie um diretrio base para sua cpia local:$ mkdir ~/devel

Faa um checkoutdo mdulo gnu nestediretrio:$ cd ~/devel$ cvs checkout gnu

cvs checkout: Updating gnuU gnu/teste.txt


33/100


Editando o mdulo

Entre no diretrio gnu e edite o arquivoteste.txt, adicionando a palavra quatro:$ cd gnu$ lsCVS teste.txt$ vi teste.txt


34/100


Enviando as alteraes

Faa um commit, especificando umamensagem para ser includa no histrico:$ cvs commit -m "atualizao"cvs commit: Examining .Checking in teste.txt; /home/mgm/cvs/gnu/teste.txt,v


35/100


Obtendo atualizaes

Faa um update, na rea de trabalho:$ cvs updatecvs update: Updating .

Modifique novamente o arquivo teste.txt, agoraremovendo a palavra trs:$ vi teste.txt

$ cvs updatecvs update: Updating .M teste.txt


36/100


Verificando alteraes

Faa um diff, entre o repositrio e a rea local:$ cvs diff -u

O resultado deste comando a comparaolinha-a-linha entre os arquivos mais recentesdo mdulo e a sua rea de trabalho

A opo -u indica um tipo de diffbastante

legvel, sendo o mais usado em SoftwareLivre para a divulgao de patches, tambmchamado de diffunificado


37/100


Adicionando fontes

Crie dois novos arquivos, arq1 e arq2:$ cp teste.txt arq1; cp teste.txt arq2

Remova o arquivo teste.txt, para que sejamrevertidas as mudanas feitas antes:$ rm teste.txt

Faa um updatee analise sua sada:

$ cvs updateSolicite a incluso dos dois novos arquivos:

$ cvs add arq1 arq2


38/100


Adicionando fontes

Faa outro update:$ cvs update

Adicione definitivamente os arquivos aorepositrio com um commit, agora semespecificar uma mensagem:$ cvs commit

Ser aberto o editor de texto padro, solicitandoa mensagem a ser armazenada


39/100


Removendo fontes

Remova o arquivo arq2 e depois use ocomando removepara sinalizar a remoo:$ rm arq2

$ cvs remove arq2$ cvs update

Remova definitivamente o arquivo dorepositrio com o comando commit:$ cvs commit -m "Remoo"


40/100


Ferramenta CVS

Operaes avanadas


41/100


Operaes avanadas

Configurao Comportamento recursivo

Substituio de keywords Arquivos binrios Arquivos temporrios

Exibindo e definindo tags Obtendo e efetuando alteraes


42/100


Operaes avanadas

Outros comandos Alterao manual do repositrio

Branching


43/100


Configurao

As opes defaultpara os comandos do CVSso colocadas no arquivo ~/.cvsrc

Exemplo:cvs -z3diff -uupdate -d -P

Neste caso: usar compresso em nvel 3, usartipo -u para o diffe fazer criao e remooautomtica de diretrios quando do update


44/100


Comportamento recursivo

Por defaulttodos os comandos do CVSoperam recursivamente:$ cvs commit

Contudo estes tambm podem ser chamadospara um ou mais arquivos separadamente:$ cvs commit arq1


45/100


Substituio de keywords

O CVS capaz de manter atualizadasautomaticamente diversas informaessobre o fonte, quando feito um update

As seguintes keywordsso sempreexpandidas:

$Author$, $Date$, $Header$, $Id$, $Name$,

$Locker$, $Log$, $RCSfile$, $Revision$,$Source$, $State$$Id: samp.c,v 1.5 1993/10/19 14:57:32 ceder Exp $


46/100


Arquivos binrios

Devem ser adicionados com a opo -kb docomando add:$ cvs add -kb imagem.gif

Nos arquivos de configurao do repositrio(no diretrio CVSROOT) existe o arquivocvswrappers que pode definir que tipo dearquivos so binrios por default:*.gif -kb*.jpg -kb


47/100


Arquivos temporrios

Alguns tipos de arquivos temporrios soautomaticamente ignorados pelo CVS, nofazendo parte do repositrio:

CVS, core, *~, *.bak, *.old, *.o, *.a, ...Ainda possvel definir padres de nomes

para serem ignorados:

via varivel de ambiente $CVSIGNORE em arquivos .cvsignore, no homedo usurio

ou em cada diretrio do projeto


48/100


Exibindo e definindo tags

Exibir dados de um arquivo, indicando averso de trabalho, a verso do repositrio eas tagsassociadas:

$ cvs status -v teste.txtDefinir uma tagpara um arquivo:

$ cvs tag dia-16 teste.txt

Definir uma tagpara um mdulo inteiro(chamada de release):$ cvs rtag release-0-0 gnu


49/100


Obtendo e efetuando alteraes

Obtendo alteraes entre verses:$ cvs diff -r start$ cvs diff -r 1.1 -r 1.2

Obtendo alteraes entre releasesde umprojeto inteiro:$ cvs rdiff -r VER1 -r VER2 prog

Aplicando um patch:$ patch -p1 < changes.diff


50/100


Outros comandos

Alteraes linha-a-linha:$ cvs annotate teste.txt

Histrico de acessos ao repositrio:$ cvs history

Registro de alteraes de cada arquivo:$ cvs log teste.txt


51/100


Conflitos

Quando um updatetraz atualizaes dorepositrio para um trecho de cdigo que jfoi alterado, pode ocorrer um conflito

Esse conflito sinalizado com a letra C e deveser resolvido manualmente pelo usurioantes de um prximo commit:

$ cvs updatecvs update: Updating .C driver.c


52/100


Conflitos

Exemplo de cdigo alterado para sinalizar umconflito:

fprintf(stderr, "No code generated.\n");

> 1.6}


53/100


Alterao manual do repositrio

Em algumas situaes prefervel alterarmanualmente o repositrio, ao invs deutilizar os comandos adde remove:

para mover diretrios e preservar seucontedo inalterado

para mover arquivos e manter seu histrico

para remover arquivos e diretriosdefinitivamente do CVS, inclusive com seushistricos


54/100


Branching

O CVS implementa um mecanismo complexopara manter mltiplos releasesde ummesmo projeto:

1.0 1.1 1.2

1.1.1 1.1.2


55/100


Ferramenta CVS

Montando um repositrio remoto


56/100



O servidor CVS precisa rodar como umservio do inetd:

cvspserver stream tcp nowait root

/usr/bin/cvs cvs -f --allow-root=/home/cvs pserver

importante criar um usurio cvs prprio parao CVS, que seja dono do repositrio etambm o usurio sob o qual ir rodar oservidor


57/100



O arquivo de configurao passwd permitedefinir usurios com senhas para o acesso:job:kfeIWZpz58xOI:cvs

mgm:AAqo55sskNRpI:cvsO acesso deve ser feito via comando login:

export CVSROOT=:pserver:[email protected]:/cvscvs login

O resto da utilizao idntica a umrepositrio local


58/100


Ferramenta CVS

Limitaes do CVS

d C S


59/100


Limitaes do CVS

Alterar nome, copiar ou mover arquivosexige operaes especiais para preservar ohistrico

No h versionamento para diretrios Commitsno so operaes atmicas Arquivos binrios exigem cuidados

especiais; todas as revises so mantidasintegralmente

Li i d CVS


60/100


Limitaes do CVS

Numerao de revises complexa No h suporte para linkssimblicos Branching uma operao complicada e

demorada Diferenas so transmitidas somente entre o

servidor e o cliente O protocolo defaultdo CVS no seguro Servidor pserver depende do inetd

Si d C l d V


61/100



Ferramenta Subversion

F t S b i


62/100



Projeto livre mantido pela CollabNet Iniciado em 2000 Tenta aprimorar o CVS e remover suas

limitaes, contudo seguindo os mesmosprincpios bsicos

o provvel substituto do CVS em projetos

de Software Livre Verso atual: 1.2.1

F t S b i


63/100



Caractersticas: um sistema centralizado O repositrio pode ser local ou remoto O acesso ao repositrio feito indiretamente Permite fazer tanto lockingquanto merging Permite atribuir rtulos (tags) Possibilita criar ramificaes (branches)


64/100



65/100



Principais vantagens: Permite alterar nome, copiar ou mover arquivos

preservando seu histrico

Faz versionamento para diretrios Commitsso operaes atmicas Arquivos binrios so tratados automaticamente e

apenas as diferenas so armazenadas

Suporta linkssimblicos Branching simples e eficiente Marcao de tags rpida



66/100



Principais vantagens: Muitas operaes so feitas apenas localmente Diferenas so transmitidas nos dois sentidos

entre cliente e servidor Utiliza protocolos seguros e pode ser roteado

atravs de SSH Permite acesso remoto atravs de WebDAV,

sendo integrado ao Apache Servidor defaultpode ser independente oudepender do inetd

Usando o Subversion


67/100


Usando o Subversion

Foco inicial: uso das ferramentas de linha decomando programa svn

Programa svnadmin: gerenciamento do

repositrio A localizao do repositrio sempre

indicada por uma URL:

Apache: http://...Servidor prprio: svn://...Repositrio local: file://...



68/100



/home/mgm/devel/gnu/

.svn/...hello.cteste.txt


69/100

Principais comandos


70/100


Principais comandos

import: importar para o repositrio umarvore de diretrios sem versionamento

info: exibir informaes sobre o repositrio

ou arquivo especificado diff: exibe alteraes entre um arquivo e

revises anteriores

status: exibe o estado atual de cada arquivo,sem alterar a rea de trabalho ou orepositrio

Principais comandos


71/100


Principais comandos

Ajuda do programa svn: svn --version: exibe a configurao atual e o

suporte a protocolos de acesso svn help: ajuda geral svn help : ajuda do comando

especificado



72/100






73/100



Criar um repositrio e importar um conjuntode diretrios

Fazer um checkout Efetuar alteraes nos fontes Fazer um commit Atualizar rea de trabalho e ver alteraes Adicionar e remover arquivos


74/100

Importando


75/100


Importando

Importe todos os arquivos e diretriospresentes no diretrio temporrio$ svn import ~/temp2 file:///$HOME/subversion -m

"Importao"A opo -m indica a mensagem a serregistrada para a operao de importao

Agora verifique a importao:$ svn list --verbose file:///$HOME/subversion



76/100



Crie um diretrio base para sua rea:$ mkdir ~/devel

Faa um checkoutdo diretrio projeto/trunk do

repositrio para esta rea:$ cd ~/devel$ svn checkout

file:///$HOME/subversion/projeto/trunk projeto

A projeto/teste.txtChecked out revision 1.


77/100

Enviando as alteraes


78/100


Faa um commit, especificando umamensagem para ser includa no histrico:$ svn commit -m "atualizao"

Sending teste.txtTransmitting file data .Committed revision 2.

Verifique novamente o estado do arquivo:

$ svn status

Verificando alteraes


79/100


Modifique novamente o arquivo teste.txt, agoraremovendo a palavra trs.

Faa um diff, entre o repositrio e a rea local:

$ svn diffCheque as informaes sobre o arquivo:

$ svn info teste.txtReverta o arquivo ao estado original no repositrio:

$ svn revert teste.txt$ svn status

Operao desconectada


80/100


p

O Subversion mantm uma cpia localescondida de cada arquivo tal como trazidoda ltima vez do repositrio

Isso permite que os comandos status, differevert possam ser executados sem que sejanecessria conexo com o repositrio

Manipulando arquivos


81/100


p q

A adio e a remoo de arquivos funciona deforma anloga ao CVS, utilizando oscomandos add e remove

Arquivos e diretrios tambm podem sercopiados, movidos e renomeados,preservando seu o histrico:$ svn copy teste.txt teste2.txt$ svn rename teste.txt teste1.txt$ svn status



82/100


Branching

Branching


83/100


Branching a ramificao dodesenvolvimento

No Subversion feito como uma cpia

eficiente de arquivos e diretrios

Branching


84/100


O diretrio trunk a base

O diretrio

branchescontmas vriasramificaes

O diretrio tagscontm novosreleases

Branching


85/100


Exemplo de branching:$ svn copy http://svn.example.com/calc/trunk \

http://svn.example.com/calc/branches/my-calc

Migrando alteraes de trunk para my-calc:$ svn merge -r 343:344 \

http://svn.example.com/repos/calc/trunk Criando uma tagchamada release-1.0:

$ svn copy http://svn.example.com/calc/trunk \http://svn.example.com/calc/tags/release-1.0



86/100





87/100


Um repositrio pode ser montado usando WebDAVcom o Apache ou com um servidor prprio

No caso de um servidor prprio, basta rodar oprograma svnserve no maquina remota com osparmetros adequados:

$ svnserve -d -r ~/subversionO acesso na mquina local ento ser atravs de uma

URL especfica:$ svn checkout svn:///projeto/trunk projeto



88/100


Outros sistemas

Outros sistemas


89/100


Sistemas centralizados (livres): Vesta Superversion (Java)

Stellation (Eclipse) Meta-CVS jedivcs (Delphi) /BriefCase

Outros sistemas


90/100


Sistemas distribudos (livres): GNU Arch / Bazaar ArX

Monotone Cogito (Linux kernel) Mercurial Codeville

Darcs SVK (sobre o Subversion) Aegis

Outros sistemas


91/100


Sistemas comerciais: Razor AccuRev

BitKeeper IBM/Rational Software ClearCase Perforce SCCS (anos 70)

Borland Starteam Microsoft Visual SourceSafe TeamWare



92/100


Desenvolvimento cooperativo



93/100


Poltica de commitdo projeto: Definir quem, quando e como Cada grupo de commitsdeve ser

documentado Uso de um ou mais ChangeLogs Notificao de alteraes por e-mail: lista

especfica para desenvolvedores Acesso de escrita restrito



94/100


ChangeLog:

Mon Jul 7 11:37:43 2003 Marcelo Malheiros

* www/document/put.php: added missing translation

Sun Jul 6 21:27:38 2003 Marcelo Malheiros

* schema.sql: added quotes to function declaration for

compatibility

* www/user/list.php: added missing database translation

* www/cron/all.php: force change to script directory



95/100


Como organizar um repositrio? criar um ou mais diretrios de alto nvel por projeto

Como organizar os fontes em um projeto? seguir a estrutura dada porGNU Autotools


96/100



97/100


Como obter um servidor para um projeto?http://www.codigolivre.org.br/http://incubadora.fapesp.br/

http://colaborar.softwarelivre.gov.br/

http://www.sourceforge.net/http://savannah.gnu.org/

http://www.berlios.de/http://www.tigris.org/http://dev.java.net/



98/100


Mais fontes de informao

Mais fontes de informao


99/100


http://www.cvshome.org/http://focalinux.cipsga.org.br/guia/avancado/ch-s-cvs.htmhttp://www.gnu.org/manual/cvs/http://cvsbook.red-bean.com/

http://subversion.tigris.org/http://svnbook.red-bean.com/

http://en.wikipedia.org/wiki/Version_control

http://en.wikipedia.org/wiki/List_of_revision_control_softwarehttp://www.mhavila.com.br/link/prog/tool/control.htmlhttp://sources.redhat.com/autobook/

FIM


100/100


Marcelo de Gomensoro [email protected]

curso de controle de versão

Documents