Съдържание на курса
Урок 22 — Да свалим един канал
От Dorian Chávez · съосновател и Chief Executive Officer на Hábil ·
Какво ще постигнеш: когато SFTP на партньора падне, API-то и ERP да продължат да получават поръчките си веднага. Рутерът спира да вика падналата дестинация, записва това, което не е пратил, и я пробва отново сам, когато мине известно време.
Преди да започнеш, ти трябват: завършен урок 20 и включена средата от урок 00.
Новото днес, в едно изречение
В урок 10 изключи ERP и видя, че API-то и партньорът получават поръчката въпреки това: „един паднал канал не спира другите два“. От урок 19 това вече не е вярно. Рутерът опитва отново на място, с паузи, които общо правят половин минута, и докато чака партньора, цялата опашка чака с него. Поръчка, която трябваше да стигне само до API-то, се бави половин минута заради дестинация, която няма нищо общо. Днес слагаш по един прекъсвач (circuit breaker) на канал: когато една дестинация се проваля няколко пъти подред, рутерът спира да я вика за известно време.
Картината: предпазителите в електрическото табло у вас, по един за всяка зона. Ако сешоарът даде на късо, пада предпазителят на мокрото помещение, а кухнята остава с ток. Не молиш никого да спре да ползва сешоара: предпазителят прекъсва сам. А когато вече си проверил, го вдигаш и пробваш. Ако имаше само един предпазител за цялата къща, едно късо в мокрото помещение щеше да те остави без хладилник.
1. Подготви папката си
cd lecciones/22-tirar-un-canal
cp -R inicio mio
Цялата ти работа е в mio/orden-router/reparto.camel.yaml, в маршрута intentar, в стъпка 3: извикването на
канала. Прочети го, преди да пишеш. Коментарът отгоре описва трите състояния на един прекъсвач:
| Състояние | Какво прави | Кога се сменя |
|---|---|---|
| Затворен | Вика канала, както винаги | Отваря се, ако от последните 4 извиквания (при поне 2) половината или повече са се провалили |
| Отворен | Не вика канала: веднага отговаря, че не е опитано | След 10 секунди става полуотворен |
| Полуотворен | Пропуска едно пробно извикване | Ако мине добре, се затваря; ако се провали, се отваря отново |
И има един вече готов маршрут, sin-respuesta, долу в същия файл. Той се изпълнява, когато прекъсвачът не
пропусне извикването или когато извикването се е провалило. Различава двата случая и това е важно:
| Случай | codigo |
Резултат от опита | Операцията |
|---|---|---|---|
| Прекъсвачът беше отворен и не е викано | -1 |
no_enviado |
Остава pendiente |
| Викано е и се е провалило | 0 |
no_se_sabe (урок 20) |
Опитва се отново |
no_enviado не е съмнение: рутерът знае, че не е викал. Затова не се опитва отново на място и не отива за съгласуване.
Остава pendiente, а в урок 23 ще видиш как се праща отново.
2. Предвиди
Отговори на лист хартия:
- Сваляш SFTP на партньора и пристигат четири поръчки от франчайз. Без прекъсвач колко се бави четвъртата, докато стигне до API-то? (Подсказка: събери паузите от урок 19.)
- Защо по един прекъсвач на канал, а не един за целия рутер?
- SFTP се връща. Кой трябва да „вдигне предпазителя“?
Виж какво е положението днес:
./verifica inicio
Скриптът verifica изключва SFTP, праща четири поръчки и брои колко са стигнали до API-то и до ERP за около 25 секунди. Стига една от четири. 4001 минава към API-то и ERP, а после опашката остава да чака повторните опити към партньора; останалите три не напредват, макар API-то и ERP да са в отлично състояние.
3. Сложи по един предпазител на канал
В стъпка 3 на intentar има doTry, който вика direct:llamar-canal. Точно този doTry ще замениш.
Има три TODO:
| TODO | Какво пишеш | За какво |
|---|---|---|
| 1 | Един choice по ${variable.canal} с три клона (rest, bd, edi) и във всеки — circuitBreaker със своя id: cortacircuito-rest, cortacircuito-bd, cortacircuito-edi |
По един предпазител на зона |
| 2 | Във всеки circuitBreaker — неговата resilience4jConfiguration |
Кога се отваря и след колко време пробва |
| 3 | Във всеки — onFallback, който вика direct:sin-respuesta |
Да се запише дали не е викано, или е викано и се е провалило |
Така изглежда един клон. Другите два са същите, със своя канал и своя id:
- choice:
when:
- expression:
simple:
expression: "${variable.canal} == 'rest'"
steps:
- circuitBreaker:
id: cortacircuito-rest
resilience4jConfiguration:
slidingWindowSize: 4
minimumNumberOfCalls: 2
failureRateThreshold: 50
waitDurationInOpenState: "10000"
permittedNumberOfCallsInHalfOpenState: 1
automaticTransitionFromOpenToHalfOpenEnabled: true
steps:
- to:
uri: direct:llamar-canal
onFallback:
steps:
- to:
uri: direct:sin-respuesta
# … la rama de bd y la de edi
Всеки ред от конфигурацията е ред от таблицата на състоянията:
| Параметър | Стойност | Какво казва |
|---|---|---|
slidingWindowSize |
4 | Гледа последните 4 извиквания |
minimumNumberOfCalls |
2 | Не решава с по-малко от 2 |
failureRateThreshold |
50 | Отваря се при 50 % провали или повече |
waitDurationInOpenState |
"10000" |
Отворен 10 секунди (в милисекунди и в кавички) |
permittedNumberOfCallsInHalfOpenState |
1 | В полуотворено състояние — едно-единствено пробно извикване |
automaticTransitionFromOpenToHalfOpenEnabled |
true |
Минава в полуотворено сам, без да чака някой да извика |
Пишеш конфигурацията три пъти, еднакво. Би могла да се напише веднъж и да се използва повторно; тук е цялата във всеки канал, за да се чете всеки предпазител самостоятелно.
Една бележка за по-нататък: ако някой ден компилираш този маршрут до нативен вариант с Camel Quarkus, прекъсвачът го дава друга
библиотека, но circuitBreaker в YAML-а е същият и не променяш нищо.
4. Счупи едно нарочно
С твоите три завършени прекъсвача смени id на трите с един-единствен, cortacircuito, сякаш има
само един предпазител за целия рутер. Пусни ./verifica.
Преди това предвиди: API-то и ERP са добре. Продължават ли да са в крак?
Не. Прекъсвачът брои извикванията на трите канала заедно: тези към партньора се провалят, тези към API-то и ERP — не,
и при половината провалени се отваря за всички. API-то и ERP спират да получават поръчки заради дестинация, която не е
тяхна, а в лога се появяват отворени прекъсвачът на rest и този на bd. Излизат в червено отметката за API-то и ERP
и тази за лога. Върни трите id.
5. Провери
./verifica
verifica изключва SFTP, праща четири поръчки, проверява API-то, ERP и състоянието; после включва отново SFTP,
изчаква да минат 10-те секунди и праща пета. При излизане оставя SFTP включен. Урокът е завършен, когато видиш
петте зелени отметки:
✅ Arrancaron el router (con un cortacircuito por canal), los tres canales y el sondeo
✅ Con el SFTP caído, la API y el ERP siguieron al día: las 4 órdenes en los dos, en (…) s
✅ El canal del socio: las 4 quedaron pendientes, su último intento «no_enviado», y de la 4002 en adelante con un solo intento (no esperaron)
✅ Log: se abrió el cortacircuito del socio, y solo ese
✅ Volvió el SFTP: la 4005 pasó por el cortacircuito ya cerrado y su 850 está en el socio
Прочети третата спокойно. 4001 наистина опита няколко пъти: прекъсвачът още беше затворен и провалите на
тези опити са това, което го отвори. От 4002 нататък има един-единствен опит, no_enviado: рутерът дори
не е викал.
И гледай лога на рутера, докато това се случва:
DONDE=mio docker compose -f compose.yaml logs orden-router | grep -i cortacircuito
Не тръгва? ./verifica solucion тества нашето решение, а
diff mio/orden-router/reparto.camel.yaml solucion/orden-router/reparto.camel.yaml ти казва по какво се различават.
| Какво виждаш | Какво правиш |
|---|---|
a los (…) s la API tiene 1 de 4 |
Няма прекъсвач или този на партньора никога не се отваря: провери дали клонът edi съществува и дали failureRateThreshold е 50 |
El canal del socio quedó с 0 неизпратени |
Липсва onFallback към direct:sin-respuesta: без него нищо не записва no_enviado |
esperaba el cortacircuito de edi abierto y los de rest y bd cerrados |
Два клона споделят id: всеки канал носи свой |
Volvió el SFTP y la 4005 quedó «pendiente» |
Прекъсвачът не минава в полуотворено: липсва automaticTransitionFromOpenToHalfOpenEnabled: true или waitDurationInOpenState е много повече от 10000 |
No arrancaron todas las rutas |
Провери отстъпа: steps и onFallback са вътре в circuitBreaker, на същото ниво като resilience4jConfiguration |
El puerto 8080 está ocupado |
Услугите от друго пускане са останали вдигнати: DONDE=mio docker compose -f compose.yaml down |
Ако verifica прекъсне по средата, SFTP се включва сам при излизане. Ако въпреки това го виждаш изключен:
docker compose -f ../../infra/compose.yaml start socio-sftp.
Какво учи това извън курса
Паднала дестинация не бива да събаря тези, които са добре. Това е идеята зад прекъсвача и зад „отсеците“ на един кораб: ако един се наводни, останалите остават сухи. Без това най-малката повреда в системата определя скоростта на всичко.
Да не викаш това, за което знаеш, че е паднало, е услуга и за двамата. Спестяваш си чакането, а дестинацията не получава вълна от извиквания, докато се опитва да се върне.
Прекъсвачът се възстановява сам. Пробното извикване в полуотворено състояние прави така, че никой да не трябва да помни да „вдигне предпазителя“. Ако дестинацията още е зле, той се отваря отново и нищо не е станало.
„Не го пратих“ е факт и се записва като такъв. Един опит no_enviado казва нещо различно от един no_se_sabe.
Първият може да се прати отново без страх, защото дестинацията никога не го е виждала.
Упражнение: предпазителят в три такта
С твоята завършена версия пусни ./verifica и после:
- С лога на
orden-routerсглоби времева линия на пускането: кога се отвори прекъсвачът наedi, колко поръчки остави непратени и кога мина пробното извикване. Отбележи върху нея трите състояния: затворен, отворен и полуотворен. - В базата провери опитите на канала на партньора:
SELECT p.orden, i.n, i.desenlace, i.respuesta->>'cuerpo' FROM intento i JOIN operacion p ON p.id = i.operacion WHERE p.canal = 'edi' AND p.momento = 'creada' ORDER BY p.orden, i.n;Какво казва отговорът на един опитno_enviado? А този на единno_se_sabe? - Четирите поръчки за партньора останаха
pendiente. Никой няма да ги прати сам. Какво липсва на рутера, за да ги възстанови? Запиши отговора си: това е урок 23.
Защо е направено така
Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:
- По един прекъсвач на канал, в рутера
Преговор
- Какви три състояния има един прекъсвач и какво прави във всяко?
- Какво означава всяко число от конфигурацията: 4, 2, 50, 10000 и 1?
- Защо по един прекъсвач на канал, а не един за целия рутер?
- По какво се различава един опит
no_enviadoот единno_se_sabe? Защо първият не отива за съгласуване? - Заключителният въпрос: в урок 10 стигна до извода, че „един паднал канал не спира другите два“. Защо това престана
да е вярно в урок 19 и какво го прави вярно отново? Използвай това, което видя във verifica на
inicio/и в твоето.
Следва: в урок 23 някой трябва да прати отново това, което е останало чакащо или за съгласуване. Как обработваш повторно една поръчка, без да я дублираш и като оставиш записано кой го е направил и защо?
Предпочитате имейл? Пишете ни на hola@habil.mx