O objetivo desse repositório é ensinar os primeiros passos, desde a configuração até o uso diário, do git, com apoio da plataforma GitHub.
É um software de código aberto para controle de versões de arquivos, apesar de ser voltado à área de desenvolvimento de software, ele pode ser utilizado para quaisquer tipos de arquivos, por exemplo, versionamento de documentos e trabalhos de conclusão de curso.
O Git foi publicado originalmente em abril de 2005 e foi desenvolvido pelo mesmo desenvolvedor do linux, Linus Torvalds, atualmente é o sistema de versionamento mais utilizado por uma ampla gama de profissionais na área.
Esse sistema possui uma série de diferenciais quando comparado a outros softwares de versionamento, caso queira saber mais, veja aqui.
É uma plataforma de hospedagem de código fonte, amplamente utilizada por milhares de usuários diariamente, tanto para projetos pessoais ou faculdade, quanto para uso profissional e código aberto.
A empresa foi fundada em 2008, sendo posteriormente adiquirida pela Microsoft, tendo crescido tanto que em julho de 2022 tinha cerca de 83 milhões de usuários na plataforma.
Antes de tudo, já crie sua conta no GitHub, ela é gratuita, mas vale a pena linkar seu email da sua instituição de ensino, você pode ganhar diversos benefícios, entre eles o GitHub PRO, que te permite ter ilimitados repositoriórios privados (sem o PRO só se pode ter 1 por conta).
O Git pode ser instalado em todos os principais sistemas operacionais da atualidade, sendo presente nativamente no Mac e kernel Linux.
Antes de se instalar, verifique se o seu sistema já não possui o git instalado, para isso, abra o terminal e digite o comando:
$ git version
Caso tenha o git instalado, ele vai imprimir na tela a versão instalada no seu computador no seguite formato:
> git version 2.35.1.windows.2
Caso o Git não esteja instalado, ele mostrará o erro que o comando "git" não é conhecido. Logo, o mesmo deve ser instalado clicando aqui.
Com o git instalado, agora deve-se configurar o usuario e e-mail para poder utilizar o mesmo.
Abra o terminal e digite o seguinte comando:
$ git config --global user.name "Seu usuario"
// substitua pelo seu nome de usuárioPara confirmar se o usuario foi cadastrado corretamente, execute o seginte comando, que deve retornar o seu usuário criado:
$ git config --global user.name
> Seu usuario
Abra o terminal e digite o seguinte comando:
$ git config --global user.email "seu.email@exemplo.com"
// substitua pelo seu emailPara confirmar se o email foi cadastrado corretamente, execute o seginte comando, que deve retornar o seu email cadastrado
$ git config --global user.email
> seu.email@exemplo.com
Um repositório, muitas vezes chamado de repo, é um diretório especial que possui uma sub-pasta oculta ".git/" que armazena todo o histórico do seu projeto, por isso, pense muito bem antes de mexer com ela.
Para criar o seu primeiro repo, é recomendado segui os seguintes passos:
-
Crie uma nova pasta no seu computador, pode ser com qualquer nome, utilizaremos "tutorial-git" durante esse guia.
-
Abra a pasta criada no seu editor de preferência, aqui usaremos o VScode.
-
Crie um arquivo "README.md", esse arquivo estará presente em praticamente todos os repositórios que você ver, ele é utilizado para passar quaisquer informações uteis sobre o repositório para os usuários e contribuidores dele.
- A extensão ".md" do arquivo criado, se refere a liguagem de marcação "MarkDown", com marcadores faceis de se entender e utilizar, outro exemplo de linguagem de marcação é o HTML, muito usado em desenvolvimento WEB.
-
No arquivo criado, escreva a descrição do repositório, por exemplo:
Este é o meu primeiro repositório git! -
Não se esqueça de salvar o arquivo depois da edição!
-
Seu repositório deve estar assim:
-
Abra o terminal na pasta desejada
- No windows, com a pasta aberta no explorador de arquivos, pode-se abrir direto na pasta desejada ao digitar "cmd" e confirmando no enredeço do diretório
-
utilize o seguinte comando para inicializar seu repo:
$ git init -
Caso seja bem sucedido, o comando retornará o seguinte resultado:
> Initialized empty Git repository in {path}/tutorial-git/.git/
Pronto, com isso, seu repositório está criado, com sua pasta /.git adicionada. Agora tá na hora de conhecer o que o git tem a oferecer.
Ao se utilizar um repositório do git, existem 3 camadas principais em que os arquivos podem transitar, sendo eles:
-
Working directory, ou área de desenvolvimento, é o ambiente em que ocorre as edições ativas dos arquivos, a camada que é mais utilizada;
-
Staging area, ou área de preparação, é o ambiente em que se juntam um os arquivos modificados em um grupo para enviá-los ao repositório;
-
Repository, ou repositório, é a camada final em que os arquivos estão armazenados e possui o registro de todas as modificações que ocorreram desde a criação do mesmo.
-
Para mover um arquivo modificado para a área de preparação, deve-se utilizar o comando "git add <nome do arquivo>", no caso do tutorial:
git add README.md -
Caso queira confirmar o resultado, deve-se executar o comando:
git statusComando que retorna os status das mudanças realizadas, ele deve estar na seguinte forma:
On branch master No commits yet Changes to be committed: (use "git rm --cached <file>..." to unstage) // comando utilizado para reverter o git add. new file: README.md
-
Agora vem o comando que mais falam por ai, o "git commit", esse que move os arquivos adicionados pela etapa anterior para o repositório. Ele funciona no seguinte formato:
git commit -m "primeiro commit" // sendo esse "-m" para inserir a mensagem atrelada ao commit, nesse caso, "primeiro commit".
-
Esse comando retorna o seguinte resultado:
[master (root-commit) 2b041d1] primeiro commit 1 file changed, 1 insertion(+) create mode 100644 README.md -
Por fim, recomenda-se alterar o nome da Branch principal de master para main da seguinte forma:
git branch -M "main"
-
Existem diversas interfaces graficas que auxiliam nas etapas realizadas acima, já utilizei duas delas, o GitHub Desktop e o GitKraken, ambas muito boas, no site do git você pode encontrar diversos softwares que fazem isso, encontre o que te agrada mais.
-
Nesse tutorial, vou utilizar o GitHub na versão WEB mesmo. Vamos para essa etapa agora mesmo.
-
Após estar com conta criada e logado, na barra a esquerda vai ter um botão verde de criação de novo repositório
-
Clique nele e será redirecionado a página de criação do repositório.
-
Na página de criação, de um nome para o seu repositório e uma descrição.
-
Após isso, vá ao final da página e confirme a criação do repositório.
-
Vai aparecer uma série de opções de o que fazer com esse repositório:
-
Como já temos o repositorio criado local, vamos na segunda opção, deve-se copiar os códigos e cola-los no terminal:
git remote add origin https://github.com/dartmol203/first-repo.git git branch -M main git push -u origin main
- A primeira linha faz uma conexão entre o seu repositório local com o repositório no GitHub;
- A segunda linha renomeia a branch principal para "main", coisa que já fizemos anteriormente mas não traz problemas fazer novamente;
- Já a última linha, ela envia os commits feitos, no caso apenas 1, para o repositorio conectado pela primeira linha.
-
O resultado dos comando vai ser algo no seguinte formato:
Enumerating objects: 3, done. Counting objects: 100% (3/3), done. Writing objects: 100% (3/3), 264 bytes | 264.00 KiB/s, done. Total 3 (delta 0), reused 0 (delta 0), pack-reused 0 To https://github.com/dartmol203/first-repo.git * [new branch] main -> main branch 'main' set up to track 'origin/main'. -
Após isso, podemos recarregar a página do GitHub e as nossas alterações estarão lá!!
-
Uma branch é uma ramificação do seu repositório, a main que foi citada acima é a ramificação principal, mas um repo pode ter inúmeras ramificações.
-
Uma branch sempre é ramificada de outra branch, muitas vezes vão sair da main, mas qualquer branch pode ser ramificada novamente.
-
vamos criar uma branch para editar o README que criamos.
-
para criar uma branch pelo terminal deve-se usar o seguinte comando, já no seu repositório de trabalho:
>> git branch update-readme -
Para verificar se a branch foi criada, podemos executar o comando "git branch", o qual retorna as branchs existentes e em qual você está
>> git branch * main update-readme
-
A branch foi criada com sucesso, agora temos que mudar a ramificação que estamos trabalhando, para isso, usamos o comando "git checkout <nome da branch>"
>> git checkout update-readme Switched to branch 'update-readme'
-
É possivel fazer os dois passos anteriores com apenas uma linha de comando, utilizando o "git checkout -b <nome da branch>"
-
Dessa forma, sua branch está criada.
-
Para jogar suas mudanças para o GitHub, deve-se fazer os passos de commit ensinados anteriormente:
>> git add <nome do arquivo> >>git commit -m "update README.md" [update-readme bb32a58] update README.md 1 file changed, 3 insertions(+), 1 deletion(-)
-
E por fim, fazer o "git push"
>> git push origin update-readme Enumerating objects: 5, done. Counting objects: 100% (5/5), done. Delta compression using up to 8 threads Compressing objects: 100% (2/2), done. Writing objects: 100% (3/3), 332 bytes | 166.00 KiB/s, done. Total 3 (delta 0), reused 0 (delta 0), pack-reused 0 remote: remote: Create a pull request for 'update-readme' on GitHub by visiting: remote: https://github.com/dartmol203/first-repo/pull/new/update-readme remote: To https://github.com/dartmol203/first-repo.git * [new branch] update-readme -> update-readme
-
Se você atualizar seu GitHub, sua branch nova vai estar lá!
-
Para criar uma nova branch pelo GitHub é bem simples, basta clicar no botão na parte superior a esquerda e indicar o nome da branch que deve ser criada.
como puxar pro local pelo terminal!!
-
A fim de juntar duas branchs, utilizamos o comando "git merge", ele deve ser utilizado quando estando na branch base e chamando a branch que vai escrever por cima;
>> git checkout main >> git merge update-readme Updating 2b041d1..bb32a58 Fast-forward README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
-
E por fim, enviar para o GitHub com o "git push":
>> git push origin main Total 0 (delta 0), reused 0 (delta 0), pack-reused 0 To https://github.com/dartmol203/first-repo.git 2b041d1..bb32a58 main -> main
-
Para trabalhar em equipe, há 2 formas principais de se fazer isso:
-
Participar como colaborador do repositório -> você tem direitos de alterar o repo, tem diversos níveis de permissões que o dono pode ceder aos participantes;
-
Copiar o repositório para a sua conta e propor mudanças por meio de um Pull Request (PR) -> esse metódo é muito usado para contribuir em software open-source.
-
-
Nesse tutorial, vamos focar na segunda forma citada acima.
-
Com o GitHub, é possivel copiar o repositório para o seu perfil por meio de um "fork".
-
Para realizar o fork, entre no repositório que quiser clonar e no canto superior direito, clique em "fork"
-
Ao clicar, você vai ser redirecionado para uma página para resolver algumas informações sobre o fork, recomendo criar sem qualquer alteração, basta utilizar o botão "create fork".
-
Agora que já tem seu fork do repositório, basta clonar o repo para o local por meio do "git clone":
>> git clone https://github.com/dartmol203/Tutorial-git-github.git Cloning into 'Tutorial-git-github'... remote: Enumerating objects: 55, done. remote: Counting objects: 100% (55/55), done. remote: Compressing objects: 100% (54/54), done. remote: Total 55 (delta 19), reused 0 (delta 0), pack-reused 0 Receiving objects: 100% (55/55), 404.66 KiB | 388.00 KiB/s, done. Resolving deltas: 100% (19/19), done.
-
Lembre-se de colocar o link do seu repositório, você pode pegar o link no fork no seu perfil, no canto superior direito
- faça todas as mudanças que julgar necessário, utilizando os conceitos citados acima (Branch, add, commit, push...)
-
Após ter feito o commit com suas mudanças no seu fork, volte ao GitHub, no seu repositório vai ter a opção de comparar e criar um Pull Request (PR), clique nela.
-
Um PR é uma requisição para se mesclar (dar merge) entre duas branches, nesse caso, estamos fazendo entre dois repositórios.
-
PR's são essenciais para manter a segurança e qualidade de códigos, não é o ideal a pessoa que criou o PR aprovar o mesmo.
-
-
Ao clicar, você vai ser redirecionado para a tela de criação do PR, lá vai ter diversas informações importantes, como o destino e a origem das modificações e a descrição das mudanças realizadas.
-
Lembre-se de SEMPRE colocar nome e descrição significativos!
-
Para finalizar, basta clicar no botão "create pull request" e esperar o dono do repositório avaliar suas mudanças, aprovando, recusando ou requisitando mudanças para poder ser aceito.
-
Para encerrar o tutorial, proponho um desafio, fazer uma contribuição a esse repositorio, criando um arquivo novo <nome de usuário>.md na pasta /_colaboradores, seguindo o padrão a baixo:
--- user: <nome do seu usuario> time: aaaa-mm-dd hh:mm:ss quote: <resposta da pergunta a seguir> --- -
Responda a seguinte pergunta: O que achou do tutorial e qual poderia ser o próximo assunto a ser tratado?
-
Lembre-se de não utilizar caracteres especiais no seu arquivo.
Espero que o tutorial tenha sido útil! quaisquer sugestões de melhora podem me enviar um email em andre.correa.silva203@gmail.com ou fazer o Pull Request que avaliaremos e fazemos o merge!
Até o próximo tutorial!