Ir para o conteúdo
Promovaweb

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
  1. O Git registra, o GitHub hospeda
  2. Do commit à release no mesmo repositório
  3. O fluxo que a Promovaweb segue
  4. Plataforma proprietária, CLI aberta
  5. O que continua com você

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:

  1. Commit na branch

    git push

    Os commits da sua branch chegam ao repositório remoto com autor, data e mensagem.

  2. Pull request

    gh pr create

    A branch vira proposta de merge, com a comparação dos arquivos alterados.

  3. Checagens

    .github/workflows/

    Os workflows do Actions rodam testes e builds e mostram o resultado no pull request.

  4. Merge

    gh pr merge

    Com a revisão aprovada e as checagens verdes, o código entra na branch principal.

  5. Release

    gh release create

    A tag marca o commit da versão e a release publica as notas e os arquivos.

O caminho de uma alteração no GitHub: cada etapa grava um registro no repositório, do commit enviado pela branch até a release que publica a versão com tag.

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.

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.