Antonio SilvaNesse guia, faremos um tour bem prático sobre como usar o Git para versionar nossos projetos.
1. Configurações Básicas
É importante nos identificarmos para o Git, informando nosso nome e e-mail. Em um terminal, execute os comandos a seguir:
git config --global user.name "User_Name"
git config --global user.email "User_email"
2. Criando um arquivo texto para versionarmos
Crie um diretório chamado lista:
$ mkdir lista
Crie um arquivo txt chamado objetos dentro do diretório. Dentro do arquivo, escreva os seguintes conteúdos:
Cadeira
Lapis
Caderno
3. Versionando seu código com Git
Abra um terminal e vá até o diretório lista
$ cd caminho_ate_diretorio/lista
Para transformar o diretório atual em um repositório do Git, basta executar o comando:
$ git init
Pronto, o projeto já é um repositório Git vazio.
Observe que foi criada uma pasta oculta com o nome .git.
4. Rastreando o arquivo
Mas e o arquivo objetos.txt ? Será que já está versionado?
Podemos ver a situação dos arquivos no repositório Git com o comando:
$ git status
A saída deverá ser algo como:
# On branch master
#
# Initial commit
#
# Untracked files:
# (use "git add <file>..." to include in what will be
committed)
#
# objetos.txt
nothing added to commit but untracked files present (use
"git add" to track)
Observe a mensagem anterior: ela indica que o arquivo objetos.txt ainda não foi rastreado pelo Git.
Para que o arquivo seja rastreado, devemos executar o seguinte comando:
$ git add objetos.txt
Agora, se executarmos git status novamente, teremos a seguinte saída:
# On branch master
#
# Initial commit
#
# Changes to be committed:
# (use "git rm --cached <file>..." to unstage)
#
# new file: objetos.txt
#
5. Gravando o arquivo no repositório
O resultado anterior mostra que o conteúdo do arquivo objetos.txt já está sendo rastreado pelo Git, mas ainda não foi gravado no repositório.
Para gravarmos as mudanças no repositório, devemos executar o comando:
$ git commit -m "Arquivo objetos.txt adicionado a lista"
Observe que foi invocado o comando git commit , com a opção -m para informar a mensagem do commit.
Se executarmos git status novamente, teremos:
# On branch master
nothing to commit, working directory clean
6. Alterando o arquivo
Insira mais uma linha no arquivo objetos.txt , com o conteúdo:
Borracha
Caneta
Depois disso, se executarmos git status novamente, podemos observar que há uma nova mudança para ser rastreada:
# On branch master
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in
working directory)
#
# modified: objetos.txt
#
no changes added to commit (use "git add" and/or
"git commit -a")
7. Rastreando e gravando as alterações no repositório
Para rastrearmos a modificação, devemos executar o comando git add novamente:
$ git add objetos.txt
Com a modificação rastreada, podemos gravá-la no repositório, com o comando git commit:
$ git commit -m "Inserindo dois novos objetos a lista"
8. Verificando alterações realizadas
Para verificar o histórico das alterações gravadas no repositório, podemos executar o comando git log:
$ git log
A saída será parecida com:
commit hash do commit
Author: user.name <user.email>
Date: Data de gravação do commit
Inserindo dois novos objetos a lista
commit hash do commit
Author: user.name <user.email>
Date: Data de gravação do commit
Arquivo objetos.txt adicionado a lista
Atenção que a leitura é feita do commit mais novo para o mais velho.
Pronto! Temos um repositório criado com as alterações no arquivo objetos.txt devidamente gravadas. Mas e agora?
9. Compartilhando seu código através do GitHub
Atenção nesse guia usaremos o método de transferência pela chave SSH, aqui você encontra um tutorial sobre.
O primeiro passo é criar uma conta no GitHub. Para projetos de código aberto, não há custo nenhum! Com um navegador, acesse: https://github.com
Preencha seu nome, e-mail e escolha uma senha.
Criando um repositório no GitHub
Agora podemos criar um repositório remoto para isso, clique no botão New Repository.
No Repository name, devemos preencher o nome do repositório remoto.
No nosso caso, vamos preencher com “lista”. Deixe o repositório como Public, para que qualquer pessoa consiga ver o seu código. As demais opções podem ficar com os valores padrão. Finalmente, devemos clicar em Create repository.
10. Apontando seu projeto para o GitHub
Devemos agora apontar o repositório da nossa máquina para o repositório do GitHub.
Execute o comando git remote , conforme o que segue:
$ git remote add origin git@github.com:user_github/lista.git
Não deixe de alterar user_github para o seu usuário do GitHub.
Com o comando anterior, apontamos o nome origin para o repositório do GitHub.
11. Enviando as alterações para o GitHub
Com o repositório remoto configurado, podemos enviar nossas mudanças para o GitHub. Para isso, basta executar o comando git push , da seguinte forma:
$ git push origin main
Com o comando anterior, enviamos as alterações para o repositório remoto configurado com o nome origin.
Forneça sua senha da chave SSH quando solicitado.
12. Obtendo projeto do GitHub
Com o projeto no GitHub, qualquer um pode acessar o seu projeto público. Se a pessoa tiver cadastrada no GitHub,
será possível baixar o mesmo.
Vamos fazer isso então, crie outro diretório chamado projetos_git e acesse pelo terminal:
$ cd caminho_ate_diretorio/projetos_git
Para obter o código do projeto lá do GitHub, execute o comando git clone conforme o seguinte:
$ git clone git@github.com:user_github/lista.git
Não esqueça de alterar user_github para o seu usuário do GitHub.
Observe no diretório projetos_git que foi criado um subdiretório chamado lista . Dentro desse subdiretório há o arquivo objetos.txt , exatamente com o mesmo conteúdo do GitHub.
Também há um diretório oculto chamado .git , revelando possuimos uma cópia do repositório original.
