O que é o GitHub?

  • 8 minutos

Nesta unidade, analisamos os seguintes objetivos de aprendizagem:

  • Breve visão geral da plataforma empresarial GitHub
  • Como criar um repositório
  • Adicionando arquivos a um repositório
  • Como pesquisar repositórios
  • Introdução aos gists e wikis

GitHub

Antes de explorarmos a plataforma GitHub em detalhes, é importante entender em que ela é construída: o Git.

O Git é um sistema de controle de versão distribuído que permite aos desenvolvedores rastrear alterações, colaborar em código e gerenciar revisões ao longo do tempo. O GitHub se baseia no Git adicionando ferramentas de colaboração, recursos de automação e uma interface web amigável. Compreender os conceitos básicos do Git, como confirmações, ramificações e mesclagem, ajudará você a usar o GitHub de forma mais eficaz.

Uma imagem conceitual da plataforma GitHub com camadas de cima para baixo: IA, colaboração, produtividade, segurança e escala.

O GitHub é uma plataforma baseada em nuvem que usa o Git, um sistema de controle de versão distribuído, em seu núcleo. A plataforma GitHub simplifica o processo de colaboração em projetos e fornece um site, ferramentas de linha de comando e fluxo geral que permite que desenvolvedores e usuários trabalhem juntos.

Como aprendemos anteriormente, o GitHub fornece uma plataforma de desenvolvedor alimentada por IA para criar, dimensionar e fornecer software seguro. Vamos detalhar cada um dos principais pilares da plataforma GitHub Enterprise, IA, Colaboração, Produtividade, Segurança e Escala.

IA

A IA generativa está transformando drasticamente o desenvolvimento de software. A plataforma GitHub Enterprise melhora a colaboração por meio de solicitações pull e problemas alimentados por IA, a produtividade por meio de Copilot, Copilot Chat e Copilot Agents, e a segurança fornecendo feedback mais rápido para melhorar a segurança.

Colaboração

A colaboração está no centro de tudo o que o GitHub faz. O GitHub oferece ferramentas que ajudam as equipes a trabalhar juntas de forma eficiente, reduzindo atrasos e simplificando fluxos de trabalho.

Repositórios, problemas, solicitações pull e outras ferramentas ajudam a oferecer suporte a uma colaboração mais rápida entre funções, encurtar os ciclos de aprovação e melhorar a velocidade de entrega.

Produtividade

A produtividade é acelerada com a automação que a plataforma empresarial GitHub oferece. Com ferramentas integradas de CI/CD (Continuous Integration and Continuous Delivery) diretamente integradas ao processo de desenvolvimento, a plataforma permite que os usuários automatizem tarefas repetitivas e acelerem o trabalho diário. Isso permite que os desenvolvedores se concentrem mais na codificação e na resolução de problemas.

Segurança

O GitHub integra a segurança diretamente no processo de desenvolvimento desde o início e em todos os estágios. O GitHub Enterprise inclui recursos nativos primários, como CodeQL, verificação secreta, Dependabot e visão geral de segurança para minimizar riscos. O código permanece privado, enquanto ainda se beneficia de verificações de segurança integradas.

O GitHub continua a investir em segurança e conformidade de nível empresarial. Com a confiança da Microsoft e de organizações em setores altamente regulamentados, o GitHub adere aos padrões globais de conformidade, tornando-se uma escolha confiável para desenvolvimento seguro em escala.

Escala

O GitHub é a maior comunidade de desenvolvedores do gênero, com dados em tempo real de mais de 100 milhões de desenvolvedores, 420 milhões de repositórios e inúmeras implantações. O GitHub aprende e evolui continuamente seus produtos. Sua grande base de usuários fornece uma perspetiva diversificada sobre o que os desenvolvedores precisam, impulsionando a inovação contínua para atender a essas necessidades. Ao mesmo tempo, o GitHub é uma plataforma extensível — desenvolvedores de código aberto de todo o mundo contribuem e aprimoram os recursos que tornam o GitHub excecional.

Isso se traduziu em uma escala incrível que é incomparável e sem paralelo com qualquer outra empresa no planeta. Os insights dessa grande base de desenvolvedores ajudam o GitHub a evoluir continuamente a plataforma.

Em essência, a plataforma empresarial GitHub se concentra na experiência do desenvolvedor. Ele fornece ferramentas de colaboração, automação e recursos orientados por IA que suportam produtividade, segurança e escalabilidade em uma experiência unificada de desenvolvedor.

Agora vamos entrar na espinha dorsal do GitHub, os repositórios.

Introdução aos repositórios

Vamos primeiro analisar:

  • O que é um repositório?
  • Como criar um repositório
  • Adicionando arquivos a um repositório
  • Como pesquisar repositórios
  • Introdução a gists, wikis e páginas do GitHub

O que é um repositório?

Um repositório contém todos os arquivos do seu projeto e o histórico de revisões de cada arquivo. É uma das partes essenciais que o ajuda a colaborar com as pessoas. Você pode usar repositórios para gerenciar seu trabalho, controlar alterações, armazenar histórico de revisões e trabalhar com outras pessoas. Antes de nos aprofundarmos muito, vamos começar com como criar um repositório.

Como criar um repositório

Você pode criar um novo repositório em sua conta pessoal ou em qualquer organização onde tenha permissões suficientes.

Vamos explicar como criar um repositório a partir de github.com.

  1. No canto superior direito de qualquer página, abra o menu suspenso e selecione Novo repositório.

    Uma captura de tela do menu suspenso do sinal de mais no canto superior direito do GitHub.com, com a primeira opção sendo Novo repositório.

  2. Utilize o menu suspenso Proprietário para selecionar a conta que irá possuir o repositório.

    Uma captura de ecrã do menu suspenso sobre quem deve ser o dono do novo repositório.

  3. Digite um nome para o repositório e uma descrição opcional.

    Uma imagem da caixa de texto do nome do repositório destacada.

  4. Escolha uma visibilidade de repositório.

    • Os repositórios públicos são acessíveis a todos na Internet.

    • Os repositórios privados só são acessíveis a si, às pessoas com quem partilha explicitamente o acesso e, no caso dos repositórios da organização, a determinados membros da organização.

  5. Selecione Criar repositório e parabéns! Você acabou de criar um repositório!

Como clonar um repositório

A clonagem de um repositório permite criar uma cópia local de um repositório no seu computador. Isso é útil para fazer alterações localmente e sincronizá-las de volta ao repositório remoto.

  1. No GitHub.com, navegue até a página principal do repositório que você deseja clonar.

  2. Acima da lista de arquivos, clique no botão Código .

    Captura de tela do menu suspenso do botão Código com opções de clonagem.

  3. Copie a URL do repositório usando a opção HTTPS, SSH ou CLI do GitHub.

  4. Abra o terminal e navegue até o diretório onde deseja clonar o repositório.

  5. Execute o seguinte comando, substituindo <repository-url> pelo URL copiado:

    git clone <repository-url>

  6. Quando o processo de clonagem estiver concluído, navegue até a pasta do repositório:

    cd <repository-name>

Parabéns! Agora você tem uma cópia local do repositório.

Em seguida, vamos analisar como adicionar arquivos ao seu repositório.

Como adicionar um arquivo ao repositório

Os arquivos no GitHub podem fazer um punhado de coisas, mas o principal objetivo dos arquivos é armazenar dados e informações sobre seu projeto. Para adicionar um arquivo a um repositório, você precisa de pelo menos acesso de gravação .

Vamos analisar como adicionar um arquivo ao seu repositório.

  1. No GitHub.com, navegue até a página principal do repositório.

  2. No repositório, navegue até a pasta onde deseja criar um arquivo selecionando o link criando um novo arquivo ou carregando um arquivo existente.

  3. Depois de adicionar, acima da lista de ficheiros, selecione o menu suspenso Adicionar ficheiro ᐁ. Em seguida, selecione Criar novo arquivo.

    Uma captura de tela da opção para adicionar um arquivo ao seu novo repositório realçada em vermelho com o botão adicionar arquivo à direita da tela.

  4. No campo nome do arquivo, digite o nome e a extensão do arquivo. Para criar subdiretórios, digite o separador de / diretório.

  5. Na caixa de texto conteúdo do arquivo, digite o conteúdo do arquivo.

  6. Para rever o novo conteúdo, acima do conteúdo do ficheiro, selecione Pré-visualizar.

    Captura de ecrã a mostrar um ficheiro yml com o botão de pré-visualização realçado no canto superior esquerdo.

  7. Selecione Confirmar alterações.

  8. No campo Mensagem de confirmação , digite uma mensagem de confirmação curta e significativa que descreva a alteração feita no arquivo. Você pode atribuir a confirmação a mais de um autor na mensagem de confirmação.

  9. Se você tiver mais de um endereço de e-mail associado à sua conta no GitHub.com, selecione o menu suspenso de endereço de e-mail. Em seguida, selecione o endereço de e-mail para usar como o endereço de e-mail do autor do Git. Apenas os endereços de e-mail verificados aparecem neste menu pendente. Se você ativou a privacidade do endereço de e-mail, [username]@users.noreply.github.com é o endereço de e-mail padrão do autor da confirmação.

    Captura de tela mostrando uma alteração de confirmação com uma caixa de descrição e o menu suspenso do e-mail para selecionar como o autor da confirmação.

  10. Abaixo dos campos Mensagem de confirmação , decida se deseja adicionar sua confirmação à ramificação atual ou a uma nova ramificação. Se sua ramificação atual for a ramificação padrão, você deverá optar por criar uma nova ramificação para sua confirmação e, em seguida, criar uma solicitação pull.

    Captura de tela mostrando a criação de uma nova ramificação a partir de uma opção de confirmação selecionada com a caixa de texto da nova ramificação abaixo dela.

  11. Selecione Confirmar alterações ou Propor alterações.

Parabéns, você acabou de criar um novo arquivo no seu repositório! Você também criou uma nova ramificação e fez um compromisso.

Antes de revisarmos ramificações e confirmações na próxima unidade, vamos revisar rapidamente gists, wikis e páginas do GitHub, pois elas são semelhantes a repositórios.

O que são Gists?

Os Gists são um recurso do GitHub que permite aos usuários compartilhar trechos de código, notas ou outras pequenas informações de forma leve e conveniente. Eles são essencialmente mini repositórios Git, o que significa que você pode bifurcar, clonar e controlá-los como um repositório completo. Os Gists são particularmente úteis para compartilhar soluções rápidas, arquivos de configuração ou exemplos sem a necessidade de criar um repositório completo.

Principais características do Gists:

  1. Elementos Públicos e Secretos:

    • Gists Públicos: Estes são visíveis para todos e podem ser descobertos através da funcionalidade de pesquisa do GitHub. Eles são ideais para compartilhar trechos de código ou soluções que você deseja disponibilizar para a comunidade em geral.
    • Essências Secretas: Estas não são pesquisáveis ou listadas publicamente, mas não são totalmente privadas. Qualquer pessoa com o URL pode acessá-los. Eles são úteis para compartilhar código com um público limitado, como colaboradores ou amigos.

  2. Controle de versão:

    • Todas as alterações feitas em uma essência são rastreadas, permitindo que você visualize o histórico de edições. Isso facilita a reversão para uma versão anterior ou veja como o trecho evoluiu ao longo do tempo.

  3. Falsificação e clonagem:

    • Como os repositórios, os gists podem ser bifurcados e clonados. Isto permite que outros desenvolvam o seu trabalho ou o adaptem às suas necessidades.

  4. Incorporação:

    • Os Gists podem ser incorporados em sites ou blogs, tornando-os uma ótima ferramenta para compartilhar exemplos de código em tutoriais ou documentação.

  5. Suporte a Markdown:

    • O Gists suporta a formatação Markdown, o que significa que você pode incluir rich text, títulos, links e até imagens ao lado do seu código. Isso é particularmente útil para adicionar contexto ou explicações aos seus trechos.

  6. Collaboration:

    • Embora os gists sejam normalmente usados para trechos individuais, eles também podem ser compartilhados e colaborados por vários usuários. Forjar e comentar em gists permitem uma colaboração leve.

Casos de uso para Gists:

  • Compartilhamento de exemplos ou soluções de código rápido.
  • Armazenamento de arquivos de configuração ou scripts para uso pessoal.
  • Criação de modelos para padrões de código comumente usados.
  • Partilhar registos de erros ou depurar informações com outras pessoas.
  • Incorporação de trechos de código em blogs, fóruns ou documentação.

[! IMPORTANTE]

Nunca use gists para armazenar dados confidenciais, como senhas, segredos ou chaves de API, mesmo em scripts ou arquivos de configuração.
Gists não são totalmente privados: até mesmo gists secretos podem ser acessados por qualquer pessoa com o link. Reveja sempre o seu conteúdo cuidadosamente antes de o partilhar.

Limitações do Gist:

  • Os gists não são inteiramente privados, mesmo que marcados como secretos. Qualquer pessoa com o URL pode acessá-los, portanto, eles não devem ser usados para informações confidenciais ou confidenciais.
  • Eles são mais adequados para pequenos trechos ou arquivos únicos. Para projetos maiores ou estruturas com vários arquivos, um repositório completo é mais apropriado.

Para saber mais sobre como criar e gerenciar gists, consulte a documentação do GitHub na seção Recursos deste módulo ou visite a documentação do GitHub.

Forjar e clonar Gist

Você pode bifurcar uma essência para criar uma cópia da essência de outra pessoa em sua conta.

  1. Navegue até a essência que você deseja bifurcar.
  2. Selecione Forquilha no canto superior direito da página inicial.

Para clonar uma essência localmente:

git clone https://gist.github.com/your-gist-id.git

Para saber mais sobre gists, consulte o artigo vinculado em nossa seção Recursos no final deste módulo intitulado Creating Gists.

O que são wikis?

Cada repositório no GitHub.com vem equipado com uma seção para hospedar documentação, chamada wiki. Você pode usar o wiki do repositório para compartilhar conteúdo de forma longa sobre seu projeto, como usá-lo, como você o projetou ou seus princípios fundamentais. Enquanto um arquivo LEIA-ME informa rapidamente o que seu projeto pode fazer, você pode usar um wiki para fornecer documentação adicional.

Vale a pena lembrar que, se o seu repositório for privado, apenas as pessoas que tiverem pelo menos acesso de leitura ao seu repositório terão acesso ao seu wiki.

Criação, edição e exclusão de páginas wiki

Você pode usar o wiki do GitHub para criar e gerenciar a documentação do seu projeto.

Para criar uma página wiki:

  1. Navegue até o repositório.
  2. Selecione a guia Wiki .
  3. Selecione Criar a primeira página se não existirem páginas ou Nova página para adicionar uma página.
  4. Introduza um título e conteúdo e, em seguida, selecione Guardar Página.

Para editar uma página wiki:

  1. Navegue até a página wiki que deseja editar.
  2. Selecione Editar no canto superior direito.
  3. Faça alterações e selecione Salvar página.

Para excluir uma página wiki:

  • Excluir uma página wiki requer o uso do Git. Clone o repositório wiki, remova o arquivo e envie a alteração.

Saiba mais sobre como gerenciar wikis no GitHub Docs - Adicionar ou editar páginas wiki.

O que são Pré-visualizações de Funcionalidades?

As visualizações de recursos permitem que você experimente recursos experimentais no GitHub antes que eles sejam lançados oficialmente. Estas pré-visualizações dão-lhe acesso antecipado a novas funcionalidades e permitem-lhe fornecer feedback para ajudar a moldar o produto final.

Para ativar ou desativar uma pré-visualização de funcionalidades:

  1. Navegue até sua conta do GitHub selecionando sua foto de perfil no canto superior direito do GitHub.com.
  2. Selecione Visualização de recursos no menu suspenso.
  3. Navegue pela lista de visualizações disponíveis e alterne os recursos que deseja experimentar.

As visualizações de recursos são uma ótima maneira de se manter à frente e explorar novas ferramentas que podem aprimorar sua experiência no GitHub.

Sugestão

O GitHub frequentemente adiciona novos recursos experimentais para os usuários explorarem, portanto, fique de olho na revisão de recursos para descobrir novas ferramentas e aprimoramentos.