Files
pf-linux-port/scripts/screencast/narration/05-balanceamento.pt.json
T
lgcosta cc67531602 Screencasts v2: real shell sessions, MiniMax narration (EN/PT), lab diagram
O problema da primeira serie era a sensacao de 'quadro a quadro': a captura
era a saida de um script despejada em blocos.  Agora cada video e uma sessao
shell de verdade.

- record.py: abre um pty, faz SSH no firewall e digita os comandos tecla a
  tecla (~34 c/s, com jitter).  O tty remoto ecoa, o kernel responde ao vivo;
  a captura e asciicast v2 com timestamps.  'bash --noediting' evita que o
  editor de linha redesenhe o comando e o tty o repita (a linha aparecia
  duplicada).
- record.py --pace: segura a tela enquanto a voz fala - cada batida dura o
  trecho de audio que a acompanha, de modo que uma unica captura serve as
  duas versoes de idioma.
- record.py --ensure-pf: garante pf.ko carregado antes de gravar.  Sem isso
  uma fase que roda 'rmmod' (ativacao) pode derrubar o /dev/pf de outra
  gravacao concorrentes - foi exatamente o que quebrou a fase de roteamento
  na primeira tentativa.
- make_audio.py: geracao da narracao pelo MiniMax TTS, uma voz feminina por
  idioma (English_ConfidentWoman / Portuguese_ConfidentWoman), um arquivo
  por segmento.  A API devolve o audio em hexadecimal, nao base64.
- render_video.py: reproduz a captura por um emulador de terminal e escreve
  os frames direto no ffmpeg como RGB bruto (um PNG por frame era uma ordem
  de grandeza mais lento).  Desenha o diagrama de rede do lab por cima do
  terminal nas fases de roteamento e balanceamento, destacando o caminho em
  discussao, e queima a legenda da narracao.
- assemble.py: mixa os segmentos de audio na linha do tempo.
- join.py: emenda as fases com crossfade sobre um cartao de capitulo e
  sincroniza o audio na mesma linha do tempo.
- build-all.sh: roda o pipeline inteiro.

Arte de fundo e audio vem do MiniMax; a geracao de video do MiniMax nao esta
habilitada nesta conta (erro 2068 em todos os modelos), entao as transicoes
sao renderizadas localmente com ffmpeg.

16 videos: 7 fases + filme completo, em ingles e portugues, com legenda
queimada.
2026-11-12 10:57:29 -03:00

68 lines
2.2 KiB
JSON

{
"phase": "05-balanceamento",
"lang": "pt",
"voice": "Portuguese_ConfidentWoman",
"title": "Balanceamento",
"subtitle": "Pools de NAT em round-robin e source-hash, mais o dup-to",
"segments": [
{
"beat": "b1",
"text": "O balanceamento no pf é feito com pools. Esta regra traduz a origem da rede do cliente para um pool de dois endereços, os dois gateways do firewall, e escolhe entre eles em round robin.",
"highlight": [
"cli",
"pf0",
"srv"
],
"diagram_caption": "pool { 10.0.2.1, 10.0.3.1 }: round-robin"
},
{
"beat": "b2",
"text": "Capturamos na interface que vai para o servidor para ver qual endereço de origem cada pacote carrega."
},
{
"beat": "b3",
"text": "Seis pacotes vindo do cliente."
},
{
"beat": "b4",
"text": "E a captura mostra a verdade: três pacotes saíram com um endereço, três com o outro. O pool está realmente rodando entre os membros, e o servidor enxerga a carga balanceada.",
"highlight": [
"cli",
"pf0",
"srv"
],
"diagram_caption": "3 pacotes com cada endereço de origem"
},
{
"beat": "b5",
"text": "Às vezes você não quer rotação. O source hash mantém uma origem sempre mapeada para o mesmo membro do pool, que é o que se quer quando a sessão precisa ser sticky.",
"highlight": [
"cli",
"pf0",
"srv"
],
"diagram_caption": "pool { 10.0.2.1, 10.0.3.1 }: source-hash"
},
{
"beat": "b6",
"text": "Mais quatro pacotes, e agora todos carregam o mesmo endereço de origem. O mapeamento é estável por origem.",
"highlight": [
"cli",
"pf0",
"srv"
],
"diagram_caption": "todos os pacotes com a mesma origem"
},
{
"beat": "b7",
"text": "E o dup to é o caso espelho: o pacote mantém o caminho normal e uma cópia é entregue no segundo gateway. Contamos os pedidos nas duas interfaces: um no caminho normal, um no caminho espelhado. O pacote foi duplicado, não movido.",
"highlight": [
"cli",
"pf0",
"srv",
"gw2"
],
"diagram_caption": "dup-to: o caminho normal e a cópia espelhada"
}
]
}