Ir para o conteúdo
Promovaweb

Repositórios e Git no GitHub

Um repositório do GitHub é a pasta do projeto com todo o histórico do Git, hospedada num endereço próprio e com dono, visibilidade e permissões definidas. Cada git push acrescenta os seus commits a esse histórico remoto, por isso qualquer clone feito depois recebe as mesmas versões dos arquivos, com autor e data de cada alteração.

Ficha e sumário da página

Referência técnica
GitHub CLI v2.104.0
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. Arquivos e o histórico de cada arquivo
  2. O que fica dentro de um repositório
  3. Dono, visibilidade e permissões
  4. A branch principal com proteção
  5. O mesmo repositório pelo terminal

Arquivos e o histórico de cada arquivo

A documentação do GitHub define o repositório como o lugar que guarda o código do projeto junto com o histórico de revisões de cada arquivo. Essa última parte é a que diferencia um repositório de uma pasta compartilhada. A pasta mostra o estado atual. O repositório mostra também cada estado anterior, com a mensagem que explica por que o arquivo mudou.

O Git monta esse histórico com commits, que são fotografias dos arquivos num momento. Cada commit recebe um hash, o SHA, calculado a partir do conteúdo. Ele também aponta para o commit anterior, o que forma uma corrente de referências do commit mais novo até o primeiro. Por causa dessa corrente, uma alteração antiga não pode ser editada em silêncio: mudar um commit gera outro SHA e muda todos os que vêm depois dele.

As branches organizam essa corrente em linhas de desenvolvimento separadas. A branch principal, chamada main nos projetos da Promovaweb, guarda o código que já passou pela revisão. Uma branch de trabalho guarda as alterações em andamento sem mexer na principal. No GitHub, cada branch enviada com git push aparece no repositório e pode virar um pull request.

O que fica dentro de um repositório

O conteúdo de um repositório é o projeto em si, mas alguns arquivos e pastas têm papel definido pela plataforma. O GitHub lê esses caminhos para montar a página do repositório e para rodar a automação. Um deles indica os revisores de cada pasta. A estrutura abaixo segue o padrão dos projetos da Promovaweb publicados no GitHub:

  • meu-projeto/A raiz do repositório, com o histórico do Git na pasta oculta .git.
  • README.mdExibido na página inicial do repositório, para o visitante que chega pelo navegador.
  • LICENSEA licença do código, que o GitHub identifica e mostra na lateral da página.
  • CHANGELOG.mdO registro das versões, de onde saem as notas de cada release.
  • .github/Configurações que a plataforma lê e o Git versiona como qualquer arquivo.
  • workflows/ci.ymlUm workflow do Actions, em YAML, com os testes de cada push.
  • CODEOWNERSOs donos de cada pasta, chamados para revisar quando ela muda.
  • src/O código do projeto, a parte que o seu app de fato executa.
A estrutura de um repositório no GitHub: o código do projeto fica ao lado dos arquivos que a plataforma lê para exibir a página, rodar os workflows e escolher os revisores.

O ponto que costuma surpreender é que a configuração da automação também é código versionado. Os workflows ficam em .github/workflows/, em arquivos .yml ou .yaml que entram no histórico como qualquer outro arquivo do projeto. Por isso uma mudança no processo de build passa pela mesma revisão de uma mudança no código, enquanto um commit antigo mostra como o build funcionava na época.

Dono, visibilidade e permissões

Todo repositório tem um dono, que pode ser o seu perfil pessoal no GitHub ou uma organização. Na organização, vários membros dividem a administração e as permissões ficam por repositório. A visibilidade define o alcance da leitura. Um repositório público fica acessível para qualquer visitante da internet. Um privado fica restrito a você, aos colaboradores que você convida e, num repositório de organização, aos membros com acesso a ele. O tipo interno existe só para as organizações do GitHub Enterprise Cloud que pertencem a uma enterprise.

A permissão de escrita libera o push de branches, o merge de pull requests e a criação e a edição de releases. Já a leitura permite clonar, abrir issues e comentar numa revisão. Nos projetos abertos da Promovaweb, a leitura é pública e a escrita fica com os mantenedores. Uma contribuição externa chega por fork e pull request.

  • PúblicoQualquer visitante lê o código e o histórico. É o modo dos projetos abertos.
  • PrivadoSó você, os colaboradores convidados e os membros autorizados da organização enxergam o repositório.
  • InternoVisível para os membros de uma empresa no GitHub Enterprise Cloud.

A branch principal com proteção

Um repositório recém-criado aceita push direto na main de qualquer colaborador com escrita. A proteção de branch muda esse comportamento. Com ela ligada, o GitHub recusa o merge de um pull request sem o número de aprovações configurado ou sem as checagens obrigatórias em verde. O force push numa branch protegida fica desligado por padrão, assim como a exclusão da branch.

A proteção aparece de novo nas páginas seguintes, porque ela liga o repositório à revisão e ao Actions. A opção de histórico linear, por exemplo, faz o GitHub recusar merge commits e aceitar só squash ou rebase. A página Pull requests e revisão explica a diferença entre esses três métodos de merge.

O mesmo repositório pelo terminal

O grupo gh repo do GitHub CLI cuida do repositório pelo terminal. O gh repo clone baixa o histórico completo, o gh repo view mostra a descrição e o README sem abrir o navegador e o gh repo create cria o repositório remoto a partir da pasta local. Na v2.104.0, o gh repo delete exige uma confirmação extra para apagar um repositório privado ou interno que tenha forks, mesmo com a opção --yes. Scripts e agentes só seguem com a opção --accept-cascading-deletion-of-private-forks na linha de comando.

Essa confirmação existe porque apagar um repositório privado leva junto os forks privados dele. O commit continua existindo nos clones locais, mas as issues, os pull requests e as releases somem da plataforma. O próximo assunto é o pull request: como uma branch vira proposta de merge e o que a revisão confere, na página Pull requests e revisão.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.