Índice do curso
Lição 12 — Crescer em réplicas
Por Dorian Chávez · cofundador e Chief Executive Officer da Hábil ·
O que será alcançado: rodar três réplicas do int-bd sem mexer nos demais serviços, medir como os pedidos se distribuem entre elas, e descobrir por que no começo eles não se distribuem.
Antes de começar é preciso ter: a lição 11 concluída e o ambiente da 00 ligado (com o ERP recriado na 10).
A novidade de hoje, em uma frase
Chega o Buen Fin, o grande fim de semana de ofertas no México, e a loja manda o triplo de pedidos. O gargalo é o int-bd, que escreve no ERP.
Hoje escala-se um único serviço: em vez de uma réplica do int-bd rodam três, e o router continua chamando-as pelo
mesmo nome, int-bd.
A imagem: uma agência de banco que abre mais dois guichês. Os clientes continuam entrando na mesma fila, e o banco coloca alguém para mandá-los a um guichê livre. Hoje se vê o que acontece quando esse alguém não faz bem o trabalho.
Uma réplica é uma cópia idêntica do mesmo serviço: a mesma imagem, a mesma pasta, as mesmas rotas. O int-bd pode ser replicado sem que um pedido seja registrado duas vezes porque não guarda nada em memória: tudo o que importa fica no ERP.
1. Prepare a pasta
cd lecciones/12-crecer-en-replicas
cp -R inicio mio
Hoje não se mexe em nenhuma rota. Todo o trabalho vai em um único arquivo, mio/replicas.yaml. O Compose o junta ao
compose.yaml da lição, no qual não se mexe: o Compose os funde campo por campo: um
command do segundo arquivo substitui o do primeiro, e em environment cada variável é acrescentada ou
substitui a de mesmo nome.
DONDE=mio docker compose -f compose.yaml -f mio/replicas.yaml up -d
É a mesma ideia do franquicias.yaml da 11: mudar como um serviço roda sem mudar o serviço.
2. Faça a previsão
Hoje se usa um lote novo: datos/ordenes/lote-30/, o lote de 30 pedidos, todos de lojas próprias (o parceiro não
recebe nenhum). Responda em um papel:
- Se rodarem três réplicas do int-bd e os 30 pedidos forem mandados, quantos cada réplica registra?
- Quem decide para qual réplica vai cada pedido: o router, o Camel, o Docker ou o ERP?
Confira como está hoje:
./verifica inicio
Saem duas marcas vermelhas: int-bd corre en 1 copia(s) y se esperaban 3, e Con una sola copia no hay nada que repartir. O verifica imprime a distribuição, e hoje ela é int-bd-1=30: uma única réplica faz tudo.
3. Peça três réplicas
Em mio/replicas.yaml, o TODO 1. Peça três réplicas do int-bd com deploy → replicas:
services:
int-bd:
deploy:
replicas: 3
Rode o verifica:
./verifica
Veja a linha Reparto:. O que vimos ao testá-la:
Reparto: practica-retail-l12-int-bd-1=0 practica-retail-l12-int-bd-2=0 practica-retail-l12-int-bd-3=30
❌ 2 de 3 copias no registraron nada: el router sigue usando la misma conexión.
As três réplicas estão no ar, mas uma faz tudo e duas não fazem nada. Deu para acertar o 10/10/10? Quase ninguém acerta, porque parece óbvio. Antes de continuar, escreva a explicação: por que eles não se distribuíram?
4. Por que não se distribuem
Há duas razões, e elas andam juntas.
A conexão é reutilizada. Abrir uma conexão HTTP custa tempo, então o router abre uma para o int-bd e a
deixa aberta (keep-alive). Todos os pedidos seguintes viajam por essa mesma conexão, e uma conexão vai para uma única
réplica. O Docker não distribui requisições: distribui conexões.
A JVM se lembra do endereço. Quando o router pergunta «onde está o int-bd?», o DNS do Docker responde os
três endereços, em ordem diferente a cada vez. Mas a JVM do router guarda a primeira resposta e não volta a
perguntar por um bom tempo.
| O que faz hoje | O que é preciso | |
|---|---|---|
| A conexão | Vive para sempre | Que vença logo, para abrir outra |
O endereço do int-bd |
A JVM se lembra dele | Que ela o esqueça logo, para perguntar de novo |
Com as duas curtas, cada conexão nova pergunta de novo o endereço e pode cair em outra réplica.
5. Faça o router distribuir
O TODO 2, no mesmo mio/replicas.yaml, dentro de orden-router. São duas coisas:
a) Que a conexão viva no máximo um segundo. É a opção connectionTimeToLive do componente http, em
milissegundos. Ela é passada ao router na inicialização:
command: ["run", ".", "--prop=camel.component.http.connectionTimeToLive=1000"]
b) Que a JVM se lembre do endereço por um segundo. Vai em uma variável de ambiente que a JVM lê ao iniciar:
environment:
JDK_JAVA_OPTIONS: "-Dsun.net.inetaddr.ttl=1"
Antes de colocar a b, faça o teste: coloque só a a e rode ./verifica. Ao testar a lição, só com a a a
distribuição continuou em 0/0/30. A conexão já vencia, mas a conexão nova ia para o mesmo endereço que a JVM tinha
guardado. Agora acrescente a b e rode de novo.
6. Confira
./verifica
O verifica reinicia a API, esvazia o ERP, sobe os serviços com o replicas.yaml de mio/ e manda os 30 pedidos com uma
pausa entre cada um, para que o router tenha ocasião de abrir conexões novas. Está concluída quando aparecem as seis marcas verdes:
✅ int-bd corre en 3 copias
✅ Arrancaron el router, int-rest, int-edi y las copias de int-bd
✅ ERP: tiene las 30 órdenes REGISTRADO, cada una una sola vez
✅ API: tiene las 30 órdenes (crecer int-bd no tocó a los demás)
Reparto: practica-retail-l12-int-bd-1=12 practica-retail-l12-int-bd-2=12 practica-retail-l12-int-bd-3=6
✅ Entre todas las copias registraron 30 órdenes: ni una de más, ni una de menos
✅ (…) de 3 copias de int-bd registraron órdenes: el trabajo se repartió
A distribuição vai sair diferente, e muda a cada execução: ao testá-la vimos 12/12/6 e 6/11/13. Quem escolhe a réplica é a rede, e a rede não distribui de forma exata. Por isso o verifica não pede 10/10/10: pede que pelo menos duas réplicas recebam trabalho e que nenhum pedido se perca nem se repita. Pode acontecer de uma réplica ficar sem pedidos em uma execução: se as outras duas dividiram os 30 entre si, está certo. Cada réplica conta o que fez no próprio log, de modo que a distribuição é dita pelas réplicas, não pelo router.
Não roda? ./verifica solucion testa a nossa, e diff mio/replicas.yaml solucion/replicas.yaml diz
em que elas são diferentes.
| O que aparece | O que fazer |
|---|---|
int-bd corre en 1 copia(s) |
Falta o deploy → replicas: 3, ou ele ficou embaixo de outro serviço. Confira a indentação |
2 de 3 copias no registraron nada |
Falta a a, a b ou as duas (passo 5) |
No pude levantar los servicios. Revisa que mio/replicas.yaml sea YAML válido |
Um erro de indentação ou de aspas; o verifica mostra as últimas linhas do erro |
CAMEL_COMPONENT_HTTP_CONNECTION_TIME_TO_LIVE foi colocada em environment e não distribui |
Nesta versão essa variável não surte efeito (medimos: 0/29/0). Use o --prop do passo 5 |
Tu ERP no tiene la columna correlacion |
Recrie o ERP como diz a 10 |
O que isto ensina fora do curso
Distribui-se por conexão, e uma conexão eterna não se distribui. No Docker quem distribui é o DNS. No Kubernetes, um Service também escolhe uma réplica a cada conexão nova, de modo que o mesmo problema aparece igual. Muda quem distribui; a regra não.
O segundo é para ver o efeito aqui, não um número para um sistema real. Quanto uma conexão deve viver depende de quanto tráfego há e de com que frequência as réplicas mudam. Fechá-la depois de cada pedido também distribui, mas paga-se o custo de abrir uma conexão a cada chamada.
Exercício: crescer sem mexer em ninguém
Com a versão própria concluída, responda só com o que aparece na tela:
- Troque
replicas: 3porreplicas: 5e rode./verifica. Que marca fica vermelha, e por quê? (Dica: o verifica espera 3.) Quantos pedidos cada uma das cinco registrou? - Volte para 3. Em que arquivos foi preciso mexer para passar de uma réplica a três? Foi preciso mexer em alguma rota, em algum mapeamento ou no
compose.yamlda lição? - Por que o int-bd pode ser replicado três vezes sem que um pedido seja registrado duas vezes? O que aconteceria se cada réplica guardasse na própria memória os pedidos que já viu?
O que já funciona
Com esta lição fecha-se a parte 1. Um pedido que a loja cria já faz tudo isto:
- chega ao router por HTTP e o router responde o que cada destino disse;
- chega à API uma única vez, mesmo que seja reenviado, graças à chave dele;
- entra no ERP completo ou não entra, e o int-bd pode escalar para várias réplicas;
- vira um 850 que chega ao parceiro sem ser sobrescrito nem ficar pela metade, só se a loja for dele;
- leva um fio que o segue por todos os serviços;
- e se um destino cair, os demais o recebem do mesmo jeito.
O que ele ainda não faz: lembrar em que ponto está cada pedido. Isso começa na parte 2.
Por que foi feito assim
O que decidimos nesta lição, com o que descartamos e o que nos faria mudar de ideia:
- Três réplicas não distribuem sozinhas: a distribuição é por conexão
- Uma única imagem; cada serviço é uma pasta
Revisão
- O que é uma réplica, e por que o int-bd pode ser replicado sem que um pedido seja registrado duas vezes?
- Com
replicas: 3e mais nada, como os pedidos se distribuíram? Por quê? - O que faz
connectionTimeToLive, e o que fazsun.net.inetaddr.ttl? Por que só uma não basta? - Por que o verifica não pede 10/10/10, e o que pede no lugar?
- A pergunta de encerramento: se o router tivesse réplicas, onde viveria o que diz respeito a cada pedido? Escreva a resposta: ela será comparada com a lição 15.
A seguir: na lição 13 chega o embarque. O armazém deixa um arquivo, e agora que já se sabe rodar réplicas, a pergunta é outra: se várias réplicas leem a mesma pasta, quem pega o arquivo?
Prefere e-mail? Escreva para hola@habil.mx