O que é o GitHub e para que serve
O GitHub é uma plataforma que hospeda repositórios Git e reúne em volta de cada um a revisão por pull request, a automação do GitHub Actions e a publicação de releases. Quando você envia um commit com git push, o histórico chega ao repositório remoto e dispara os workflows configurados para testar o código, por isso a revisão e a versão marcada com tag partem de um resultado conferido.
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
O Git registra, o GitHub hospeda
O Git é o sistema de controle de versão que roda na sua máquina. Cada commit guarda uma fotografia dos arquivos do projeto. Quando você clona um repositório, a cópia traz o histórico completo, com todos os commits desde o primeiro. A documentação do GitHub descreve o Git como o sistema de controle de versão distribuído mais popular. Como cada cópia tem o histórico inteiro, o seu notebook volta a um commit antigo mesmo sem conexão com a internet.
O GitHub entra quando esse histórico precisa sair da máquina. Ele hospeda o repositório como remoto: o git push envia para lá os commits locais de uma branch. O git pull faz o caminho contrário e traz para a sua cópia o que chegou de outras máquinas. Até aqui o GitHub funciona como um servidor de Git. O trabalho muda com o que a plataforma acrescenta em volta do repositório, como as issues, os pull requests, os workflows e as releases, todos ligados aos mesmos commits.
Essa separação aparece no dia a dia. Um repositório clonado do GitHub continua sendo um repositório Git completo. Você pode enviá-lo para outro serviço sem perder um commit. Já os comentários de uma revisão, os registros de execução do Actions e as notas de uma release moram na plataforma e não viajam dentro da pasta .git.
Do commit à release no mesmo repositório
Dentro do GitHub, uma alteração começa como commit numa branch e vira proposta de merge num pull request. Depois passa pelas checagens do GitHub Actions e pela revisão, entra na branch principal e, quando forma uma versão, recebe uma tag e uma release. Cada etapa grava um registro consultável no próprio repositório:
Commit na branch
git pushOs commits da sua branch chegam ao repositório remoto com autor, data e mensagem.
Pull request
gh pr createA branch vira proposta de merge, com a comparação dos arquivos alterados.
Checagens
.github/workflows/Os workflows do Actions rodam testes e builds e mostram o resultado no pull request.
Merge
gh pr mergeCom a revisão aprovada e as checagens verdes, o código entra na branch principal.
Release
gh release createA tag marca o commit da versão e a release publica as notas e os arquivos.
A vantagem de ter tudo no mesmo lugar está na ligação entre os registros. A release aponta para a tag, a tag aponta para um commit, o commit pertence a um pull request e o pull request guarda a revisão e o resultado dos workflows. Quando um bug aparece numa versão publicada, você volta dessa versão até o pull request que trouxe a alteração e lê a discussão que aconteceu na época.
O fluxo que a Promovaweb segue
Os projetos da Promovaweb ficam no GitHub, cada um no próprio repositório, com versão, changelog, workflows e releases independentes. O contrato interno de publicação exige uma versão nova pelo SemVer para toda alteração publicada. Junto com ela vêm o changelog atualizado, as validações do repositório, uma tag Git nova e uma GitHub Release com as mesmas notas do changelog. Uma tag publicada não se move: uma correção que chega depois recebe outra versão. As páginas Releases e tags e Pull requests e revisão explicam o papel de cada uma dessas peças.
Nesse contrato, a plataforma funciona como registro de publicação. O website da Promovaweb sai pela integração ligada ao repositório no GitHub: o push da branch principal com a tag nova é o que publica a versão. A conferência final olha a release remota, porque ela mostra que tag, notas e commit chegaram juntos ao repositório.
Plataforma proprietária, CLI aberta
O GitHub pertence à GitHub, Inc., subsidiária da Microsoft. A plataforma é proprietária e não publica um número de versão único, porque o GitHub.com recebe mudanças continuamente. O GitHub Enterprise Server, que as empresas instalam nos próprios servidores, tem numeração separada e fica fora deste portal.
O GitHub CLI, o comando gh, é a parte aberta. O código fica no repositório cli/cli sob licença MIT. Cada versão sai como release no próprio GitHub. A referência técnica deste portal é a v2.104.0, publicada em 12 de novembro de 2026, que exige uma confirmação extra para apagar um repositório privado com forks. Os comandos das páginas seguem o manual dessa versão. A página GitHub CLI mostra o que o gh faz no terminal.
Fica no repositório Git
- Os commits, com autor, data, mensagem e o conteúdo dos arquivos.
- As branches e as tags, inclusive a tag de cada versão.
- Os arquivos de configuração, como os workflows em
.github/workflows/. - O histórico completo em cada clone, consultável sem internet.
Fica na plataforma GitHub
- Os pull requests, com os comentários e as aprovações da revisão.
- Os registros de execução dos workflows do Actions.
- As releases, com as notas e os arquivos anexados.
- As issues, os alertas de segurança e as permissões de acesso.
O que continua com você
O GitHub hospeda o histórico, mostra a revisão e executa os workflows, mas não escolhe a versão nem escreve o changelog. Quando uma alteração vira versão nova, qual número ela recebe e o que vai nas notas são definições do seu projeto. A plataforma gera notas a partir dos pull requests. A leitura do texto que vai a público continua sendo trabalho seu.
A plataforma também não roda o seu app em produção. O Actions executa testes e builds em máquinas que existem só durante a execução. O resultado de uma release costuma seguir para outro destino, como um registro de imagens, o npm ou a VPS que hospeda o serviço. O próximo assunto é o repositório por dentro: o que ele guarda, como o Git monta cada commit e o que muda quando esse histórico chega ao GitHub, na página Repositórios e Git.