Criando primeiro repositório no GitHub

Já falamos em nosso Blog sobre o Git, inclusive aprendemos a instalá-lo em nossos computadores. Você pode conferir esse conteúdo neste link: Instalando e Configurando o Git no Windows, Linux e Mac

Um outro tema relacionado com o Git é o GitHub. Mas, o que é o GitHub? Será que é a mesma coisa que o Git? Iremos responder essas perguntas neste artigo.

O que é o GitHub?

A primeira coisa importante que sempre devemos lembrar é que o GitHub não é a mesma coisa que o Git. Como aprendemos em outro artigo, o Git é um sistema de controle de versão, que gerencia nosso código e as alterações que ocorrem nele. Já o GitHub é uma plataforma, onde podemos hospedar os projetos que criamos. Essa plataforma foi criada em 2008 e hoje pertence à Microsoft (sua compra pela Gigante dos Softwares ocorreu em 2018). Cada projeto adicionado ao GitHub é armazenado em um repositório. Nós usamos o Git para realizar o upload e download dos arquivos de nosso projeto. Vemos assim que o GitHub não é a mesma coisa que o Git, mas ele precisa do Git para existir.

O GitHub, junto com o StackOverflow, são considerados duas das grandes “redes sociais dos programadores”. Podemos adicionar em nosso perfil os projetos que desenvolvemos, e assim a inteira comunidade de desenvolvedores poderá acessá-los. Por isso podemos dizer que o GitHub pode ser considerado o nosso portfólio, e muitas empresas inclusive podem perguntar qual é o nosso perfil no GitHub ao analisar uma vaga de emprego.

Neste artigo iremos aprender a criar uma conta no GitHub e também a criar nosso primeiro repositório.

Criando uma conta no GitHub

O site do GitHub é github.com.

Logo na página inicial veremos à nossa direita um formulário de cadastro, onde podemos informar o nome de usuário que desejamos, nosso email e uma senha. Devemos preencher esses dados e clicar no botão de cadastro, como vemos abaixo:

Na página seguinte iremos iniciar nosso processo de cadastro. Iremos visualizar algum tipo de verificação, como um captcha ou um pequeno jogo, para confirmar que não somos robôs, como vemos abaixo:

A próxima etapa será escolher se desejamos o plano gratuito ou pago dentro dessa plataforma:

Talvez seja necessário validar seu email usando um código que será enviado para sua Caixa de Entrada. Após esses passos nossa conta no GitHub estará criada e validada com sucesso!

Podemos agora criar nosso primeiro repositório!

Criando um repositório

Após estar logados no GitHub, veremos um botão com o desenho de um sinal de mais (+) na parte superior direita da plataforma. Ao clicar nele, um menu dropdown será exibido e iremos escolher a primeira opção, “New repository”:

Seremos direcionados para uma página de criação de um repositório. Devemos informar o nome do repositório que desejamos e uma descrição para ele. Por fim, iremos clicar no botão “Create repository”:

Apenas um detalhe: nós também selecionamos o checkbox para iniciar o repositório com um arquivo README. Esse arquivo irá conter uma descrição de nosso repositório. Essa descrição pode ser curta e sucinta. Contudo, se desejarmos, podemos adicionar mais informações nesse arquivo. Grandes projetos usam o arquivo README para criar até mesmo uma documentação do projeto, com links e tutoriais.

Após criar nosso repositório, veremos a seguinte página:

Essa página representa o nosso repositório, já hospedado no GitHub. Bem simples, não concorda?

Com certeza desejamos adicionar mais arquivos ao nosso repositório. Nós poderíamos editar os arquivos diretamente na plataforma. Contudo, se nosso projeto ficar muito grande, poderá ficar insustentável editar os arquivos apenas no servidor diretamente. É nesse momento que o Git entra em cena. Nós podemos essa ferramenta para realizar o download do código que está na nuvem, criando um repositório local em nosso computador. Daí, iremos realizar mudanças nele localmente e então acrescentar a nova versão do projeto à nuvem.

Para isso, iremos realizar primeiramente o download do repositório. Mas, ao usar o Git, nós não usamos a expressão “realizar um download”, mas sim “realizar um clone”, pois iremos de fato clonar o conteúdo do repositório remoto em nosso local. Para esse fim, iremos usar o comando git clone e informar o link de nosso repositório. Podemos obter essa informação clicando em “Clone or download” e escolhendo a opção de copiar:

Iremos trabalhar com a linha de comando a partir de agora. Será necessário ter o Git instalado para isso. Você pode acessar o artigo em que ensinamos a sua instalação por meio do link que está no início deste artigo.

Se desejar, poderá abrir o seu Terminal padrão ou o Git Bash na Área de Trabalho. Iremos executar o seguinte comando:

git clone https://github.com/anthony1910/first-repository.git

Apenas lembrando que o endereço de seu repositório será diferente do meu :)

Esse comando irá criar uma pasta chamada first-repository, que será nosso repositório local. Para nosso exemplo, iremos criar um arquivo chamado index.php dentro dessa pasta. Seu conteúdo será o seguinte:

<?php

echo 'Esse arquivo está em meu primeiro repositório';

Esse novo arquivo representa uma alteração em nosso repositório. Precisamos agora adicionar essa nova versão do projeto ao repositório remoto. Iremos usar alguns outros comandos do Git que nos ajudarão nesse processo.

O primeiro deles é o git add. Ele adiciona nossos arquivos ao que chamamos de “staging area”, uma expressão que pode ser traduzida como “área de preparação”. Adicionar arquivos a essa área mostra nossa intenção de incorporá-los ao repositório remoto. Vamos usar esse comando em nosso Terminal:

git add index.php

Perceba que informamos apenas o arquivo index.php. Entretanto, em projetos grandes teremos muitos arquivos. Para não precisar incluir um por um, podemos informar a opção “--all”, que adiciona todos os arquivos ao staging area de uma vez:

git add --all

Após adicionar esse arquivo à área de preparação, precisamos descrever a alteração que acabamos de realizar, documentando que aquela mudança foi feita por nós. Para isso usamos o comando git commit. Ele espera um parâmetro chamado “-m”, que representa a mensagem daquele commit. Vamos executá-lo com o comando abaixo:

git commit -m 'First Commit'

Perceba que é importante que a nossa mensagem esteja entre aspas se contiver mais de uma palavra em seu conteúdo. Também é interessante notar como o recurso de commit pode ser útil para nós. Se houver um bom padrão para os commits e se suas mensagens forem bem descritivas, teremos em nossas mãos um excelente sistema de log de alterações, algo muito desejado em qualquer empresa ou projeto.

Agora que já informamos uma descrição para nossa alteração, precisamos de fato “subir” a nova versão para o GitHub. Iremos usar o comando git push para isso. Um parâmetro que ele espera é o nome do remote do repositório e o outro parâmetro é o nome da branch que queremos enviar. Por padrão, iremos usar o comando abaixo:

git push -u origin master

Nesse contexto “origin” é o nosso remote e “master” é a nossa branch principal. Apenas um detalhe: nós também usamos a opção “-u”, que irá criar uma referência de rastreamento para essa branch.

Após executar esse comando veremos o seguinte resultado em nosso Terminal:

Nosso push deu certo, excelente!

Por ser o primeiro commit de nosso projeto não ocorreu nenhum erro. Contudo, conforme o projeto for crescendo e sofrer alterações de vários membros de nossa equipe, poderemos visualizar um erro que solicitará que atualizemos o nosso repositório local com o conteúdo do repositório remoto. Para fazer isso, podemos usar o comando git pull. Ele possui a mesma estrutura do git push:

git pull origin master

Se mesmo após executar esse comando o erro continuar, poderá usar um comando alternativo, que explicamos neste artigo: Git: falha ao enviar os commits para o repositório remoto.

Voltando ao nosso projeto, será que esse novo arquivo está em nosso GitHub de fato? Se voltarmos à página de nosso repositório e a atualizarmos, veremos o seguinte:

Veja que nosso arquivo index.php já está em nosso repositório na nuvem, e a mensagem de nosso commit também está no GitHub. Muito bom, deu tudo certo!

Esse é o processo que usamos para manter nosso projeto sempre atualizado.

Com isso podemos agora criar nossos próprios projetos ou contribuir para projetos de código aberto. Como falamos no início, isso poderá ser o nosso portfólio pessoal.

Gostaria de ler mais sobre Git e GitHub em nosso Blog? Ou teria algum outro tema que você gostaria que falássemos por aqui? Você pode enviar suas sugestões clicando neste link: Sugestões

Até o próximo artigo :)