Trunk-based development e feature flags
Integre continuamente: mantenha os branches curtos, faça merge na main todo dia e esconda o trabalho inacabado atrás de feature flags.
- Explicar por que branches de vida longa causam o “inferno dos merges” e atrasam a entrega
- Praticar o trunk-based development com branches pequenos e de vida curta
- Usar feature flags para separar o deploy do código do lançamento das funcionalidades
Na antiga Byte Bakery, cada funcionalidade vivia no próprio branch por semanas. O branch do “cardápio sem glúten” tinha 6 semanas e estava 340 commits atrás da main quando finalmente foi integrado - o que levou dois dias de três pessoas, e quebrou o checkout mesmo assim.
Integração contínua originalmente significava uma prática, não uma ferramenta: todo mundo integra o seu trabalho na linha principal compartilhada pelo menos uma vez por dia, para que os conflitos sejam pequenos e encontrados cedo. O trunk-based development torna isso o padrão:
- Todo mundo faz commit na
main(o trunk, ou tronco) diretamente ou por branches de vida curta, que duram horas, não semanas - de preferência integrados em menos de um dia. - A
mainestá sempre pronta para release. Todo merge é construído e testado, e umamainquebrada é corrigida (ou a mudança revertida) na hora. - Trabalhos maiores são divididos em passos pequenos e seguros - e as funcionalidades inacabadas ficam escondidas atrás de feature flags.
Feature flags: deploy não é lançamento
Uma feature flag (feature toggle) é um interruptor em tempo de execução em volta de código novo. A funcionalidade de assinatura de pão de fermentação natural pode ser integrada e implantada todo dia enquanto está desligada para os clientes, depois ligada para a equipe interna, depois para 5% dos clientes e então para todos - sem nenhum deploy. Se ela der problema, desligá-la é o rollback mais rápido que existe.
Há tipos de flags: flags de release (temporárias, para distribuições graduais), de experimento (testes A/B), de operação (interruptores de emergência para funcionalidades caras) e de permissão (funcionalidades premium). As distribuições por porcentagem precisam ser fixas: calcule o hash do ID do usuário, para que cada usuário veja sempre a mesma coisa.
1import zlib
2
3def is_enabled(flag, user, percent):
4 bucket = zlib.crc32(f"{flag}:{user}".encode()) % 100
5 return bucket < percent
6
7for user in ["ana", "gus", "bo"]:
8 print(user, [is_enabled("sourdough-subscriptions", user, percent) for percent in (10, 50, 100)])ana [True, True, True] gus [False, True, True] bo [False, False, True]
Conforme a porcentagem cresce, os usuários só passam de desligado para ligado: o bucket da ana é 9, o do gus é 33 e o do bo é 74, e isso nunca muda. (Usamos zlib.crc32 porque o hash() embutido do Python para strings muda toda vez que o programa inicia.)
Principais conclusões
Integre na main pelo menos uma vez por dia; branches de vida longa criam merges dolorosos.
Mantenha a main sempre pronta para release, e corrija ou reverta um build quebrado na hora.
Feature flags separam o deploy do código do lançamento - e tornam o rollback instantâneo.
Use distribuições por porcentagem fixas, baseadas em hash, e remova as flags quando terminar.
Quiz da aula
7 perguntas · aprovação com 5 acertos · até 50 XP
Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.
Pratique: automatize tarefas de DevOps com Python
Escreva as pequenas ferramentas em Python que times de DevOps realmente criam, como executores de pipeline, verificadores de plano, calculadoras de métricas e scanners, e execute-as com entradas de exemplo. Elas rodam localmente no navegador; não é preciso ter servidores nem contas na nuvem.
Relatório de saúde dos branches
A primeira linha da entrada é o número do dia de hoje. Cada linha seguinte é um branch: name created_day last_commit_day commits_behind_main. Dê um veredito para cada branch, conferindo nesta ordem:
stale: delete or revivese não houve commit há mais de 3 dias;too long-lived: merge behind a flagse ele tem mais de 2 dias;rebase soonse ele está mais de 20 commits atrás da main;- caso contrário,
healthy.
Imprima os branches do mais antigo para o mais novo (empates em ordem alfabética) como gluten-free-menu (age 42): stale: delete or revive e depois healthy: 2 of 5 branches.
- Branches da Byte Bakery
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Avalie feature flags
A entrada tem as flags, --- e depois as consultas. Uma linha de flag é name on|off percent, opcionalmente seguida de allow:user1,user2. Uma linha de consulta é user flag.
Avalie cada consulta nesta ordem e imprima o resultado com o motivo:
- flag desconhecida:
ana dark-mode: off (unknown flag) - flag desligada (interruptor de emergência):
off (flag disabled) - usuário na lista de permitidos:
on (allowlist) - caso contrário, calcule
bucket = zlib.crc32(f"{flag}:{user}".encode()) % 100:on (bucket 12 < 25)ouoff (bucket 80 >= 25).
- Distribuição do pão de fermentação natural
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Dúvidas sobre esta lição
Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.
Carregando publicações…