Manual de Utilizao do TortoiseSvn
Maro de
2011
ndiceOBJETIVO.................................................................................................................................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 DETALHESDO DO
PROCESSO PROCESSO
DE DE
DESENVOLVIMENTO..............................................................................................................10 PUBLICAO.....................................................................................................................10
TortoiseSVN Clientes de Subversion para WindowsObjetivoEsse manual ir auxiliar os colaboradores a utilizarem o TortoiseSVN, cliente de subversion para Windows.
InstaladoresPrimeiramente 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.
DiretriosNa mquina cliente ser necessrio criar uma estrutura bsica de diretrios para que seja possvel gerenciar os arquivos baixados do controlador de verso.
Diretrio do RepositrioDever 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 ProjetoComo padro, para cada projeto, dever ser criado um diretrio com o nome do projeto (o mesmo nome definido no Visual SVN Server).
Diretrio TRUNKEsse 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 SVNClicando 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 AutenticaoDepois 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.
FontesTemos abaixo todos os fontes baixados, o sinal de certo em verde representa que nesses fontes no existe nenhum que foi alterado.
Bloqueando ArquivoSempre 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 ArquivosPara 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.
CommitPara 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 LOGPara 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 ProcessoAbaixo segue imagem e descrio do fluxo do processo de controle de verso.
Detalhes do Processo de Desenvolvimento1. 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 Publicao1. 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).
