O que significa «nightly» em software: os 5 canais de release

«Nightly» é o build produzido automaticamente a partir do código do dia — normalmente empacotado uma vez por noite, sem uma passagem completa de regressão e sem promessa de estabilidade. Ele existe para desenvolvedores e testadores, não para usuários. Na escada dos canais de release, o nightly está o mais longe possível da produção: antes do alpha, muito antes do beta e a uma boa distância do stable. A definição é curta, mas os times misturam nightly, alpha e beta o tempo todo. O custo não é um rótulo errado: é um bug reportado do nightly sendo tratado como incidente de produção, ou o contrário, um crash que só existe no nightly sendo dispensado com «alguém já deve ter reportado» e nunca corrigido.

Por que se chama «nightly»

Antes da CI ser comum, compilar era trabalho pesado: o código entrava no tronco o dia inteiro, à noite as máquinas ficavam livres, então rodava um build completo e uma bateria de testes automatizados, e pela manhã havia uma versão instalável. Como acontecia à noite, virou nightly build — e a versão, um nightly. Hoje a maioria dos times compila a cada merge, então «nightly» é menos um horário do que uma promessa sobre estabilidade: produzido automaticamente, sem revisão humana, pode quebrar a qualquer momento. Entre o nightly-20261110 que você vê e o nightly-20261109 não existe promessa de compatibilidade nem suíte de regressão para pegar o que passa.

Os cinco canais lado a lado

Canal Quem executa Frequência Estabilidade Objetivo principal Quem consegue
nightly Os próprios desenvolvedores, automação Toda noite ou a cada merge Nem é garantido que suba Achar cedo problemas que «só quebram ao juntar» Interno, normalmente não distribuído
alpha QA interno, poucos usuários semente Quando as funcionalidades estão mais ou menos usáveis Funcionalidades mudam e faltam Validar a direção Somente por convite
beta Testadores externos, primeiros clientes Por marco Fluxos principais funcionam, detalhes verdes Coletar feedback em ambiente real Inscrição ou liberação gradual
RC (release candidate) Responsável pelo release Sob demanda após o congelamento Só correções bloqueantes Confirmar que dá para publicar Interno mais alguns clientes
stable Todos os usuários No ritmo das versões Compatibilidade retroativa prometida Uso em produção Todo mundo
Uma regra útil: se um problema também reproduz no stable, não é questão de canal, é defeito; se só reproduz no nightly, suspeite primeiro do build ou de uma funcionalidade inacabada. Essa regra economiza muita discussão inútil entre times.

Três confusões comuns com nightly

1. Mandar o nightly para o cliente como «ambiente de preview»

Nightly é para vocês, não para clientes. Quando o cliente vê um crash, um layout torto ou dados estranhos, você gasta o dobro do tempo explicando que «isso é um build interno». Para preview, use beta ou um RC, nunca nightly.

2. Usar beta como nightly

O inverso é igualmente comum: o time não tem nightly, então os usuários beta recebem um build novo todo dia. Usuários beta estão ali para dar feedback, não para servir de máquina de regressão de graça; a paciência deles acaba mais rápido do que você imagina.

3. Achar que «compila todo dia» significa «é testado todo dia»

O valor do nightly está em achar problemas cedo — desde que alguém olhe o resultado. Sem smoke tests automatizados e sem ninguém dar uma olhada no status do build pela manhã, nightly é só um artefato ocupando disco.

Cada canal exige um feedback diferente

Esta é a camada mais esquecida: quanto mais cedo o canal, mais o relato precisa de informação de localização em vez de qualidade de descrição.
Canal Ruído tolerado O que o relatório precisa trazer O que fazer quando quebra
nightly Alto (metade pode ser falso positivo) Identificador do build (qual noite, qual commit), URL da página, erro literal Devolver direto para quem fez o merge naquele dia; não agendar
alpha Médio Nome da funcionalidade, passos de reprodução, print Decidir se é «não terminado» ou «feito errado»
beta Baixo Ambiente, gravação, requisições com falha Entrar no processo formal de defeitos e classificar
RC Muito baixo Abrangência, se existe contorno Só duas saídas: corrigir ou adiar o release
stable Tolerância zero Contexto completo, número de usuários afetados Processo de incidente, com rollback e comunicação
Para o nightly, «de qual noite é o build» importa muito mais do que «quão detalhado o usuário foi»: no dia seguinte o código muda e ninguém consegue reproduzir.

Fazer cada relato carregar o seu canal

É o passo de engenharia mais barato e o menos feito. Três formas, da mais simples à mais cara:
  • Canal na URL: nightly.example.com, staging.example.com e beta.example.com para ambientes distintos, com example.com como produção. Quando a ferramenta captura a URL da página, o canal vem junto.
  • Build no caminho: por exemplo /build/20261110.3/, ou um parâmetro ?build= na URL de preview — atenção: parâmetros sensíveis precisam ser mascarados na geração do relatório.
  • Declarado pela aplicação hospedeira: numa integração via SDK, o site decide a qual projeto ou tenant o relato pertence e passa ele mesmo a identidade de quem enviou, em vez de deduzi-la de um cookie.
  • Com o canal identificado, é preciso fazer disso roteamento em vez de tudo cair numa caixa só. O BugCapturer aplica regras sobre o host e o caminho da URL da página: relatos de nightly.example.com/ vão para a tabela ou o canal de «ruído de build», e example.com/checkout/ vai direto para o time de pagamentos; sem correspondência entra a rota padrão, e sem rota padrão sobra apenas um link de compartilhamento. O resultado: os testadores não escolhem «qual ambiente é» no envio, nem «para quem vai». Dois dropdowns a menos fazem diferença visível na taxa de envio.

    Aposentar o feedback do nightly no fim do dia

    Relatos de nightly têm prazo de validade. Não deixe que contaminem o registro de longo prazo:
    • Arquivar por dia: os relatos do build de ontem hoje quase não significam nada — guarde só as estatísticas (quantos por dia, em qual módulo se concentram).
    • Promover apenas dois tipos: o que também reproduz no stable vira defeito formal; o mesmo crash três dias seguidos no nightly significa que alguém fez merge de código ruim sem olhar o status do build — converse com a pessoa, não abra ticket.
    • Não dar prioridade a relatos de nightly: prioridade pressupõe saber «quem é afetado», e os únicos usuários do nightly são vocês.
    Com essa disciplina, os times passam a reportar problemas no nightly com muito mais disposição — porque reportar não exige escrever um relatório completo.

    Uma política mínima de canais para copiar

    Item Regra
    Domínios example.com (stable), beta.example.com, nightly.example.com; os três ambientes não compartilham cookies
    Número do build Visível no rodapé ou no primeiro segmento do caminho da URL
    Algo quebrou no nightly No mesmo dia, postar «build + print + erro» no canal; sem ticket
    Algo quebrou no beta Entra no processo de defeitos; alguém assume em 24 horas
    Algo quebrou no stable Processo de incidente, com plano de rollback
    Entradas de feedback Extensão para interno, widget ou SDK para externo; as duas no mesmo workspace
    O único trabalho técnico real é colocar o canal automaticamente no relato. Com a extensão não é preciso envolvimento de desenvolvimento: a URL da página é capturada no print. Com o SDK, o próprio site passa identidade e vínculo.

    Três usos errados comuns

    • Fazer demonstração para cliente a partir do nightly: o código da noite anterior a uma demo é o menos estável possível; risco e benefício estão completamente desequilibrados.
    • Tratar nightly como substituto do beta: sem testadores externos, o nightly só verifica que «o código não explode ao juntar», nunca que «os usuários vão conseguir usar».
    • Trocar de canal sem trocar de dados: apontar um ambiente de preview para o banco de produção transforma um erro de operação em incidente real de dados. Isolamento de canais começa com isolamento de dados.

    Qual deles você realmente precisa?

    A versão de uma frase: nightly para desenvolvimento, alpha para a direção, beta para usuários reais, RC para o responsável pelo release, stable para todos. Se hoje você só tem stable e um «ambiente de teste», normalmente não precisa de nightly imediatamente: adicione beta primeiro. Faltar beta significa que nada nunca foi validado com usuários reais; faltar nightly só significa que os problemas aparecem um pouco mais tarde. Para montar um beta, leia o guia completo de beta testing; para a diferença entre os dois, veja alpha vs beta testing.

    Perguntas frequentes

    Nightly é a mesma coisa que daily build? No essencial, sim. Daily build enfatiza «uma vez por dia»; nightly enfatiza «produzido automaticamente à noite». A maioria dos times compila a cada merge e os dois termos continuam significando «produzido automaticamente, sem revisão humana». Dá para entregar um nightly para clientes? Não é recomendável. Não há rede de regressão nem promessa de compatibilidade; se algo quebrar, você não consegue prometer prazo de correção. Bugs encontrados no nightly devem ser reportados? Sim, mas sem abrir ticket. Poste no canal do dia com número do build, URL da página e erro literal; só o que pode virar defeito formal entra no registro. Números de build do nightly conflitam com versões semânticas? Não. Nightly usa data ou identificador de commit (como 20261110.3), o stable usa versionamento semântico (como 1.4.5). São sistemas diferentes — não misture na mesma coluna. Como ler erros de front-end no nightly? No mínimo você precisa do erro literal e da requisição com falha. Manualmente são os painéis Console e Network do DevTools; depender de prints feitos à mão não escala, então sai mais barato deixar a ferramenta de relato capturar automaticamente. Sobre o que é capturado, veja contexto automático. O feedback do nightly deve ir para o Jira? Normalmente não. Se a regra de vocês é «ninguém olha se não estiver no Jira», dê ao nightly um projeto ou status próprio em vez de misturar com defeitos formais — senão a triagem se afoga em ruído. Veja o guia de triagem de bugs.