Editando Configuração do Git

'''Configuração do Git para o projeto SimDeCS'''

Esta página detalha os passos necessários para baixar o código fonte do projeto do repositório git.

Git é um sistema de controle de versão distribuído com ênfase em velocidade. O Git foi inicialmente projetado e desenvolvido por Linus Torvalds para o desenvolvimento do kernel Linux.
Cada diretório de trabalho Git é um repositório com todos os históricos e habilidade total de controle das revisões, não dependente de acesso a uma rede ou a um servidor central. 
Fonte: http://pt.wikipedia.org/wiki/Git

Vídeo introdutório: http://learn.github.com/p/intro.html

Site oficial: http://git-scm.com/

Milhares de projetos open source são hospedados no [https://github.com/ github]. Qualquer um pode hospedar um projeto ou fazer um clone de um projeto existente para adicionar suas próprias modificações. O código das alterações realizadas no Unbbayes está hospedado lá https://github.com/mchelem/Simdecs---unbbayes.

O código do SimDeCS não está hospedado publicamente e sim em um repositório no servidor do UNASUS (200.18.67.61).

== Netbeans ==
As instruções a seguir são para Netbeans >= 7.0.1. Recomenda-se utilizar o Netbeans 7.1, pois alguns bugs importantes do plugin foram corrigidos.
O ambiente de referência foi configurado em inglês.

=== Instalação ===
* Netbeans 7.1 já vem com git instalado. 
* Para outras versões, deve-se baixar o plugin do Git: Tools -> Plugins. Procurar e instalar o plugin "Git".

=== Baixar o código fonte do projeto ===
O projeto criado no Netbeans é o diagrama e comunicação com a interface web (flash) do jogo.

* Clonar o repositório: Team -> Git -> Clone. Na tela para adição de repositório, incluir as seguintes configurações:
'''URL:''' ssh://200.18.67.61:4731/home/git/simdecs.git

'''usuário:''' git

[[Arquivo:Netbeans_git_config.png | 650px | Configuração do Git para Netbeans]]

* Selecionar "master" para baixar o repositório principal.
* Selecionar o diretório local aonde o projeto será salvo e finalizar.

==== Problemas conhecidos ====
* No OS X, pode ocorrer um erro de conexão quando se marca a opção para salvar a senha.
* No Windows, pode ocorrer um bug cuja mensagem é "reject hostKey". Esse bug foi relatado em http://netbeans.org/bugzilla/show_bug.cgi?id=199263 e foi corrigido na versão 7.1.

=== Fluxo normal de trabalho === 
* Editar os arquivos necessários.
* Clicar com o direito no projeto -> Git -> Commit. Selecionar os arquivos a serem enviados. Escrever uma mensagem explicando o que foi alterado. Submeter. (os commits são locais, então pode submeter sem estar conectado à internet).
* Quando quiser disponibilizar suas mudanças para os outros (que podem ser de vários commits), clicar com o direito -> Git -> Push. O endereço do repositório remoto já vai estar salvo, então é só selecionar master e finalizar.

=== Submeter um novo projeto ===
* Solicitar a criação de um repositório para o novo projeto no servidor, ou criá-lo você mesmo (veja abaixo).
* Inicializar o repositório git: Clicar com o direito no projeto -> Team -> Initialize git repository.
* Fazer commit dos arquivos: Clicar com o direito no projeto -> Git -> Commit. Selecionar os arquivos, adicionar uma mensagem e fazer o commit.
* Enviar para o servidor: Clicar com o direito no projeto -> Git -> Push -> Configurar o repositório remoto (adicionar o endereço do repositorio criado) ssh://git@200.18.67.61:4731/home/git/meuprojeto.git -> Selecionar o branch master -> Finish.

=== Mais informações ===
Para mais detalhes sobre a utilização do plugin leia o manual [http://netbeans.org/kb/docs/ide/git.html Git User Guide].

== Eclipse ==
Instruções testadas para o Eclipse > 3.6. O ambiente de referência foi configurado em inglês.

=== Instalação ===
* Para instalar o plugin no eclipse, deve-se ir em Help -> Install New Software. Procurar por Git no repositório principal do Eclipse e instalar o "Egit".

=== Baixar o código fonte do projeto ===
O projeto criado no Eclipse é o sistema web para cadastro de usuários, grupos, privilégios e redes Bayesianas. 

* Importar um projeto do Git. Ir em New -> Import -> Git -> Projects from Git.
[[Arquivo: Eclipse_import_project.png | 500px | Importar projeto Git]]

* Clonar um repositório com as seguintes configurações:

'''URI:''' ssh://200.18.67.61:4731/home/git/simdecs_seam.git

'''usuário:''' git

Basta completar a URI com ssh://git@200.18.67.61:4731/home/git/simdecs_seam.git e digitar a senha. Os demais dados serão preenchidos automaticamente.

[[Arquivo: Eclipse_git_config.png | 500px | Importar projeto Git]]

* Selecionar "master" para baixar o repositório principal.
* Selecionar o diretório local aonde o projeto será salvo e finalizar.
* Após clonar, selecionar o repositório adicionado, ir em Next e Import existing projects.

=== Fluxo normal de trabalho === 
* Editar os arquivos necessários.
* Clicar com o direito no projeto -> Team -> Commit. Selecionar os arquivos a serem enviados. Escrever uma mensagem explicando o que foi alterado. Submeter. (os commits são locais, então pode submeter sem estar conectado à internet).
* Quando quiser disponibilizar suas mudanças para os outros (que podem ser de vários commits), clicar com o direito -> Team -> Push. Existe também a opção Commit and Push que submete as mudanças local e remotamente.

=== Mais informações ===
Para iniciar, leia o tutorial [http://www.vogella.de/articles/EGit/article.html Git with Eclipse].

Para mais informações sobre a utilização do plugin, leia o manual do usuário [http://wiki.eclipse.org/EGit/User_Guide EGit User Guide].

Leia também [http://wiki.eclipse.org/EGit/Git_For_Eclipse_Users Git for Eclipse Users].

== Linha de Comando == 

Os projetos podem ser baixados diretamente pela linha de comando. Para isso, baixe o Git para o seu sistema na página de downloads do site oficial: http://git-scm.com/download.

=== Instalação ===

* Instale o Git de acordo com seu sistema operacional. Em sistemas linux, pode-se usar um apt-get install git (debian) ou yum install git (redhat). 

=== Baixar o código fonte do projeto ===
* Use o seguinte comando:
git clone ssh://git@200.18.67.61:4731/home/git/simdecs.git
Digitar a senha quando solicitado.

A saída será similar ao seguinte:

<code>
mchelem@witch:~/temp$ git clone ssh://git@200.18.67.61:4731/home/git/simdecs.git

Cloning into simdecs...

git@200.18.67.61's password: 

remote: Counting objects: 186, done.

remote: Compressing objects: 100% (160/160), done.

remote: Total 186 (delta 54), reused 0 (delta 0)

Receiving objects: 100% (186/186), 13.97 MiB | 792 KiB/s, done.

Resolving deltas: 100% (54/54), done.
</code>

=== Fluxo normal de trabalho ===
* Editar os arquivos necessários.
* Adicionar os arquivos cujas modificações serão enviadas com o comando <code> git add <arquivo> </code>. Arquivos que foram somente modificados (não são novos arquivos) podem ser especificados direto no comando de commit. 
* Submeter os arquivos localmente com <code> git commit -m "Mensagem explicando o que foi feito.". </code> Pode-se especificar a opção -a para adicionar todos os arquivos modificados ao commit (não adiciona novos arquivos), dispensando o passo anterior.
* Quando desejar submeter o código ao servidor, utilizar <code> git push </code>.
* Para obter as últimas modificações do servidor, utilizar <code> git pull </code>. É uma prática saudável atualizar seu código de tempos em tempos, para evitar conflitos.

=== Mais informações ===
Uma ótima fonte de informações é o site [http://gitref.org/ Git Reference].

Alguns tutoriais:

[http://www.vogella.de/articles/Git/article.html#firstgit_repo Git Tutorial].
[http://schacon.github.com/git/gittutorial.html Official Git Tutorial]

Manual:

[http://schacon.github.com/git/user-manual.html Git User Manual]

== Outros clientes Git == 
Existem outras interfaces gráficas para acesso direto ao Git. É sempre bom ter um cliente Git adicional (linha de comando ou gráfico), caso o da IDE apresente algum problema.
* Windows: 
**[http://code.google.com/p/tortoisegit/ Tortoise Git]
**[http://sourceforge.net/projects/gitextensions/ Git Extensions]
* Mac: 
**[http://gitx.laullon.com/ GitX]
* Linux 
**[http://sourceforge.net/projects/qgit/ QGit]

== Criar um novo projeto no servidor ==
Caso precise de um novo projeto, conecte-se ao servidor por ssh:

<code> ssh git@200.18.67.61 -p4731 </code>

Digite o seguinte comando:

<code> sudo ./create_git_project nomedoprojeto.git </code>

Entre com a senha do usuário git e será exibida uma mensagem informando que o repositório foi criado.

Você pode visualizar o projeto no [http://200.18.67.61/gitweb/ gitweb].

Caso queira editar a descrição do projeto, deve editar o arquivo "description" dentro do diretório <code> /home/git/nomedoprojeto.git </code>.

== Excluir um projeto ==

Também existe um script para excluir um projeto. Antes de usar o comando abaixo '''verifique bem o nome do projeto e tenha certeza de que quer excluí-lo pois não é possível recuperar os arquivos'''.

<code> sudo ./delete_git_project nomedoprojeto.git </code>

Entre com a senha e o projeto será excluído. Não será apresentada nenhuma mensagem de confirmação.