Depois que começamos a programar “de verdade” (corporativamente ou não… rsrs!), percebemos a necessidade de controlar “as versões” do software em questão. Não simplesmente editando e salvando seus ultimos “codes”. É ai que entra o CVS (Concurrent Versions System).

Imagine você terminar aquele projeto/software e no momento da entrega precisar modificar o código, implementar mais alguma função. Tranquilo! Mas depois, percebe que não era bem aquilo que você queria, era melhor deixar do jeito que estava… iii… Neste caso o CVS controla as versões editadas do seu projeto/software permitindo que você possa acessar os antigos códigos. Ótimo!

Outra situação é você desenvolver um software em conjunto com amigos da faculdade e seu “brother” adicionar alguns trechos de códigos “bugados” e ir passear… o que fazer? Ir no CVS e buscar as versões do código antes de seu “brother” ter feito a m*rda! ;)

O que veremos neste post?

- Instalar e configurar o CVS servidor.
- Alguns comando básicos do CVS cliente no próprio linux.

*** Instalando e configurando o CVS

Para este post usei o Debian Lenny. Let´s go…

~$
~$ sudo apt-get install cvs

Depois de instalado o CVS (neste caso ele instala o servidor e cliente), na versão em questão é a 1.12.13 ele cria um repositório padrão em /srv/cvs.

No nosso exemplo vamos apagar o repositório padrão e criar um novo em /home/cvs.

~$
~$ sudo rm -rf /srv

Agora vamos editar o arquivo de configuração principal do cvs: /etc/cvs-pserver.conf

~$
~$ sudo vi /etc/cvs-pserver.conf

CVS_PSERV_REPOS=”/home/cvs”
CVS_PSERV_LIMIT_MEM=hard
CVS_PSERV_LIMIT_DATA=hard
CVS_PSERV_LIMIT_CORE=0
CVS_PSERV_LIMIT_CPU=hard

Neste arquivo modifique a linha CVS_PSERV_REPOS com o diretório do seu repositório de projetos.

Você pode criar mais de um repositório, usando , (vírgula) entre os diretórios:
CVS_PSERV_REPOS=”/home/cvs,/home/meusprojetos”
Neste caso temos 2 repositórios! ;)

Depois de criado o repositório, vamos criar o diretório e efetuar as devidas permissões.

~$
~$ sudo mkdir /home/cvs
~$ sudo chmod -R 775 /home/cvs
~$ sudo chown root:src -R /home/cvs
~$ sudo chmod g+s /home/cvs

1. Criamos o diretório /home/cvs

2. Damos permissão 775 ao diretório do nosso repositório.

3. Setamos o dono root e grupo src para o diretório.

4. Usando o gid bit para o grupo src, assim, todo o usuário do sistema (/etc/passwd) que estiver no grupo src poderão escrever no diretório.

Pronto! Com estas configurações básicas já podemos executar nosso servidor CVS. Mas… o CVS é um serviço que não roda em standalone, assim, ele usa o inetd para executar o serviço. Vamos, então, adicionar as configs do CVS no inetd:

~$
~$ sudo vi /etc/inetd.conf

Adicione a linha abaixo:
cvspserver stream tcp nowait root /usr/sbin/tcpd /usr/sbin/cvs-pserver

~$ sudo /etc/init.d/openbsd-inetd start

Ok! O CVS já está executando via inetd. O CVS usa as portas 2401/tcp e 2401/udp, então – caso necessário -, libere estas portas no seu firewall.

Com o CVS funcionando, vamos criar o base de diretórios e arquivos do nosso repositório em /home/cvs.

~$
~$ cvs -d /home/cvs init

Assim, ele cria o diretório CVSROOT no nosso repositório, contendo as conf necessárias para o mesmo. Vamos ver alguns comandos básicos e como proceder em situações do dia a dia.

Adicionar permissão a um usuário para escrever no repositório:

~$
~$ sudo addgroup usuario src

Conectando remotamente via cvs (no linux/debian):

~$
~$ export CVSROOT=:pserver:usuario@ipdoservidorCVS:/home/cvs
~$ cvs login

Sim, parece estranho. Mas o cliente cvs no linux necessida de uma variável CVSROOT para conectar a um determinado host/servidor. Para simplificar o processo você pode criar a variável CVSROOT no .profile do seu usuário.

Importando um projeto e versionando:

~$
~$ cd /home/bleno/projetos/ListaEncadeada
~$ cvs import ListaEncadeada ProjetoListaEncadeada v1 start

Neste caso, importei o diretório ListaEncadeada usando o nome ProjetoListaEncadeada chamando de versão “v1″. Assim, o diretório local ListaEncadeada foi importado em /home/cvs/ProjetoListaEncadeada no servidor CVS.

O CVS cliente pedirá uma mansagem descritiva sobre seu “import”, você informa a descrição e sai com o um simples :x (by vi editor!).

Vamos supor que depois de 2 dias de trabalho árduo saio a versão “v2″ deste projeto. Para importar a nova versão, conectamos ao servidor CVS como descrito acima e importando a nova versão:

~$
~$ cvs import ListaEncadeada ProjetoListaEncadeada v2

Trabalhando com arquivos no CVS cliente no Linux!

Vamos supor que você está em uma outra máquina e queira um cópia do ProjetoListaEncadeada, simples: conecte-se ao servidor CVS como descrito acima e:

~$
~$ cd /home/outramaquina/projetos
~$ cvs checkout ProjetoListaEncadeada

Assim você tem uma cópia da ultima versão do ProjetoListaEncadeada. Depois de editar o projeto você deseja fazer o upload dos arquivos novos, então:

~$
~$ cvs update

O update faz com que o cvs marque os arquivos locais modificados para depois enviar para o servidor. Depois de marcados com o update:

~$
~$ cvs commit

Pronto, os novos arquivos modificados são enviados para o servidor! Lembre-se que todo o processo usando o CVS cliente deve-se está conectado o CVS servidor.

Suponto que há um novo arquivo “classeNos.java” criado no ProjetoListaEncadeada que você quer adicionar, fazemos:

~$
~$ cvs add classeNos.java

Ah, você lembrou que este novo arquivo não é mais necessário no ProjetoListaEncadeada, fazemos:

~$
~$ rm classeNos.java
~$ cvs remove classeNos.java
~$ cvs commit

Pronto! Desta forma quando alguem que faz parte do ProjetoListaEncadeada der um “checkout” as novas modificações serão replicadas para ele! Rulez!!!

Verificando logs

Conectado ao CVS server via CVS cliente no linux, você pode verificar os logs as versões de um determinado projeto:

~$
~$ cvs log | less

Ele vai mostar o log das ultimas modificações do projeto em questão. O less é para a amostragem ficar mais amigável =)

~$
~$ cvs annotate | less

Mostra as anotações, linha a linha, com detalhes sobre o usuário e data das modificações. Por exemplo, você quer saber quem modificou codificou em 26 de agosto na versão v2 do ProjetoListaEncadeada:

~$
~$ cvs annotade | grep v1 | grep “26-Aug-09″

Ai vai a sua criatividade para filtrar a pesquisa do log.

Para mais comandos do CVS cliente no linux:

~$
~$ cvs –help-commands

Realmente o CVS é show de bola. Atualmente existe o SVN que o Dr. Google utiliza no code.google.com, mas sinceramente, não me adaptei bem (rsrs!). Em breve um post sobre SVN! ;)