Съдържание на курса
Урок 19 — Дестинацията не отговаря
От Dorian Chávez · съосновател и 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. Предвиди
Отговори на лист хартия:
- API-то е изключено, когато пристига поръчка 4001, и се връща след няколко секунди. Междувременно складът оставя пратката на 4001. В каква последователност трябва да стигнат до API-то поръчката и пратката? А ако стигнат наобратно?
- Ако рутерът опитва отново на всеки 100 милисекунди, какво се случва с API, който тъкмо стартира?
- 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
- Провери опитите на канала 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 секунди? Защо не са точни? - Събери петте паузи от политиката (1 + 2 + 4 + 8 + 16). Ако на API-то му трябваше минута, за да се върне, какво би станало с поръчката? В какво състояние би останала и какво би било нужно, за да пристигне? (Решава го урок 23.)
- Обясни със свои думи защо пратката на 4001 пристигна след поръчката, макар че складът я остави, докато API-то беше изключено.
Защо е направено така
Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:
- Опитва се отново на място, само в рутера, с нарастващо изчакване
Преговор
- Кои отговори на дестинацията се опитват отново и кои — не? Защо 422 на този API — не?
- Каква е ползата всяка пауза да е двойно по-дълга от предишната?
- За какво служи 15-те процента случайност? Обясни го с три реплики на рутера.
- Защо повторният опит не дублира поръчката в API-то?
- Заключителният въпрос: повторният опит „на място“ запазва последователността. Защо и какво струва това? Използвай пратката на 4001 като пример.
Следва: в урок 20 API-то отговаря, но не винаги казва „да“. Понякога казва „не“, а понякога се бави толкова, че извикването прекъсва. Записало ли е, или не?
Предпочитате имейл? Пишете ни на hola@habil.mx