Manual de Utilizao

do TortoiseSvn

Maro de

2011

ndice
OBJETIVO___________________________________________________________________________________________________3
INSTALADORES____________________________________________________________________________________________3
DIRETRIOS________________________________________________________________________________________________3
DIRETRIO DO REPOSITRIO___________________________________________________________________________________3
DIRETRIO DO PROJETO_______________________________________________________________________________________4
DIRETRIO TRUNK___________________________________________________________________________________________4
CONECTANDO AO SVN_____________________________________________________________________________________5
SEGURANA E AUTENTICAO____________________________________________________________________________5
FONTES_____________________________________________________________________________________________________7
BLOQUEANDO ARQUIVO___________________________________________________________________________________7
EDITANDO ARQUIVOS______________________________________________________________________________________7
COMMIT____________________________________________________________________________________________________8
VISUALIZANDO LOG_______________________________________________________________________________________9
FLUXO DO PROCESSO____________________________________________________________________________________10
DETALHES
DETALHES

DO
DO

PROCESSO
PROCESSO

DE
DE

DESENVOLVIMENTO_________________________________________________________________10
PUBLICAO_______________________________________________________________________10

TortoiseSVN
Clientes de Subversion para Windows
Objetivo
Esse manual ir auxiliar os colaboradores a utilizarem o TortoiseSVN, cliente de subversion para Windows.

Instaladores
Primeiramente precisamos instalar o Tortoise. Os instaladores podem ser encontrados no diretrio abaixo e so os
seguintes:
\\databnuad01\Instaladores\Tortoise

A instalao simples e pode ser feita pelo prprio usurio do Tortoise. Acima, esto os arquivos utilizados como
cliente SVN para os projetos que se fizerem necessrio:

O primeiro arquivo um plugin para PL/SQL Developer;

O segundo o Tortoise para Windows 32Bits (esse aplicativo no compatvel com
plataformas 64 bits);
O terceiro o Tortoise para Windows 64Bits;

O procedimento de instalao no possui nenhuma particularidade que deva ser documentada. Basta seguir o roteiro
de instalao (Next, Next.......Finish!).
Ao fim da instalao, reinicie seu computador.

Diretrios
Na mquina cliente ser necessrio criar uma estrutura bsica de diretrios para que seja possvel gerenciar os
arquivos baixados do controlador de verso.

Diretrio do Repositrio
Dever ser criado no C:\ da mquina um diretrio onde ficaro os projetos baixados do SVN.

Esse diretrio ser a raiz do repositrio do SVN na mquina cliente.

Diretrio do Projeto
Como padro, para cada projeto, dever ser criado um diretrio com o nome do projeto (o mesmo nome definido no
Visual SVN Server).

Diretrio TRUNK
Esse o diretrio onde sero baixados os fontes e arquivos do nosso projeto. O nome desse diretrio
obrigatoriamente deve ser o definido na imagem abaixo:

Conectando ao SVN
Clicando com o boto direito do mouse no diretrio trunk, selecione a opo SVN Checkout. Ser apresentada a
tela onde devero ser preenchidos os campos abaixo, conforme imagem:

A URL do repositrio : https://192.168.0.7:8443/svn/ServiceTI/trunk

Segurana e Autenticao
Depois de criado o repositrio e realizado o Checkout, ser estabelecida a conexo com o servidor de controlador de
verso. A imagem abaixo ir apresentar uma mensagem, solicitando a aceitao do certificado de segurana
estabelecido para a conexo, visto que a mesma uma conexo segura (protocolo HTTPS).
Nessa janela, dever ser escolhida a opo Accept Permanently.

Depois de aceito o certificado de segurana, ser solicitado o usurio e senha para autenticao com o servidor. Essa
informao esta sincronizada com o controlador de domnios da Datainfo (databnuad01), nesse caso, deve-se
informar o mesmo usurio/senha de rede (ou e-mail).

A tela abaixo apresenta os arquivos que esto sendo baixados para o repositrio criado na mquina cliente. Aguarde
enquanto os arquivos so baixados.

Fontes
Temos abaixo todos os fontes baixados, o sinal de certo em verde representa que nesses fontes no existe nenhum
que foi alterado.

Bloqueando Arquivo
Sempre que for mexer em um arquivo, use a funo SVN Get Lock para que outro usurio no consiga dar commit
(gravar a alterao no servidor) do mesmo fonte, evitando assim conflitos de fontes. Isso preciso, pois como
estamos trabalhando com arquivos binrios, no temos a opo de MERGE.

Editando Arquivos
Para exemplificar a funcionalidade do controlador de verso, foi aberto um arquivo texto com extenso .tgr e nele foi
adicionada uma nova linha, conforme imagem abaixo. O arquivo depois de editado foi salvo. O TortoiseSVN aps
identificar uma alterao no arquivo, marca o arquivo com um cone em vermelho (exclamao), representando a
necessidade de realizar um commit do mesmo.

Commit
Para gravar a alterao no servidor, devemos comit-la. Para isso, com o boto direito do mouse sobre o arquivo
alterado, seleciona a opo SVN Commit.

A opo SVN Commit ir exibir a tela abaixo, permitindo-nos, adicionar um comentrio verso que estamos
comitando. Esse comentrio extremamente importante e obrigatrio. Atravs dele, poderemos gerenciar as
melhorias e manutenes realizadas nos arquivos.

Na prxima imagem podemos ver o nmero da verso gerada para o arquivo que acabamos de comitar.

Visualizando LOG
Para visualizar quem foi o ltimo usurio que alterou o arquivo boto direito no arquivo, TortoiseSVN -> Show
Log.

Abaixo temos a tela com o Log do arquivo.

Fluxo do Processo
Abaixo segue imagem e descrio do fluxo do processo de controle de verso.

Detalhes do Processo de Desenvolvimento

1. Desenvolvedor se conecta ao controlador de verso e sincroniza a verso mais recente do arquivo que vai
trabalhar;
2. Realiza as alteraes necessrias no arquivo;
3. Utilizando-se de um software, seleciona o arquivo que deseja enviar para o servidor (Webmin);
4. Realiza os teste da alterao feita, caso aprovada segue seno repete passas 2 e 3;
5. Comita as alteraes feitas no arquivo para o controlador de verso.

Detalhes do Processo de Publicao

1. O responsvel pela publicao se conecta ao controlador de verso e sincroniza a verso mais recente do(s)
arquivo(s) que vai publicar;
2. Utilizando de um software seleciona o arquivo que deseja enviar para o servidor (Webmin).