Esse tutorial faz parte de uma série de 3 artigos que explicam a utilização do Git e foi escrito e publicado pelo Codexico no blog codexico.com.br o qual detém todos os méritos pelo conteúdo de extrema qualidade e utilidade.
Ultimamente estou envolvido em vários projetos ao mesmo tempo com várias equipes diferentes, então controle de versão é essencial.
Segue um manualzinho básico para iniciar com o git, espero atualizar e complementar este passo-a-passo com mais exemplos logo.
O git serve para versionamento local, você pode compartilhar de algumas maneiras, a mais fácil é com serviços online. Neste exemplo vou usar o github, testei também o projectlocker, que dá repositórios private grátis, mas não gostei. Outro que parece legal é o Codaset, ainda não testei.
1) Instalar git
1 | $ sudo apt-get install git-core |
É necessário gerar uma chave ssh e fazer um cadastro em algum repositório git. ( Esta etapa não é exatamente sobre o git, mas sobre a segurança dos repositórios. )
Confira se vc já tem alguma chave com um "ls ~/.ssh/", se já existir uma você pode utilizá-la ou gerar uma nova:
1 | ssh-keygen -t rsa -C "comment" |
"comment" é só um lembrete para saber do que se trata a chave, normalmente usa-se o seu nome de usuário do serviço que vai usar, por exemplo o github.
Falando nisso, está na hora de criar um usuário lá (http://github.com), vai lá que eu espero…
Depois de logado vá para https://github.com/account e clique em "SSH Public Keys" e "add another public key". A cópia da chave precisa ser exata(eu ia escrever que 'precisa ser precisa' mas é feio né), então pode-se fazer assim:
1 | sudo apt-get install xclip |
Aí é só colar com um Ctrl+V normal. Agora já dá para se comunicar com o github:
1 | ssh git@github.com |
Vai aparecer "ERROR: Hi codexico! You've successfully authenticated, but GitHub does not provide shell access", não se assuste com o ERROR, o que interessa é que o github te reconheceu. Qualquer duvida tem o help do github: Generating SSH keys (Linux).
Por padrão o git vai pegar o usuário do sistema, para que seu nome de usuário do github apareça corretamente use os comandos:
1 | git config --global user.name "Your Name" |
2) Criar Projeto no github
1) Podemos criar um novo projeto ou usar um existente. Para criar um novo vá até o github e no alto da página clique em "Dashboard" e depois em "New Repository".
Crie um espaço para o projeto no comnputador:
1 | $ mkdir nomedoprojeto |
2) Iniciar um git neste diretório:
1 | $ git init |
Saída do comando:
1 | Initialized empty Git repository in /nomedodiretorio/.git/ |
Deve aparecer um diretorio oculto .git, neste .git ficam as configurações que serão usadas para este projeto.
Por exemplo:
1 | $ ls .git |
3) Adicionar o repositório, neste exemplo vou usar um que criei para este tutorial, pode ser também o repositório criado no passo 1, o endereço fica na página do projeto (neste caso https://github.com/codexico/tutorial-github):
1 | $ git remote add origin git@github.com:codexico/tutorial-github.git |
Formato do comando:
"git remote add" adiciona um repositório ao git que foi iniciado neste diretório, "origin" é o apelido para o projeto, "git@github.com:codexico/tutorial-github.git" é o endereço do projeto.
Resultado:(apareceu a parte [remote "origin"])
1 | $ cat .git/config |
4) Baixar(pull=puxar) o projeto:
1 | $ git pull origin master |
Formato do comando:
1 | git pull apelidoDaOrigem apelidoParaDestino |
Saída do comando:
1 | remote: Counting objects: 52278, done. |
3) Usar o git
Exemplo (escolha um nome diferente para o arquivo teste):
1 | $ touch testegit |
1) Adicionar as alterações:
- Podemos adicionar somente uma alteração:
1 | $ git add testegit |
- Ou adicionar todas as alterações:
1 | $ git add . |
Neste passo as alterações ainda não estão sob o controle de versão, elas somente foram adicionadas para quando der um commit.
2) Comitar as alterações:
1 | $ git commit -m "mensagem teste para o tutorial" |
É obrigatório acrescentar uma mensagem.
Saída do comando:
1 | [master de2f5ce] teste para o tutorial |
Agora as alterações foram adicionadas ao controle de versão. Mas ainda estão somente na máquina local.
3) Enviar(push=empurrar) as alterações:
1 | $ git push origin master |
Saída do comando:
1 | Counting objects: 4, done. |
Se durante o tempo em que fez o pull e o push outra pessoa que também participe do projeto fez alterações o push será rejeitado. Então é necessário atualizar o projeto local antes de enviar novas alterações.
1 | $ git fetch origin |
Atualizar antes de enviar é uma boa prática a ser seguida para quem usa svn ou cvs e é obrigatória no git.
4)Pronto, confira as alterações no navegador acessando o endereço do projeto (http://github.com/codexico/tutorial-github neste exemplo).
Dica final: para que não precise digitar sempre a senha do ssh siga os passos desse link: http://help.github.com/working-with-key-passphrases/
Atualizado em 09/09/2010, mudei o repositório e adicionei instruções para gerar a chave ssh.
Fonte: http://codexico.com.br/blog/linux/tutorial-simples-como-usar-o-git-e-o-github/