Към съдържанието
Съдържание на курса

Урок 22 — Да свалим един канал

От · съосновател и 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. Предвиди

Отговори на лист хартия:

  1. Сваляш SFTP на партньора и пристигат четири поръчки от франчайз. Без прекъсвач колко се бави четвъртата, докато стигне до API-то? (Подсказка: събери паузите от урок 19.)
  2. Защо по един прекъсвач на канал, а не един за целия рутер?
  3. 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 и после:

  1. С лога на orden-router сглоби времева линия на пускането: кога се отвори прекъсвачът на edi, колко поръчки остави непратени и кога мина пробното извикване. Отбележи върху нея трите състояния: затворен, отворен и полуотворен.
  2. В базата провери опитите на канала на партньора: 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?
  3. Четирите поръчки за партньора останаха pendiente. Никой няма да ги прати сам. Какво липсва на рутера, за да ги възстанови? Запиши отговора си: това е урок 23.

Защо е направено така

Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:

  • По един прекъсвач на канал, в рутера

Преговор

  1. Какви три състояния има един прекъсвач и какво прави във всяко?
  2. Какво означава всяко число от конфигурацията: 4, 2, 50, 10000 и 1?
  3. Защо по един прекъсвач на канал, а не един за целия рутер?
  4. По какво се различава един опит no_enviado от един no_se_sabe? Защо първият не отива за съгласуване?
  5. Заключителният въпрос: в урок 10 стигна до извода, че „един паднал канал не спира другите два“. Защо това престана да е вярно в урок 19 и какво го прави вярно отново? Използвай това, което видя във verifica на inicio/ и в твоето.

Следва: в урок 23 някой трябва да прати отново това, което е останало чакащо или за съгласуване. Как обработваш повторно една поръчка, без да я дублираш и като оставиш записано кой го е направил и защо?

Да обсъдим вашия проект

Предпочитате имейл? Пишете ни на hola@habil.mx