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

Урок 19 — Дестинацията не отговаря

От · съосновател и Chief Executive Officer на Hábil ·

Какво ще постигнеш: когато API-то не отговаря, рутерът да опитва отново сам, всеки път с по-дълга пауза, докато поръчката пристигне. И междувременно пратката на тази поръчка да не я изпревари: API-то трябва да получи първо поръчката, а после нейната пратка.

Преди да започнеш, ти трябват: завършен урок 18 и включена средата от урок 00.

Новото днес, в едно изречение

В урок 15 рутерът се научи да записва, преди да отговори, а в урок 18 — да разпознава повторено съобщение. Днес се случва обратното на урок 18: съобщението не пристига, защото дестинацията не отговаря. Рутерът не може да знае дали API-то е получило поръчката; това, което може да направи, е да опита отново. И тъй като вече умее да разпознава повторения (API-то също: видя го в урок 02 с ключа), повторният опит не дублира нищо.

Картината: да звъниш на някого, който не вдига. Не му звъниш всяка секунда в продължение на час: звъниш, чакаш минута, звъниш пак, чакаш две, после четири. Даваш му време да излезе от срещата. И не му казваш второто преди първото: ако обаждането е било, за да му съобщиш, че пратката му е тръгнала, не му пращаш преди това съобщение „пристигна ли вече?“.


1. Подготви папката си

cd lecciones/19-el-destino-no-contesta
cp -R inicio mio

Днес цялата работа е в един нов файл на рутера, orden-router/reintentos.camel.yaml. Отвори го и прочети целия коментар отгоре. Носи една рисунка:

intento 1 ✗ ─ 1 s ─ intento 2 ✗ ─ 2 s ─ intento 3 ✗ ─ 4 s ─ intento 4 ✓     (más o menos 15 % al azar)

И три правила, които вече са в кода:

Правило Какво означава Къде живее
Само рутерът опитва отново Каналите (int-rest, int-bd, int-edi) отговарят какво им се е случило и толкова Каналите нямат повторни опити
Повтаря се само това, което е останало „неизвестно“ Без отговор или грешка 5xx. Един 4xx от този API (неговият 422) е „не“ от дестинацията и не се повтаря (в урок 20 ще видиш, че не всички 4xx са „не“) direct:intentar хвърля IOException само в този случай
Всеки опит оставя свой ред Преди да извика канала, intentar пише в таблицата intento; после записва как е минало reparto.camel.yaml, от урок 15

2. Предвиди

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

  1. API-то е изключено, когато пристига поръчка 4001, и се връща след няколко секунди. Междувременно складът оставя пратката на 4001. В каква последователност трябва да стигнат до API-то поръчката и пратката? А ако стигнат наобратно?
  2. Ако рутерът опитва отново на всеки 100 милисекунди, какво се случва с API, който тъкмо стартира?
  3. ERP и партньорът бяха вдигнати. Колко пъти трябва да получат 4001?

Виж какво е положението днес:

./verifica inicio

Магазинът получава своето 202, защото рутерът записа. Но каналът rest опитва само веднъж: API-то беше изключено, опитът остава в no_se_sabe и никой не го опитва отново. API-то се връща няколко секунди по-късно, а 4001 никога не стига до него.

3. Опитвай отново с нарастващо изчакване

Отвори mio/orden-router/reintentos.camel.yaml. Отгоре има routeConfiguration с onException, който улавя IOException, хвърлена от intentar. Днес той само записва в лога, че се е отказал. Твоята работа е да му кажеш колко пъти и с каква пауза да опитва отново, с redeliveryPolicy вътре в onException:

TODO Какво пишеш За какво
1 maximumRedeliveries: 5 и redeliveryDelay: 1000 До пет повторни опита; първият — след една секунда
2 useExponentialBackOff: true и backOffMultiplier: 2 Всяка пауза да е двойно по-дълга от предишната: 1, 2, 4, 8, 16 секунди — нарастващо изчакване (backoff)
3 useCollisionAvoidance: true и collisionAvoidanceFactor: 0.15 Всяка пауза да варира с 15 % на случаен принцип — случайно отклонение (jitter)
4 retryAttemptedLogLevel: WARN Всеки повторен опит да се вижда в лога

redeliveryPolicy е на същото ниво като handled и steps, вътре в onException. Така изглежда скелетът:

- onException:
    exception:
      - java.io.IOException
    redeliveryPolicy:
      maximumRedeliveries: 5
      …
    handled:
      constant:
        expression: "true"
    steps:
      - log: …

Обърни внимание на две неща:

  • Случайното отклонение от TODO 3 изглежда като каприз, но не е. Представи си три реплики на рутера (урок 12), които губят API-то по едно и също време. Без случайност трите опитват отново точно на секундата, после на двете, после на четирите: API-то се връща и всеки път получава три удара наведнъж. С 15 % отклонение ударите се раздалечават.
  • Повторният опит е „на място“. Опашката seda:repartir има един-единствен консуматор и паузата го спира. Това, което идва след него в опашката, като пратката на 4001, чака реда си. Точно това запазва последователността.

4. Счупи едно нарочно

С твоите завършени повторни опити смени maximumRedeliveries на 1 и пусни ./verifica.

Преди това предвиди: verifica оставя API-то изключено около шест секунди. С един-единствен повторен опит след секунда стига ли поръчката до API-то?

Не стига. Първият опит се проваля, повторният след секунда — също, и рутерът се отказва, докато API-то още е изключено. Излизат в червено отметката за опитите на rest и тази за API-то. Операцията остава в no_se_sabe и това е правилно: рутерът не си измисля, че я е доставил. Но показва цената на това да не ти стигне: пет повторни опита с нарастващо изчакване покриват около трийсет секунди прекъсване; един-единствен — една секунда. Върни на 5.

5. Провери

./verifica

verifica изключва API-то, праща 4001, оставя пратката ѝ в пощенската кутия, чака няколко секунди и включва отново API-то. Урокът е завършен, когато видиш шестте зелени отметки:

✅ Arrancaron el router (con sus reintentos), los tres canales y el sondeo
✅ Con la API apagada, la tienda recibió su 202: lo suyo quedó guardado
✅ Estado: el canal rest reintentó en el lugar: (…) intentos; esperas (…); desenlaces (…)
✅ Estado: el ERP y el socio no se repitieron: aceptados al primer intento (bd=aceptada/1 edi=aceptada/1)
✅ API: recibió la orden y después su embarque, y la 4001 quedó EMBARCADO
✅ ERP: la 4001 está EMBARCADO

Прочети третата отметка спокойно. Казва ти колко опита е имало, колко е чакал между един и друг и как е завършил всеки. Изчакванията се променят при всяко пускане заради случайността, но винаги растат, а последният опит е единственият aceptada.

Не тръгва? ./verifica solucion тества нашето решение, а diff mio/orden-router/reintentos.camel.yaml solucion/orden-router/reintentos.camel.yaml ти казва по какво се различават.

Какво виждаш Какво правиш
esperaba 3 o más intentos de rest, а има 1 Липсва redeliveryPolicy или е останала извън onException
esperaba 3 o más intentos de rest, а изчакванията не растат Липсва useExponentialBackOff: true
esperaba la orden antes que el embarque, а поръчката no llegó Малко повторни опити или твърде кратки паузи: рутерът се е отказал, преди API-то да се върне
El ERP y el socio quedaron с повече от един опит Сложил си повторни опити и другаде: мястото им е само в reintentos.camel.yaml
El puerto 8080 está ocupado Услугите от друго пускане са останали вдигнати: DONDE=mio docker compose -f compose.yaml down

Ако verifica прекъсне по средата, API-то се включва само при излизане. Ако въпреки това го виждаш изключено: docker compose -f ../../infra/compose.yaml start api-pedidos.


Какво учи това извън курса

Повторният опит е безопасен само ако дестинацията разпознава повторенията. Рутерът не знае дали първият опит е пристигнал. Ако е пристигнал и той опита отново, API-то получава поръчката два пъти, а това, което предотвратява дубликата, е неговият ключ за идемпотентност (урок 02). Повторни опити без идемпотентност са дубликати с друго име.

Нарастващото изчакване със случайно отклонение е обичайната практика и си има име: exponential backoff with jitter. Препоръчват го големите облачни доставчици за всеки клиент на техните услуги. С фиксирано изчакване или даваш излишно време на този, който вече се е върнал, или удряш този, който още стартира.

Само един опитва отново. Ако рутерът опитва пет пъти и каналът също пет, едно-единствено изпращане може да стане трийсет и шест извиквания. Избира се едно място, а останалите отговарят какво им се е случило.

Последователността си има цена. Повторният опит на място спира опашката: докато API-то не отговаря, нищо от това, което идва след него, не напредва. Тук си струва, защото пратка преди поръчката ѝ е грешка. Когато една паднала дестинация задържа прекалено много останалите, е нужен друг инструмент: това е урок 22.

Упражнение: логът на опитите

С твоята завършена версия пусни ./verifica и влез в базата:

docker compose -f ../../infra/compose.yaml exec estado psql -U router -d estado
  1. Провери опитите на канала rest за създаването на 4001, с часа им: SELECT i.n, i.inicio, i.desenlace FROM intento i JOIN operacion p ON p.id = i.operacion WHERE p.orden = '4001' AND p.momento = 'creada' AND p.canal = 'rest' ORDER BY i.n; Извади на ръка часа на всеки опит минус този на предишния. Приличат ли на 1, 2, 4 и 8 секунди? Защо не са точни?
  2. Събери петте паузи от политиката (1 + 2 + 4 + 8 + 16). Ако на API-то му трябваше минута, за да се върне, какво би станало с поръчката? В какво състояние би останала и какво би било нужно, за да пристигне? (Решава го урок 23.)
  3. Обясни със свои думи защо пратката на 4001 пристигна след поръчката, макар че складът я остави, докато API-то беше изключено.

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

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

  • Опитва се отново на място, само в рутера, с нарастващо изчакване

Преговор

  1. Кои отговори на дестинацията се опитват отново и кои — не? Защо 422 на този API — не?
  2. Каква е ползата всяка пауза да е двойно по-дълга от предишната?
  3. За какво служи 15-те процента случайност? Обясни го с три реплики на рутера.
  4. Защо повторният опит не дублира поръчката в API-то?
  5. Заключителният въпрос: повторният опит „на място“ запазва последователността. Защо и какво струва това? Използвай пратката на 4001 като пример.

Следва: в урок 20 API-то отговаря, но не винаги казва „да“. Понякога казва „не“, а понякога се бави толкова, че извикването прекъсва. Записало ли е, или не?

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

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