Instalação do Subversion e Tortoise

Para este procedimento serão necessários os softwares Apache 2.0.59 eSubversion 1.4.5. OBS: O VisualSVN Server já instala o Apache e elimina grande parte dos passos abaixo. 1 - Instale o Apache 2.0.59, este processo é bastante simples, apenas aceite as definições padrão, típica instalação NNF, (Next - Next - Finish). Para ver se o apache foi instalado com sucesso, abra o browser e no endereço digite http://localhost/, se tudo estiver certo deverá ser apresentada uma página com informações sobre o Apache. 2 - Instale o Subversion 1.4.5, processo simples também, aceite as opções padrão, mais uma típica instalação NNF, (Next - Next - Finish). 3 - Crie um diretório onde serão hospedados os projetos, por exemplo"C:\SVN", este será o repositório central e os projetos ficarão hospedados em subdiretórios deste. 4 - Abra o console de comandos do DOS, (abra o Executar e digite cmd ou command seguido de Enter), navegue até o diretório onde foi instalado o Subversion, comumente o diretório será "C:\Arquivos de Programas\Subversion" para SO em Português e "C:\Program Files\Subversion" para SO em Inglês. 4.1 - Ainda no console do DOS navegue para o subdiretório \Bin e execute o comando "svnadmin create C:\SVN\" sem as aspas, note que onde consta você deverá informar o nome de um diretório, neste diretório é onde ficarão hospedados os arquivos do referido projeto, cada projeto ficara em um subdiretório específico, todos estes subdiretórios deverão estar obrigatoriamente dentro do diretório criado no passo 2, onde como exemplo utilizamos o nome de "SVN" passando como caminho "C:\". EX.: "svnadmin create C:\SVN\FS" onde "C:\SVN\" é o caminho do repositório "pai" e "FS" é o diretório onde ficarão os arquivos do projeto FS. 5 - Concluído o passo 4 devemos criar um serviço no Windows para que o processo de start do serviço do Subversion seja automático toda vez que o servidor seja reiniciado, para isso faça o seguinte; Crie um arquivo , edite esse arquivo e insira o seguinte comando: sc create SVNservice binpath= "\"c:\Arquivos de programas\Subversion\bin\svnserve.exe\" –service --root C:\SVN" displayname= "SVNservice" depend= Tcpip pause Note que o comando que inicia com "sc" deve estar em uma única linha, o comando "pause" serve para pausar o script e permitir que seja verificada qualquer mensagem de erro que possa ocorrer. Desmontando o comando: • sc create = Comando nativo do Windows responsável por criar serviços SVNservice = Este será o nome interno do service para o Windows binpath = Variável onde é informado a localização do executável do Servidor do Subversion compreendido por: "\"c:\Arquivos de programas\Subversion\bin\svnserve.exe\" O parâmetro "--service" que informa ao comando que o executável deve ser tratado como um serviço do Windows • O parâmetro "--root C:\SVN" que indica onde será o diretório raiz dos projetos, diretório criado no passo 2 • O parâmetro "displayname= "SVNservice"", responsável por dar um nome ao serviço, neste caso o serviço irá aparecer na lista de serviços do Windows com o nome "SVNservice" • E por fim o parâmetro "depend= Tcpip" indicando que o serviço depende do bom funcionamento de outro serviço, o serviço do protocolo TCP/IP Feito este processo salve o arquivo e execute-o para criar definitivamente o serviço. 6 - Abra o gerenciador de serviços do Windows, para isso abra o Executar e digite o comando services.msc e clique em OK. Localize o serviço que acabamos de criar, ele dever estar com o nome "SVNservice", clique com o botão direito do mouse no mesmo, na caixa de diálogo clique em propriedades e altere o campo Tipo de Inicialização para Automático, clique no botão Iniciar, clique em Aplicar e em OK. 7 - Baixe o arquivo "mod_auth_sspi.so" que você encontra emhttp://www.gknw.net/development/apache/httpd-2.0/win32/modules/ e salve ele no diretório \modules que encontra-se no diretório de instalação do Apache, este arquivo é um script que permite ao Apache integrar o servico de autenticação de usuários com os usuários de Rede do Windows. 7.1 - Edite o arquivo "httpd.conf" que está no diretório \conf dentro do diretório de instalação do Apache. 7.2 - Adicione a linha LoadModule sspi_auth_module modules/mod_auth_sspi.so acima da linha LoadModule auth_module modules/mod_auth.so 7.3 - Descomente, (remova o símbolo '#'), da frente das linhas #LoadModule dav_fs_module modules/mod_dav_fs.so #LoadModule dav_module modules/mod_dav.so 7.4 - No mesmo arquivo de configuração adicione após a última linha o seguinte grupo de string DAV svn SVNListParentPath on SVNParentPath C:\SVN AuthType SSPI AuthName "Subversion repositories" #AuthUserFile passwd AuthzSVNAccessFile "\svnaccessfile.conf" Require valid-user SSPIAuth On SSPIAuthoritative On SSPIDomain SSPIOfferBasic On Altere a linha "", onde consta "SVN" você deve informar o diretório raiz do repositório no Servidor do Subversion, observe que deve existir uma "/" antes do nome do diretório. Altere a linha "SVNParentPath C:\SVN", onde consta "C:\SVN" você deve informar o caminho do diretório raiz do repositório no Servidor do Subversion. Altere a linha "SSPIDomain ", onde consta você deve informar a sigla do domínio de sua empresa. 7.4.1 - Crie um arquivo chamado "svnaccessfile.conf" dentro do diretório \conf no diretório de instalação do Apache, o conteúdo deste arquivo deverá ser composto pelas seguintes instruções: #========================================================= # Bloco onde são criados grupos, nestes grupos colocam-se # os usuários de rede do domínio Windows, estes grupos é # que terão permissões nos diretórios dos projetos, os # nomes de usuário deverão ser compostos por # \ [groups] admin = \user.admin devteam = \devenv.um, \desenv.dois, \desenv.tres # Regra de acesso default para TODOS([/]) os repositórios # TODOS(*) usuários podem ler(r = read), admins podem # modificar(rw = read write), usuário dangerman possui # privilégio algum(permissão em branco) [/] * = r @admin = rw dangerman = # Regra de permissão ao grupo devteam, eles poderão # alterar o projeto Teste2 e seus subdiretórios [Teste2:/] @devteam = rw #========================================================= Obs.: Nas regras acima deve-se levar em conta que a estrutura de diretórios no servidor Subversion é composta da seguinte maneira: C:\ |_SVN |_Teste2 Onde SVN é o repositório central e [/] é igual a SVN Onde Teste2 é o diretório de um projeto e [Teste2:/] é igual a Teste2 Altere a linha "AuthzSVNAccessFile..." do bloco de códigos criado no passo 7.4, você deve informar o caminho onde você salvou o arquivo"svnaccessfile.conf" criado no passo 7.4.1 7.5 - Salve os arquivos e feche-os. Reinicie o servidor Apache. Caso no restart o Apache apresente mensagens de erro, provavelmente o arquivo "httpd.conf" possua alguma string com erro, existe um utilitário que é encontrado em "Iniciar -> Programas -> Apache -> Configurar Servidor Apache -> Testar Configuração" que verifica a integridade do arquivo em questão e mostra onde está o erro, em caso de problemas utilize-o. Concluo aqui mais uma parte das matérias sobre Subversion, num próximo post falarei sobre a instalação, configuração e utilização de um cliente que fará o acesso ao servidor da aplicação e consequentemente a sincronia dos arquivos. Bem galera, vamos a terceira parte sobre instalação e configuração do Subversion no Windows. Existem vários clientes de SVN gratuitos capazes de acessar um Servidor de Subversion, falarei aqui sobre o TortoiseSVN, desenvolvido pela mesma equipe que desenvolve o Subversion. 1 - Baixe o instalador do TortoiseSVN aqui. 2 - Execute o instalador do TortoiseSVN, a instalação é trivial, aceite as opções padrões e clique em Next até chegar em Finish, pronto, o Tortoise está instalado e você deve reiniciar o PC para que as alterações efetuadas na instalação sejam efetivadas. 3 - Após o restart do PC chega o momento de sincronizar pela primeira vez o seu PC com o servidor do Subversion. * Importante! É importante observar que no Servidor do Subversion deve existir já criado com o comando "svnadmin create C:\SVN\" um diretório onde serão guardados os arquivos referentes a este projeto. 3.1 - Selecione o diretório onde ficará guardado o projeto em seu PC, este diretório pode tanto estar vazio como já possuir os arquivos, clique com o botão direito do mouse sobre ele, no menu que abrir clique em "SVN Checkout...", abrira uma tela do TortoiseSVN onde você deverá informar alguns parâmetros, são eles: URL of repository: Aqui você deve informar a seguinte linha: "http:////" Onde: "http://" = Protocolo de comunicação "" = IP de rede do servidor, Ex.:192.150.1.1 "" = Nome do Diretório onde fica o Repositório, no nosso caso "SVN" "" = Nome do Diretório criado com o comando "svnadmin create C:\SVN\FS" no nosso caso seria"FS" Ex.:http://192.150.1.1/SVN/fs Checkout directory: O caminho do diretório que você clicou com o botão direito do mouse no inicio deste passo Ex.: C:\FS Revision: Deixe marcado "HEAD revision". Clique em OK e siga as orientações da aplicação. 4 - Concluído o passo anterior ja estamos aptos a utilizar as funcionalidades da aplicação, após criar, editar, alterar e salvar algum arquivo que esteja no diretório do projeto este receberá um ícone diferenciado informando que o arquivo necessita ser enviado ao servidor, para isso clique com o botão direito do mouse sobre o arquivo e no menu do Tortoise clique em "SVN Commit...", caso você tenha vários arquivos modificados você pode mandar todos de uma única vez ao servidor, para isso ao invés de clicar com o botão direito no arquivo clique no diretório Pai e proceda conforme descrito anteriormente.