6.1.2. O que é o GitHub?

O GitHub é uma plataforma que oferece aos desenvolvedores a possibilidade de hospedar repositórios de código versionados através do sistema git e com uma interface web amigável. Além disso, oferece diversas ferramentas para o desenvolvimento colaborativo. Essas ferramentas vão desde o controle de atividades (issues), áreas de rascunho de código (gist), disponibilização de páginas web (github pages), wikis), até a interface com sistemas de integração contínua. Atualmente, o GitHub hospeda diversos projetos de software livre. Trata-se de um negócio bilionário, o GitHub foi adquirido pela Microsoft em 2018 por cerca de US$7.5 bilhões [1].

Esta seção do curso irá explicar como trabalhar com a ferramenta de versionamento de código fonte git através do GitHub.

6.1.2.1. Criando uma Conta no GitHub

Para seguir as atividades desta seção, você deverá ter uma conta no GitHub. Se ainda não possui uma, você poderá criar uma de maneira gratuita acessando este link (Figura 6.1).

Criando uma conta no GitHub

Figura 6.1 - Criando uma conta no GitHub.

Nota

Sugestão: adote um nome curto e significativo para seu usuário. Exemplo: gqueiroz, gilberto-queiroz, gribeiro. Este nome formará a base de seus futuros repositórios e, consequentemente, quanto mais simples e fácil de lembrar, mais fácil será de usar o GitHub.

Na janela seguinte (Figura 6.2), selecione a opção Join a free plan para que sua conta seja criada:

Opção por um plano gratuito

Figura 6.2 - Opção por um plano gratuito.

Algumas outras informações sobre o uso pretendido do GitHub podem ser apresentadas ao usuário nas janelas seguintes, bem como a informação de confirmação do e-mail associado à conta. Após o processo de registro da sua conta, você deverá chegar em uma janela semelhante à apresentada na Figura 6.3:

Profile do usuário

Figura 6.3 - Profile do usuário.

Como pode ser observado na Figura 6.3, essa janela permite que você acompanhe os repositórios de código criados por você ou copiados de outros usuários do GitHub (os chamados forks) para sua conta, os projetos em que você se encontra associado, pacotes publicados por você [2], repositórios destacados por você, quem você segue e quem são seus seguidores no GitHub.

6.1.2.2. Criando um Repositório para Hospedar Código

Para criar um novo repositório de código, onde você poderá incluir arquivos do seu projeto e utilizar a ferramenta git para controlar o versionamento desses arquivos, selecione opção New repository como indicado na Figura 6.4:

Menu - Novo repositório

Figura 6.4 - Menu - New repository.

Um formulário como o apresentado na Figura 6.5 será apresentado.

Criando um novo repositório

Figura 6.5 - Criando um novo repositório.

Repare na Figura 6.5 que:

  • Você poderá definir o proprietário desse novo repositório. Neste exemplo, o proprietário foi definido como sendo o próprio usuário gilberto-queiroz.

  • O nome do repositório também deve ser breve e significativo (exemplo: ser-347).

  • Você poderá informar uma breve descrição sobre o repositório, que será exibida na página principal do novo repositório, logo após sua criação.

  • Os repositórios podem ser públicos ou privados. No exemplo, estamos criando o repositório de maneira pública.

  • Também estamos indicando que o repositório deverá ser criado com a inclusão de alguns arquivos especiais:

    • README: essa opção fará com que um arquivo chamado README.md seja automaticamente adiconado ao novo repositório criado. Este arquivo recebe um tratamento especial do GitHub, que sempre ao localizar um arquivo com esse nome na estrutura de um repositório, utiliza seu conteúdo para apresentar aos usuários.

    • .gitignore: este arquivo irá dizer ao git quais arquivos e diretórios deverão ser ignorados na estrutura do seu repositório. Como estamos trabalhando com a linguagem Python, podemos escolher o modelo indicado na caixa de seleção para a linguagem Python. Assim, já teremos os nomes de alguns arquivos e diretórios que apesar de existirem localmente nas nossas máquinas, não deverão ser incluídas no repositório.

    • license: também vamos optar por incluir no nosso repositório um arquivo com o modelo de licença (MIT).

Após a criação do repositório, uma página como a mostrada na Figura 6.6 será apresentada:

Repositório ser-347

Figura 6.6 - Repositório ser-347.

Nessa janela temos:

  • O repositório ser-347 está vinculado ao usuário gilberto-queiroz.

  • A página de um repositório possui várias abas que permitem obter informações desse repositório. Por padrão, é exibida a aba de código (<> Code).

  • Na aba de código, podemos ver:

    • A descrição dada ao repositório: Projeto da Disciplina SER-347.

    • Os arquivos que fazem parte do repositório (.gitignore, LICENSE, README.md).

    • A exibição na forma de HTML do conteúdo do arquivo README.md.

A seguir, iremos utilizar o git para realizar algumas tarefas básicas, como criar uma cópia desse repositório na nossa máquina local, adicionar novos arquivos, modificar o conteúdo de um dado arquivo e atualizar o repositório no GitHub a partir da nossa cópia local.

Footnotes