Software · Soluções na Prática

Feature Toggles e Trunk-Based Development: Separando Deploy de Release

Como desacoplar a entrega técnica de software da disponibilização comercial: as quatro categorias de feature flags, branches de vida curta no Trunk-Based Development e o ciclo de eliminação de dívida técnica.

Diagrama de fluxo de trabalho Git exibindo branch principal trunk com merges frequentes e flags condicionais controlando a ativação de funcionalidades em produção
Neste artigo

Em modelos tradicionais de versionamento com branches de longa duração (como fluxos clássicos de GitFlow), funcionalidades complexas permanecem isoladas por semanas ou meses em branches paralelas. Quando chega o momento de integrar esse código à linha principal, a equipe enfrenta o temido conflito de merges massivos (merge hell), testes de regressão demorados e lançamentos arriscados em finais de semana.

A combinação entre Trunk-Based Development e Feature Toggles (Feature Flags) elimina essa dor ao quebrar um paradigma histórico: Deploy e Release não são o mesmo evento.

  • Deploy: É uma ação estritamente técnica. Significa instalar novos binários no servidor ou cluster e validar que o serviço inicializa com saúde.
  • Release: É uma decisão de produto e de negócio. Significa tornar a funcionalidade visível e utilizável por um grupo de usuários finais.
gitGraph
    commit id: "v1.0"
    commit id: "Base trunk"
    branch feat-checkout
    checkout feat-checkout
    commit id: "Commit parcial 1"
    commit id: "Commit parcial 2 (com Flag off)"
    checkout main
    merge feat-checkout id: "Merge rápido (<24h)"
    commit id: "Deploy em Produção (Inativo)"
    commit id: "Ativação da Flag (Release)"

A Dinâmica do Trunk-Based Development

No Trunk-Based Development, todos os engenheiros integram seu trabalho diariamente na branch principal (main ou trunk). Branches individuais duram poucas horas e nunca mais de um ou dois dias.

Para permitir que código ainda incompleto chegue com segurança ao ambiente de produção sem quebrar os usuários ativos, o fluxo de execução é envelopado por uma Feature Flag:

public class CheckoutController : ControllerBase 
{
    private readonly IFeatureManager _featureManager;
    private readonly IOrderProcessor _legacyProcessor;
    private readonly IOrderProcessor _v2Processor;

    public CheckoutController(
        IFeatureManager featureManager,
        IOrderProcessor legacyProcessor,
        IOrderProcessor v2Processor) 
    {
        _featureManager = featureManager;
        _legacyProcessor = legacyProcessor;
        _v2Processor = v2Processor;
    }

    [HttpPost("processar")]
    public async Task<IActionResult> ProcessCheckout([FromBody] CheckoutRequest request) 
    {
        // Alternância em tempo de execução sem redeploy da aplicação
        if (await _featureManager.IsEnabledAsync("NovoFluxoCheckoutInstantaneo")) 
        {
            return Ok(await _v2Processor.ProcessAsync(request));
        }

        return Ok(await _legacyProcessor.ProcessAsync(request));
    }
}

As Quatro Categorias de Feature Toggles

Nem todas as flags possuem o mesmo propósito nem devem ter a mesma longevidade. A taxonomia consagrada por Pete Hodgson classifica as flags em quatro categorias fundamentais:

Categoria da Flag Dinamismo Longevidade Responsável Primário Exemplo em Produção
Release Toggles Estático ou por ambiente Curta (dias a poucas semanas) Engenharia de Software Esconder fluxo novo até validação de testes
Experiment Toggles Dinâmico por usuário / sessão Média (duração do teste A/B) Produto / Growth Teste de conversão de 2 layouts de carrinho
Ops Toggles (Kill Switches) Dinâmico e reativo Longa (permanente) Engenharia de Operações / SRE Desligar recurso pesado quando CPU > 85%
Permission Toggles Dinâmico por tenant / plano Longa (permanente) Comercial / Atendimento Liberar módulo Pro apenas para clientes pagantes

O Perigo da Dívida Técnica Acumulada

O maior risco da adoção descuidada de feature flags é a proliferação descontrolada de ramificações no código. Cada instrução if (flag) duplica os caminhos lógicos da aplicação, aumentando a complexidade ciclomática e dificultando a manutenção se as flags antigas nunca forem removidas.

Para manter a base limpa e sustentável, as equipes de alto desempenho estabelecem quatro práticas de higiene:

  1. Ciclo de Vida com Data de Expiração: Cada Release Toggle é criado com um prazo máximo de permanência (por exemplo, 30 dias após o rollout completo a 100%).
  2. História de Remoção no Backlog: Quando uma flag é criada, uma tarefa correspondente de limpeza de código é aberta imediatamente no backlog do sprint seguinte.
  3. Padrão Strategy em vez de ifs Espalhados: Em vez de salpicar condicionais em dezenas de arquivos, injete implementações inteiras desacopladas usando o container de injeção de dependência condicionado pela flag.
  4. Armazenamento Centralizado: Em ambientes Azure, utilizar serviços dedicados como o Azure App Configuration permite alterar valores de flags em tempo real com envio imediato via WebSocket para todas as instâncias, sem necessidade de reiniciar servidores.
flowchart LR
    AppConfig["Azure App Configuration"] -->|Atualização dinâmica em tempo real| AppService1["Instância Web 1"]
    AppConfig -->|Atualização dinâmica em tempo real| AppService2["Instância Web 2"]
    AppConfig -->|Atualização dinâmica em tempo real| BackgroundWorkers["Workers em Background"]

Com esse desacoplamento, a área de negócios ganha liberdade para lançar produtos quando o marketing estiver preparado, enquanto a equipe de tecnologia mantém o fluxo contínuo de entrega de software com estabilidade diária comprovada pelas métricas DORA.

Explorar este tema no Grafo de Conhecimento