Como interagir no Repositório?
O repositório é baseado na ferramenta de controle de versões Subversion (SVN) que é um Sistema de Controle de Versões como o conhecido CVS mas com algumas melhorias e facilidades.
O endereço raiz do servidor Subversion para o CACIC é:
https://svn.softwarepublico.gov.br/svn/cacic/
Portanto, antes aqui navegue pelo repositório (código) para saber qual árvore de desenvolvimento do CACIC lhe interessa (é necessário "entrar/logar").
Existem várias ferramentas gráficas que podem facilitar a sua interação com o SVN, ferramentas como:
- http://rapidsvn.tigris.org/
- http://tortoisesvn.tigris.org/
- http://jsvn.alternatecomputing.com/
- http://esvn.umputun.com/trac.cgi/wiki
Para aprender mais sobre o Subversion deve-se olhar as várias documentações já existentes na WEB, como por exemplo:
- Documentação Oficial SVN
- http://www.pronus.eng.br/artigos_tutoriais/gerencia_configuracao/subversion.php
- http://www.pronus.eng.br/artigos_tutoriais/gerencia_configuracao/controle_versao.php
Para Baixar o Código
Os exemplos abaixo são para o caso da utilização do SVN, sem interface gráfica onde deve ser observada a necessidade das opções:
- O seu usuário (email) e senha na comunidade CACIC (Software Publico) previamente cadastrados.
Exemplo:
seu_email@dominio.orgSENHA
Árvore trunk (versão futura)
A árvore trunk (cacic/trunk) será sempre a versão futura do CACIC, mas ainda sem a definição número ou nome. Nesse exemplo será baixado todo o código fonte do gerente, agente-windows, agente-linux etc.
$ svn co --username seu_email@dominio.org https://svn.softwarepublico.gov.br/svn/cacic/cacic/trunk/ cacic2
Árvore branches (marcas de versões)
A árvore branches (cacic/branches) é o local onde pode haver manutenções de versões já nomeadas (ou numeradas) liberadas ou a serem liberadas (ex: 2.2, 2.4). Para obter e realizar manutenção em versões é essa a árvore a ser baixada.
Usando a versão 2.4 em exemplos:
- para auxiliar no desenvolvimento do "gerente" da versão 2.4.x
$ svn co --username seu_email@dominio.org https://svn.softwarepublico.gov.br/svn/cacic/cacic/branches/2.4/gerente cacic2
- para auxiliar no desenvolvimento do "agente-windows" da versão 2.4.x
$ svn co --username seu_email@dominio.org https://svn.softwarepublico.gov.br/svn/cacic/cacic/branches/2.4/agente-windows agente-windows
- para auxiliar no desenvolvimento do "agente-linux" da versão 2.4.x
$ svn co --username seu_email@dominio.org https://svn.softwarepublico.gov.br/svn/cacic/cacic/branches/2.4/agente-linux agente-linux
Árvore tags (marcas congeladas de versões)
A árvore tags (cacic/tags) é o local de armazenamento de versões liberadas e não devem sofrer manuteção, servem para publicar em produção.
Proxy (http/https)
Para quem tem a navegação na internet coordenada por um proxy (http/https) é necessário que realize uma configuração especial em seu PC e assim poder usar os repositórios subversion do CACIC.
- modo console (linha de comando)
O uso do svn em linha de comando poderá ser configurado através de arquivos que estão na pasta .subversion na pasta pessoal do usuário. Configure o arquivo servers para que possa usar svn sob proxy como segue:
# Acrescentar o grupo [groups] cacic = svn.softwarepublico.gov.br # Configurar proxy para o grupo [cacic] http-proxy-host = 192.168.0.1 http-proxy-port = 8080 http-proxy-username = nome_usuario http-proxy-password = senha_usuario
