Ir para o conteúdo
Promovaweb
Portal independente da Promovaweb

GitHub Cada mudança revisada e testada antes de publicar.

O GitHub é uma plataforma que hospeda o repositório Git do seu projeto, com a revisão, os testes e as versões publicadas em volta dele. No pull request, você lê o comentário do revisor e o resultado dos testes antes de aprovar o merge.

Plataforma proprietária da GitHub, Inc., subsidiária da Microsoft. O GitHub CLI tem código aberto sob licença MIT. Assuntos conferidos na versão 2.104.0.

Escolha um assunto para seguir uma alteração do commit até a versão publicada.
  1. HistóricoCada clone guarda o autor e a data das alterações.
  2. RevisãoO revisor comenta a linha antes do merge.
  3. TestesCada push roda os testes numa máquina limpa.
  4. ReleasesA tag aponta o commit exato de cada versão.

Do commit à versão publicada, cada alteração deixa registro no 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 Actions e a publicação de releases.

O Git fica na sua máquina e o GitHub mantém a cópia remota

O Git roda na sua máquina e guarda cada commit como uma fotografia dos arquivos. O GitHub entra quando esse histórico precisa sair dela: o git push envia os commits de uma branch ao repositório remoto e o git pull traz o que chegou de outras máquinas. Um clone feito do GitHub continua sendo um repositório Git completo.

Em volta do repositório, a plataforma acrescenta o pull request, os workflows do Actions, as releases e os alertas de segurança, todos ligados aos mesmos commits. A release aponta para a tag, a tag aponta para um commit e o commit pertence a um pull request com a revisão e o resultado dos testes.

Uma versão com bug leva você de volta ao pull request que a trouxe

  • A versão sem origem conhecida. A release fica montada sobre uma tag que marca o commit exato. Quando um bug aparece, você volta da versão até o pull request que trouxe a alteração.
  • O teste que só roda numa máquina. O workflow do Actions roda os testes a cada push ou pull request numa máquina virtual nova. O resultado aparece no próprio pull request.
  • A revisão perdida em mensagens soltas. Os comentários linha a linha e as aprovações ficam no pull request, junto da comparação dos arquivos alterados.
  • A chave enviada por engano. O secret scanning procura tokens no histórico inteiro e o Dependabot compara as dependências com o GitHub Advisory Database. Os alertas aparecem no próprio repositório.

Os checks do Actions rodam antes de o merge entrar na main

Cada etapa grava um registro consultável no repositório, do commit enviado pela branch até a versão publicada.

  1. CommitOs commits da branch chegam ao repositório remoto.
  2. Pull requestA branch vira proposta de merge, com a comparação dos arquivos.
  3. ChecagensOs workflows rodam testes e builds e mostram o resultado.
  4. MergeCom a revisão aprovada e as checagens verdes, o código entra na main.
  5. ReleaseA tag marca o commit e a release publica notas e arquivos.
Os comentários da revisão, os registros do Actions e as notas da release moram na plataforma. Eles não viajam dentro da pasta .git de um clone.
Veja como o pull request leva a alteração à main

Faz diferença em projeto com mais de um desenvolvedor mexendo no código

  • Projeto com mais de um desenvolvedor. Cada alteração passa por um pull request com revisão e testes antes de chegar à branch principal.
  • Versões publicadas com tag e notas. Tag, notas e arquivos saem juntos na release. A Promovaweb segue esse contrato em cada projeto, com SemVer e changelog.
  • Automação ligada ao repositório. O Actions testa e gera o build a cada evento. O gh repete os mesmos passos num script ou num agente.

O Actions só existe durante a execução dos testes

  • Rodar o app em produção. O Actions executa testes e builds em máquinas que existem só durante a execução. O app segue para um registro de imagens, para o npm ou para a VPS.
  • Instalação nos seus próprios servidores. O GitHub Enterprise Server tem numeração separada e fica fora deste portal.

Número de versão e servidor de produção são escolhas do seu projeto

  • A versão e o changelog. O número da versão e o texto das notas são definições do seu projeto. A plataforma gera notas a partir dos pull requests, mas a leitura do texto público continua com você.
  • O servidor de produção. A release costuma seguir para outro destino, como um registro de imagens, o npm ou a VPS que hospeda o serviço.
  • O que não mora no Git. Pull requests, registros do Actions e notas de release ficam na plataforma. Levar o repositório para outro serviço preserva os commits, sem essas camadas.
Mantenedor
GitHub, Inc., subsidiária da Microsoft.
Versão de referência
GitHub CLI v2.104.0, a mesma usada nos assuntos deste portal.

Variáveis que ajustam o GitHub CLI no terminal

Veja o que cada variável ajusta

Onde o GitHub economiza o seu tempo

Você acompanha os checks do Actions no pull request e consulta a tag que identifica o commit de cada release.

Changelog

Últimas versões do GitHub CLI

Ver o changelog completo
  1. GitHub CLI 2.104.0Breaking changeLer as notas

Portais relacionados

Sistemas ligados a este nas stacks e nos projetos, cada um com o próprio portal.

Continue na comunidade

Leve ao Discord da Promovaweb o workflow que falha só no Actions ou a release que saiu sem os arquivos. Com o log da execução na conversa, a comunidade compara o seu caso com projetos parecidos.

Uma VPS para o que sai da sua release

O Actions roda os testes e o build em máquinas que existem só durante a execução. O app que sai da release precisa de um servidor: a VPS da StayCloud em São Paulo vem com acesso root e disco NVMe.

Ver a VPS da StayCloud

Link de parceiro da Promovaweb.