Feature toggles: tipos, vida útil e remoção

O que é

Um feature toggle (também chamado de feature flag) é uma condição no código cujo valor vem de uma configuração em tempo de execução, e não do build. O artigo citado distingue quatro categorias, de acordo com a vida útil e o dinamismo: toggles de release escondem trabalho inacabado na branch principal (vida curta, estáticos); toggles de experimento dividem os usuários entre variantes (de horas a semanas, decididos a cada requisição); toggles operacionais limitam ou desativam funcionalidades sob carga (acionados manualmente, em geral de vida curta, com alguns mantidos como chaves de emergência permanentes); toggles de permissão («Permissioning Toggles») liberam funcionalidades para determinados grupos de usuários (permanentes, decididos por usuário). O artigo recomenda concentrar a decisão em um «Toggle Router», em vez de espalhar if flag pelo código.

Por que importa

Os toggles viabilizam o trunk-based development, o lançamento gradual e o rollback rápido sem novo deploy. Em compensação, multiplicam os estados em que o sistema pode estar: com dez toggles independentes são 1024 combinações, e os testes cobrem poucas delas. Toggles de release esquecidos se tornam ramificações permanentes que ninguém mais entende.

Como aplicar

• Registrar, para cada toggle, no momento da criação: categoria, finalidade, responsável, data de criação e data prevista de remoção. Toggles de release recebem uma data de validade logo após o lançamento completo.
• Manter a lógica de decisão em um único lugar: o código pergunta «a funcionalidade X está ativa neste contexto?», e não «qual valor está na configuração?». A resposta é injetada como dependência, para que os testes possam forçar os dois lados.
• Testar os dois lados de um toggle de release no pipeline até que ele seja removido: no mínimo o caminho padrão e o caminho com todos os toggles no estado-alvo.
• Tornar visível o estado dos toggles em cada ambiente (uma página ou um endpoint que liste todos os toggles com valor e origem) e registrar as alterações em log.
• Planejar a remoção como tarefa própria: eliminar a condição, apagar o ramo morto, ajustar os testes e limpar a configuração. Toggles vencidos aparecem no backlog como qualquer outra dívida técnica.
• Projetar de forma deliberada, como configuração, os toggles operacionais e de permissão que devem permanecer: documentados, com valor padrão e com proteção de acesso.

Armadilhas

Um toggle que altera formatos de dados não pode simplesmente ser revertido depois que dados foram gravados no novo formato; para isso é preciso aplicar expand and contract. Estados de toggles mantidos em vários sistemas tornam as falhas irreprodutíveis. Toggles consultados por uma string de nome retornam silenciosamente o valor padrão se houver um erro de digitação. Um toggle de experimento que permanece depois do experimento mantém as duas variantes vivas.