GRPC: протоколҳои бинарӣ ва иҷроиш

TL; ДР

GRPC = HTTP/2 + Protobuf + шартномаҳои қатъӣ + ҷараён. Он дар байни хидматҳо таъхири кам, трафики муассир ва шартномаҳои устувор медиҳад. Беҳтарин барои зангҳои дохилии шимолу ҷануб/шарқу ғарб, каналҳои вақти воқеӣ (сервер/муштарӣ/ҷараёни биди) ва инчунин пеши мобилӣ тавассути GRPC-Web. Муваффақият аз ҷониби инҳо таъмин карда мешавад: шартномаҳои хурд, мӯҳлатҳо ва бекоркунӣ, бозпас гирифтани экспоненсиалӣ бо идемпотенция, муттаҳидсозии пайвастшавӣ, Фиристанда дар канор, MTLS, рамзгузории калидӣ ва мушоҳидаҳои пурра.

1) Кай интихоб кардани GRPC ва дар вақти не

• API-ҳои дохилӣ байни microservices (тавозун, маҳдудиятҳо, ҳисоб, зидди қаллобӣ).
• Дархостҳои басомади баланд бо SLO-ҳои қатъӣ аз p95/p99.
• Ҷараёнҳои дарозмуддат (ҷадвалҳо/мусобиқаҳо, рӯйдодҳои зинда, ҳолати пардохт).
• Мизоҷони мобилӣ (тавассути GRPC-Web ё BFF).

• Интегратсияҳои ҷамъиятӣ, вебхукҳо, гурӯҳҳои пардохт бо idempotency сахт ва кэшҳои CDN.
• Админ UI-ҳо бо намунаҳои бойи агрегатсия (Graph

2) Шартномаҳо ва эволютсия (Протобуф)

Принсипҳои нақша: мо танҳо майдонҳо илова мекунем, рақамҳоро дубора истифода набарем; ҳатмӣ - тавассути санҷиш, 'лозим нест'.
Версия: бастаҳо/фазои ном ('пардохт. v1 ',' пардохтҳо. v2 '); deprecate тавассути 'deprecated = true' ва тирезаҳои муҳоҷират.
Семантика: паёмҳои "лоғар" бидуни массиви садҳо КБ; намунаҳои калон - ҷараён ё пагинатсия.

proto syntax = "proto3";
package payments.v1;

service Payouts {
rpc Create (CreatePayoutRequest) returns (CreatePayoutResponse) {}
rpc GetStatus (GetStatusRequest) returns (GetStatusResponse) {}
rpc StreamStatuses (StreamStatusesRequest) returns (stream StatusEvent) {}
}

message CreatePayoutRequest {
string idempotency_key = 1;
string user_id = 2;
string currency = 3;
int64 amount_minor = 4; // cents
}

message CreatePayoutResponse { string payout_id = 1; }
message GetStatusRequest { string payout_id = 1; }
message GetStatusResponse { string state = 1; string reason = 2; }
message StreamStatusesRequest { repeated string payout_ids = 1; }
message StatusEvent { string payout_id = 1; string state = 2; int64 ts_ms = 3; }

3) Нақлиёт ва пайвастшавӣ

HTTP/2 бисёр RPC-ро ба як пайвасти TCP мултиплекс мекунад: каналҳои дарозумрро бо ҳамбастагии пайвастшавӣ нигоҳ доред (дар муштарӣ, 2-4 канал/ҳадафи болооб одатан кофӣ аст).
Нигоҳдорӣ: камтар аз танаффуси тавозун пингҳоро камтар фиристед (масалан, ҳар 30 сония), 'max _ pings _ бе _ маълумот' -ро маҳдуд кунед.
Назорати ҷараён/backpressure: HTTP/2 танзимоти тиреза + ҳудуди навбати муштарӣ/сервер.

4) Иҷро: он чизе ки воқеан таъсир мерасонад

Андозаҳои паём: ҳадаф - ≤ 64-128 КБ; Фаъол кардани gzip/brotli барои ҷавобҳои калон барои сарбории калон - ҷараён.
Сериализатсияи протобуф нисбат ба JSON 5-10 × зичтар аст; барои рақамҳо ва 'map <сатр, сатр>' пешгирӣ кунед.
CPU/allocs: кодекси профилӣ ва ҳалкунандаҳо; буферҳои "сифр нусхабардорӣ" -ро истифода баред ва пешакӣ тақсим кунед.
Ришта: Серверҳои GRPC ба қулфҳо ҳассосанд - I/O-ро ба асинк биёред, дар пойгоҳи додаҳои беруна мӯҳлат гузоред.
Nagle/ACK таъхир: одатан бо нобаёнӣ тарк кунед; озмоиш бодиққат.

5) Мӯҳлатҳо, бекоркунӣ, ақибнишинӣ, аблаҳӣ

Ҳамеша 'deadline' -ро дар муштарӣ насб кунед (p95 болооб × 2), контекстро ба хидматҳо/пойгоҳи додаҳо партоед.
Агар дар муштарӣ бекор карда шавад, сервер бояд захираҳоро қатъ ва ройгон кунад.
Retrai: танҳо барои амалиёти idempotent (Аналогҳои GET, ҳолат, хониши ҷараён). Барои тағирдиҳандагон, 'idempotency _ key' -ро истифода баред ва натиҷаро нигоҳ доред.
Сиёсати бозгашт бо jitter экспоненсиалӣ аст; маҳдудияти кӯшишҳо ва "бозпас гирифтани буфер" дар муштарӣ.

Рамзҳои ҳолати GRPC: истифодаи 'DEADLINE _ EXCESTED', 'UNAVAILABLE' (бозхондашуда), 'FAIL _ PRECONDITION', 'ALLECTLINE _ EXISTS', 'ACLEKTERE LINLINE LINE _ _ _ _ _ EXISTS ISTS ES S S S ES' ва ҒАЙРА ва ҒАЙРА ва ҒАЙРА ва ҒАЙРА

6) Ҷараёнҳо: сервер, мизоҷ, биди

Ҷараёни сервер барои посухҳои дароз ва каналҳо (ҳангоми суст шудани муштарӣ ихроҷи хотираро санҷед).
Ҷараёни муштарӣ - зеркашӣ/маҷмӯаҳо.
Дуҷониба - интерактивӣ (ҷадвалҳои зинда, рӯйдодҳои дохилӣ).
Илова кардани пайдарпаӣ/ҷуброн дар паёмҳо барои фармоиш ва дубора оғоз кардан дар сатҳи барнома (танҳо GRPC такрори пас аз пайвастшавиро таъмин намекунад).

7) Мувозинат ва топология

XDS/Фиристанда ҳамчун ҳавопаймои додаҳо: L7-balancing, гардиш, баровардани берунӣ.
Ҳаши пайваста (аз ҷониби 'user _ id '/' table _ id') - калидҳои гармро дар як болооб нигоҳ медорад, қуфлҳои гиреҳро коҳиш медиҳад.
Ҳеджинг/оина: бодиққат; барои p99 дум кӯмак мекунад, аммо сарбориро зиёд мекунад.
Бисёр минтақа: нуқтаҳои ниҳоии маҳаллӣ бо масири гео-масир; pin-ning "минтақаи хонагӣ" аз ҷониби сессия.

yaml load_assignment:
endpoints:
- lb_endpoints:
- endpoint: { address: { socket_address: { address: svc-a-1, port_value: 8080 } } }
- endpoint: { address: { socket_address: { address: svc-a-2, port_value: 8080 } } }
outlier_detection:
consecutive_5xx: 5 interval: 5s base_ejection_time: 30s circuit_breakers:
thresholds:
max_connections: 1024 max_requests: 10000

8) Бехатарӣ

mTLS байни ҳамаи hops (дарвоза ↔ хидматҳо); сертификатҳои кӯтоҳи TTL, гардиши худкор (ACME/фикрию).
Auth-Z: JWT/OIDC дар канор, даъво ба хидматҳо; ABAC/RBAC дар сатҳи дарвоза/фикрию.
PII/PCI: майдонҳои филтр, хомӯш кардани маълумоти ҳассос; рамзгузории токен дар транзит/ҳангоми истироҳат.
GRPC-Web: ҳамон принсипҳои auth, аммо снарядҳо тавассути HTTP/1. 1 (Намояндаи Прокси).

9) Мушоҳидакорӣ

Нишондиҳандаҳо: rps, p50/p95/p99 таъхир дар як усул, сатҳи хатогӣ аз рӯи код, ҷараёнҳои фаъол, андозаи паём, ришта/ҳавз.
Пайгирӣ: W3C/' traceparent 'дар метамаълумот; дар муштарӣ ва сервер матнро ба пойгоҳи додаҳо/кэш паҳн мекунад.
Гузоришҳо: таносуб аз ҷониби 'trace _ id', интихоб, пинҳон кардани қатъӣ.
Helschecks: хадамоти алоҳидаи 'Тандурустӣ' ('grpc. саломатӣ. v1. Саломатӣ/Санҷиш ') ва' Нигоҳ 'барои саломатии ҷараён.

10) Фишурдасозӣ, маҳдудиятҳо ва муҳофизат

Фишурдани паёмро (барои як занг) фаъол созед, 'max _ access _ message _ long '/' max _ send _ message _ long' -ро маҳдуд созед.
Меъёри/квота дар сатҳи дарвоза; ноҳиявӣ бо хатогӣ/ниҳонӣ.
Буҷаи ниҳоӣ: Ба мӯҳлатҳои беохир дар байни hops часпед - ҳар як пайванд буҷаи худро кам мекунад.
Муҳофизат аз дархостҳои "гарон": андоза/шумораи унсурҳоро дар паём маҳдуд кунед, ҷараёнҳои дарозро қатъ кунед.

11) Дарвозаҳо ва созгорпазирӣ

GRPC-Gateway/Transcoding: қисми содироти усулҳо ҳамчун REST (барои шарикон/маъмурон).
GRPC-Web: мустақиман ба Фиристанда, ки рамзгузорӣ шудааст.
Диаграммаи QL-BFF: ҳалкунандаҳо метавонанд дар GRPC роҳ раванд; барои мутатсияҳои домени пардохт, REST бо idempotency афзалтар аст.

12) Номутобиқатӣ дар тағир додани амалиёт

• Муштарӣ 'idempotency _ key' -ро тавлид мекунад.
• Сервер натиҷаро бо калиди TTL нигоҳ медорад (масалан, 24 соат).
• Такрори 'Эҷод' бо ҳамон калид ҳамон 'payout _ id '/status -ро бармегардонад.

go if exists(key) { return storedResult }
res:= doBusiness()
store(key, res)
return res

13) Хатогиҳо ва харитасозии вазъ

• 'INVALID _ ARGUMENT' (тасдиқ), 'NOT _ FOUND', 'ALLECT _ EXISTS',
• 'ПЕШГУФТОР ШУД', 'БЕКОР КАРДА ШУД',
• 'UNAUTHENTICATED '/' ИҶОЗАТ _ РАД',
• 'RESOURCE _ EXHAUSTED' (квотаҳо/маҳдудиятҳо),
• 'UNAVAILABLE' (шабака/болооб), 'DEADLINE _ EXCESTED'.
• Барои муштарӣ: танҳо 'UNAVAILABLE', 'DEADLINE _ EXCESTED' ва ҳолатҳои бо idempotent қайдшударо бозпас гиред.

14) Санҷиш ва UAT

Озмоишҳои шартномавӣ аз ҷониби '.proto' (файлҳои тиллоӣ).
Сарборӣ: p50/p95/p99 таъхир, интиқол, CPU, хотира, GC.
Ҷараёнҳо: санҷишҳои backpressure, қатъ, дубора оғоз кунед.
Шабакаҳо: эмулятсияи гум/ҷиттер; вақти санҷишҳо/санҷишҳои чархуште.
Амният: мутаторҳои нишонаҳо/сертҳо, калидҳои рота дар вақти корӣ.

• Мӯҳлати ҳар як занги муштарӣ.

Рафторҳо танҳо дар он ҷое ҳастанд, ки idempotent мебошанд.

• Маҳдудиятҳои андозаи паём.
• Саломатӣ/Тамошо ва огоҳӣ дар p95/p99.
• гардиш ва гардиш.
• Пайгирии ниҳоӣ.
• Фиристодаи ноҳиявӣ ва берунӣ.
• GRPC-Web e2e барои браузер (агар лозим бошад).

15) Анти-намунаҳо

Паёмҳои азим ба ҷои ҷараёнҳо.
Мӯҳлатҳои беохир ва бекоркунӣ.
Рафти мутатсияҳои хатарнок такрорӣ мебошанд.
Бе ҷамъоварии пайвастшавӣ - тӯфони пайвастшавӣ.
Набудани саломатӣ/тамошо - нобарориҳои "нобино".
Гузоштани PII дар роҳҳо/гузоришҳо.
Як ҳавзи нуқтаи монолитӣ барои тамоми ҷаҳон - бидуни наздикии минтақавӣ.

16) NFT/SLO (нишонаҳо)

Edge → Иловаи хидмат: ≤ 10-30 ms p95 дар минтақа.
Таъхири усул: p95 ≤ 150-250 мс (амалиёти корӣ), p99 ≤ 500 мс.
Меъёри хатогӣ (5xx/' UNAVAILABLE '): ≤ 0. 1% RPS.
Вақти корӣ: ≥ 99. 95% барои хизматрасониҳои муҳим.
Ҷараёнҳо: нигоҳдории пайвастшавӣ ≥ 24 соат, сатҳи тарки <0. 01 %/соат.

17) Конфигуратсияҳои мини ва намунаҳо

go ctx, cancel:= context.WithTimeout(ctx, 300time.Millisecond)
defer cancel()
resp, err:= cli.GetStatus(ctx, req, grpc.WaitForReady(true))

yaml methodConfig:
- name: [{service: payments.v1.Payouts, method: GetStatus}]
retryPolicy:
maxAttempts: 4 initialBackoff: 100ms maxBackoff: 1s backoffMultiplier: 2.0 retryableStatusCodes: [UNAVAILABLE, DEADLINE_EXCEEDED]

yaml paths:
/v1/payouts/{id}:
get:
x-grpc-service: payments.v1.Payouts x-grpc-method: GetStatus

Хулосаи дубора

GRPC як автобуси ба-охири корӣ барои microservices IGaming мебошад: протоколҳои паймонаи бинарӣ, шартномаҳои қатъӣ ва ҷараёнҳои пурқувват. Ҳамин тавр, ки он манфиатҳои воқеӣ меорад, шартномаҳоро хурд ва устувор нигоҳ медорад, мӯҳлатҳо/бекоркунӣ/бозпардохтро бо номутаносибӣ иҷро мекунад, Envoy/XDS ва MTLS-ро истифода мебарад, p95/p99-ро чен мекунад ва системаро дар зери фишор зиндагӣ мекунад. Дар якҷоягӣ бо webhooks REST ва Graph