domingo, 5 de outubro de 2014

[Tutorial] Git + GitHub - Guia básico

Introdução

Acho que todo mundo que trabalha com T.I. ou está estudando já ouviu falar sobre controladores de versão, certo? Caso você não saiba do que eu estou falando, recomendo a leitura desse artigo feito pelo pessoal do Tableless http://tableless.com.br/iniciando-no-git-parte-1/ . Está bem estruturado e lhe dará uma boa introdução.

A minha ideia ao criar esse tutorial foi derivada quando eu tentei aprender e configurar Git e não consegui um local centralizado de informações, tive que buscar em vários locais. Em suma, não quero que vocês passem por esse problema também, logo, estarei centralizando tudo aqui. Não se preocupem, as fontes estarão no final do tutorial.

Esse tutorial, tem como ideia ser o básico do básico, só para enviar o seu projeto para o GitHub pela primeira vez. Futuramente, farei um tutorial para ensinar a atualizar o projeto e trabalhar com mais de uma pessoa no projeto. Ai você me pergunta: 'Nossa, um tutorial só para enviar pela primeira vez o projeto para o GitHub? De que presta isso?'
É apenas um backup. Você pode encarar o GitHub, inicialmente, como uma ferramenta para armazenar o seu código em Cloud, da mesma forma que você armazena arquivos no Google Drive, Dropbox e afins.

O tutorial será baseado em linhas de comando, uma forma mais rápida e a que se usará mais no dia a dia. Caso não se sinta confortável, não encare isso como uma barreira para o aprendizado, encare como uma possibilidade de aprender e se familiarizar com o ambiente shell (no caso do Linux) ou prompt (no caso do Windows).


Instalação

Logicamente, para o uso do Git, você precisará instala-lo em sua máquina. Eu fiz a instalação em 2 sistemas operacionais: Windows 8.1 e Ubuntu 14.04. A instalação desses 2 eu garanto, logo, não vou colocar instalações de outros S.O. que eu não testei.

Ubuntu 14.04

sudo apt-get install git


Windows 8.1

[Não estou com o meu computador windows no momento, quando eu consegui-lo eu volto ao tutorial de Windows]

Configuração

Git

A configuração de ambos é basicamente a mesma, no caso do Ubuntu, só abrir o terminal (ctrl+alt+t) ou no caso do Windows, abrir o bash do Git (botão direito na pasta do projeto, Git bash).

git config --global user.name "SEU NOME AQUI"
git config --global user.email email@gmail.com 
As configurações acima servem basicamente para identificar você no momento do commit.

Chave SSH

Essa parte da configuração é de extrema importância para o uso do GitHub. Caso você não tenha uma conta, pode criar em: https://github.com/ . Nela, geraremos uma chave SSH que possibilitará enviar o nosso código para o repositório externo, no caso, GitHub.
ssh-keygen -t rsa -C "your_email@example.com"
Após executar o comando acima, você receberá uma mensagem parecida com essa: Enter a file in which to save the key, apenas dê Enter. Logo em seguida, será solicitado para digitar a senha e confirmá-la.
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_rsa
Os comandos acima servem para iniciar o ssh-agent e adicionar a chave gerada anteriormente ao ssh-agent, respectivamente.

sudo apt-get install xclip 
xclip -sel clip < ~/.ssh/id_rsa.pub
Os comandos acima servem para copiar para a área de transferência a sua chave SSH gerada.
Logo em seguida, acesse sua conta no GitHub, vá em configurações (engrenagem no canto superior direito) > SSH Keys > Add SSH Key , dê um nome que você deseja para identificar (eu coloco o nome do computador), e no campo de baixo, cole a chave SSH. Clique em ADD Key e está feito!

Git Hub

Crie um repositório no site do GitHub, clicando no + no canto superior direito (próximo a engrenagem de configuração). De preferencia, coloque o mesmo nome do projeto que você irá desenvolver.

Após criado o repositório, vá ao terminal e digite o comando abaixo
git remote add origin git@github.com:nome_do_usuario/nome_do_repositorio

Começando utilizar

Após as configurações acima, você já estará pronto para utilizar o Git.

Navegue até a pasta do projeto, exemplo: cd /workspace/OlaMundo e digite o comando abaixo:
git init
Este comando serve para o Git começar controlar o diretório do seu projeto. Logo em seguida, digite:
git add .
Este comando serve para o Git começar reconhecer os seus arquivos.
git commit -m "Meu primeiro commit!"
Este comando serve para commitar os seus arquivos.

Após a execução dos comandos acima, será possível enviar o projeto para o GitHub. Faça-o digitando o comando abaixo:
git push origin master
Aguarde o término da execução, e quando terminar, vá ao site do GitHub, acesse o seu repositório e verifique se os arquivos do seu projeto estão lá. Em caso positivo, tudo certo! Caso não tenha dado certo, deixe as dúvidas nos comentários.

Fontes