Feature Flags e Trunk-Based Development na Prática: Separando Deploy de Release

Código-fonte, integração contínua e engenharia de software

Por que branches de longa duração travam a entrega contínua e como colocar código em produção todos os dias sem expor funcionalidades inacabadas ao usuário.

Em muitas equipes de engenharia, a sexta-feira ainda é tratada como dia proibido para deploys. O motivo quase nunca é falta de capacidade técnica do time, mas um acoplamento estrutural perigoso: a empresa trata Deploy (ato técnico de subir código para o servidor) e Release (ato de negócio de liberar uma funcionalidade para o cliente) como se fossem a mesma coisa.

Quando esses dois conceitos estão colados, os times recorrem a branches de longa duração no Git (como no GitFlow tradicional), mantendo códigos isolados por semanas até que a funcionalidade esteja 100% pronta para o lançamento comercial. O resultado é previsível: conflitos gigantescos de merge, filas de homologação congestionadas e deploys traumáticos que empacotam dezenas de alterações de uma só vez.

Para quebrar esse ciclo e atingir verdadeira agilidade de entrega, a combinação que sustenta os times de alta performance é Trunk-Based Development aliado a Feature Flags.


O Problema: O Inferno do Merge e o Rollback Tudo-ou-Nada

Branches que vivem por duas ou três semanas criam uma falsa sensação de isolamento. Na prática, elas acumulam três passivos graves:

  • Merge Hell: Quanto mais tempo o código fica fora da branch principal (main), maior a chance de colidir com refatorações de outros colegas, gerando resoluções de conflito arriscadas.
  • Testes Tarde Demais: O código só é integrado de verdade às vésperas da subida, quando o custo de corrigir qualquer incompatibilidade é máximo.
  • Rollback Destrutivo: Se três squads sobem suas entregas juntas em um mesmo pacote e uma delas apresenta bug em produção, reverter o binário inteiro no Kubernetes joga fora também as entregas saudáveis dos outros dois times.

O Cenário do Desastre:

Três times trabalham em paralelo no módulo de checkout durante 18 dias. Na quinta-feira à noite, fazem o merge de todas as branches para a release. Após o deploy, um erro intermitente surge no novo cálculo de frete. Como não há chave de desligamento, a equipe precisa reverter a versão inteira da aplicação — tirando do ar uma correção urgente de pagamento que outro time havia acabado de entregar.


A Solução: Separando Deploy de Release

Ao adotar Trunk-Based Development com Feature Flags (também chamadas de Feature Toggles), mudamos completamente a dinâmica do fluxo de valor:

  1. Integração Contínua Real: Todos os desenvolvedores integram pequenas fatias de código diariamente na main. Funcionalidades em construção ficam protegidas atrás de uma flag desligada por padrão.
  2. Dark Launching e Canary Rollout: O código já roda em produção, mas invisível para o público geral. Você pode ativar a feature primeiro apenas para o time interno (QA/PMs), depois para 5% dos usuários e, só após validar métricas de erro e latência, liberar para 100%.
  3. Kill Switch Instantâneo: Se algo der errado após o lançamento, você não precisa rodar um novo pipeline de rollback. Basta virar a chave da flag em tempo real (via Redis, LaunchDarkly, Flagsmith ou Azure App Configuration) e o sistema retorna ao fluxo anterior em milissegundos.

Implementação Prática em C# (.NET): Rollout Controlado com FeatureManagement

No ecossistema .NET, a biblioteca oficial Microsoft.FeatureManagement permite integrar flags declarativas com extrema elegância, mantendo o código limpo e testável:

// MotorFreteService.cs
using Microsoft.FeatureManagement;

public interface IMotorFrete
{
    Task CalcularAsync(string cepDestino, decimal pesoKg);
}

public class CalculoFreteService
{
    private readonly IFeatureManager _featureManager;
    private readonly IMotorFrete _motorLegado;
    private readonly IMotorFrete _motorNovoV2;

    public CalculoFreteService(
        IFeatureManager featureManager,
        IMotorFrete motorLegado,
        IMotorFrete motorNovoV2)
    {
        _featureManager = featureManager;
        _motorLegado = motorLegado;
        _motorNovoV2 = motorNovoV2;
    }

    public async Task ObterValorFreteAsync(string cepDestino, decimal pesoKg)
    {
        // Ponto único de decisão (Strategy) controlado em tempo real
        bool usarNovoMotor = await _featureManager.IsEnabledAsync("NovoMotorFreteV2");

        if (usarNovoMotor)
        {
            return await _motorNovoV2.CalcularAsync(cepDestino, pesoKg);
        }

        return await _motorLegado.CalcularAsync(cepDestino, pesoKg);
    }
}

Repare que não espalhamos dezenas de condicionais pelo domínio: isolamos a escolha na fronteira usando o padrão Strategy. Se o novo motor apresentar latência anormal em produção, desligar a flag NovoMotorFreteV2 redireciona 100% do tráfego de volta ao motor legado instantaneamente.


As Três Regras de Ouro das Feature Flags em Produção

  1. Toda Flag Precisa de Data de Validade: Feature flags temporárias de lançamento que nunca são removidas transformam o código-fonte em um labirinto de caminhos mortos. Crie a tarefa de limpeza no backlog no exato momento em que a flag atingir 100% de adoção.
  2. Isole os Pontos de Decisão: Evite espalhar if (_featureManager.IsEnabledAsync(...)) dentro de dezenas de métodos internos. Centralize o desvio na camada de roteamento, controller ou fábrica de serviços (Factory/Strategy).
  3. Valide Ambos os Estados no CI: Sua suíte de testes automatizados deve garantir que o sistema continua saudável tanto com a flag ligada quanto com a flag desligada, evitando surpresas no momento de virar a chave em produção.

Conclusão

Maturidade em DevOps e entrega contínua não se mede por deploys heroicos cheios de tensão uma vez por mês; mede-se pela tranquilidade de tornar o deploy um evento rotineiro e entediante.

Quando você adota Trunk-Based Development e separa o momento técnico do deploy do momento estratégico do release com Feature Flags, o seu time ganha velocidade real, reduz drasticamente o raio de impacto de falhas e devolve ao negócio o controle total sobre o ritmo das entregas.