sampope 2: Como colocar uma aplicação Rails no GitHub?

Colocando uma aplicação Rails no GitHub

Neste post colocaremos nossa aplicação do post anterior no GitHub.

Git é o que há em termos de controle de versão! Com ele você consegue guardar cada versão do seu projeto praticamente forever. Ele também facilita muito a vida das equipes com vários devs codando ao mesmo tempo, porque ajuda a organizar quem fez qual alteração e quando ela aconteceu. Tudo isso é muito bom!

Para usar git num projeto, nós precisamos instalar git na máquina, e dentro do diretório rodar o comando git init, que cria o que chamamos de repositório. A palavra repositório nesse contexto se refere a todos os códigos, arquivos, e versões do projeto. Tudo.

Tudo? Tudo.

Com isso, guardar este repositório em algum lugar além da sua máquina é, de certa forma*, como fazer um backup do seu projeto.
* A expressão "de certa forma" é necessária, porque no repositório geralmente não temos chaves nem dados, então não é o backup de 100% do que você tem rodando em certo momento e/ou precisa para recuperar uma aplicação por completo.

Uma das plataformas mais usadas para guardar e compartilhar projetos e códigos é o GitHub. Lá você encontra milhões de projetos e versões. Você também pode colaborar com outros devs e até mesmo criar uma versão sua de algo que já existe, fazendo um "Fork".

 Vamos lá?

O primeiro passo seria instalar o git e rodar o git init, mas no nosso caso, se olharmos a criação da nossa aplicação Rails 6, isso já aconteceu! Faz parte daquelas automatizações e facilidades do Rails.

Para termos certeza disso, rodamos o comando git status:

vivipoit ~/Projects/sampope (master)
> git status
On branch master

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)

 .browserslistrc
 .gitignore
 .ruby-version
 Gemfile
 Gemfile.lock
 README.md
 Rakefile
 app/
 babel.config.js
 bin/
 config.ru
 config/
 db/
 lib/
 log/
 package.json
 postcss.config.js
 public/
 storage/
 tmp/
 vendor/
 yarn.lock

nothing added to commit but untracked files present (use "git add" to track)

Podemos falar deste monte de informações em detalhes num outro post qualquer. Por hoje, o importante é vermos simplesmente que sim, de fato o git está rodando e nosso projeto já tem seu repositório configurado.

Uma coisa importante para notar nesse momento é a linha:

No commits yet

Ela nos diz que nosso repositório não tem nenhum commit. Isso quer dizer que nenhuma versão do nosso projeto está confirmada, comprometida, registrada. Sei lá, podemos chamar de várias coisas.

Para colocar nosso projeto no GitHub, ele precisa de pelo menos uma versão "comittada". Aqui começam nossos passos:

1 - Rode o comando git add .

git add .

Esse comando diz: Git, adicione todos os arquivos neste diretório, por favor.

Adicione ao que? À lista de arquivos que em breve será commitada.

Quando você rodar o comando, vai parecer que não mudou nada, mas se você rodar novamente git status, verá uma mudança importantíssima:

Todos os arquivos do projeto foram de Untracked files: para Changes to be committed:.

2 - Rode o comando git commit

O comando git commit vai registrar este momento como uma versão no nosso repositório. Ele pede que a gente sempre coloque uma mensagem sobre esta versão. Como este é o primeiro commit desta aplicação e ela não tem nada além de sua criação inicial, eu vou colocar "sampope is born":

git commit -m 'sampope is born'

Notem que a mensagem é uma string. As aspas são necessárias.

Agora, se rodarmos git status novamente veremos algo do tipo: nothing to commit, working tree clean.

Ok. A app está pronta. Agora para o GitHub!

3 - Crie uma conta no GitHub

É só entrar no site (github.com) e criar a conta.

4 - Configure a chave SSH e conecte seu computador

Para colocar o repositório no GitHub, nós precisamos que o computador consiga acessar o GitHub. Para isso, gere sua chave, configure ela na sua conta, e conecte seu computador seguindo os passos e as orientações do próprio GitHub: Conectar-se ao GitHub com SSH.

5 - Crie o repositório no GitHub

No topo direito da tela, ao lado da sua foto de perfil, o GitHub tem um "+". Clique nele e selecione a opção para criar um novo reposiório.

O único campo obrigatório é o nome, que em geral é o nome da aplicação. Vamos colocar "sampope" e criar!

6 - Aponte a origem do seu repositório local para o do GitHub

Quando você criou o repositório no GitHub, a tela seguinte te deu várias informações. Entre elas, você vai encontrar um campo com botões que dizem https e ssh. Provavelmente ssh estará selecionado e o texto no campo será algo como: git@github.com:<seu usuário>/<seu projeto>.git.

No meu caso é git@github.com:vivipoit/sampope.git.

Esta é a URL do seu projeto no GitHub. Copie (ctrl + c) esta informação.

De volta ao seu terminal, no diretório do projeto, vamos usar o comando git remote add origin para que o nosso repositório local saiba onde está o parceiro dele lá no GitHub.

git remote add origin, no caso, diz:

Git, adicione essa origem remota, por favor.

O comando completo fica: git remote add origin git@github.com:vivipoit/sampope.git.

Ao rodar o comando pode parecer que nada mudou, mas podemos confirmar se está tudo em ordem com o comando git remote -v:

vivipoit ~/Projects/sampope (master)
> git remote add origin git@github.com:vivipoit/sampope.git
vivipoit ~/Projects/sampope (master)
> git remote -v
origin git@github.com:vivipoit/sampope.git (fetch)
origin git@github.com:vivipoit/sampope.git (push)

Podemos ver que a origem está lá configurada certinho.

7 - Envie o código para o GitHub

Agora chegou a grande hora! Vamos usar o comando git push para mandar de fato o código comitado para o GitHub!

O comando completo é git push origin master.

Ele diz: Git, empurra para a origem o que está aqui nessa master, por favor.

vivipoit ~/Projects/sampope (master)
> git push origin master
Enumerating objects: 95, done.
Counting objects: 100% (95/95), done.
Delta compression using up to 8 threads
Compressing objects: 100% (79/79), done.
Writing objects: 100% (95/95), 144.96 KiB | 717.00 KiB/s, done.
Total 95 (delta 3), reused 0 (delta 0)
remote: Resolving deltas: 100% (3/3), done.
To github.com:vivipoit/sampope.git
 * [new branch]      master -> master

Será que deu certo?

Para termos certeza, podemos atualizar a tela do nosso navegador que estava lá no repositório. No meu caso, o link é https://github.com/vivipoit/sampope.

Tudo certo!! :-)

Agora o nosso repositório faz parte do mundo de projetos e códigos do GitHub!

Sugestão Final

Se o seu repositório é público, adicione uma descrição e configure o README.md.