Carregando
0x20Lição 3 de 16

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.

26 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • 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 main está sempre pronta para release. Todo merge é construído e testado, e uma main quebrada é 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.

flags.py
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)])
Saída
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.

Exercício 1

Relatório de saúde dos branches

+25 XP

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 revive se não houve commit há mais de 3 dias;
  • too long-lived: merge behind a flag se ele tem mais de 2 dias;
  • rebase soon se 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
main.py
Carregando editor…

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.

Exercício 2

Avalie feature flags

+25 XP

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) ou off (bucket 80 >= 25).
  • Distribuição do pão de fermentação natural
main.py
Carregando editor…

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…