კვანძის კომუნიკაციის პროტოკოლი

PRX კვანძები დაშიფრული, ავთენტიფიცირებული პროტოკოლით კომუნიცირებენ TCP-ზე. ეს გვერდი აღწერს საკაბელო ფორმატსა და შეტყობინების ტიპებს.

ტრანსპორტი

• პროტოკოლი: TCP TLS 1.3-ით (ორმხრივი ავთენტიფიკაცია დაწყვილებული გასაღებებით)
• სერიალიზაცია: სიგრძით პრეფიქსირებული MessagePack ფრეიმები
• კომპრესია: არასავალდებულო LZ4 ფრეიმის კომპრესია

შეტყობინების ტიპები

ტიპი	მიმართულება	აღწერა
TaskRequest	კონტროლერი -> კვანძი	ამოცანის მინიჭება კვანძისთვის
TaskResult	კვანძი -> კონტროლერი	ამოცანის შესრულების შედეგის დაბრუნება
StatusQuery	კონტროლერი -> კვანძი	კვანძის სტატუსის მოთხოვნა
StatusReport	კვანძი -> კონტროლერი	კვანძის ჯანმრთელობისა და ტევადობის ანგარიში
Heartbeat	ორმხრივი	Keepalive და შეყოვნების გაზომვა
Cancel	კონტროლერი -> კვანძი	მიმდინარე ამოცანის გაუქმება

კონფიგურაცია

[node.protocol]
tls_version = "1.3"
compression = "lz4"  # "lz4" | "none"
max_frame_size_kb = 4096
heartbeat_interval_secs = 15
connection_timeout_secs = 10

კავშირის სასიცოცხლო ციკლი

1. დაკავშირება -- TCP კავშირის დამყარება
2. TLS ხელის ჩამორთმევა -- ორმხრივი ავთენტიფიკაცია დაწყვილებული გასაღებებით
3. პროტოკოლის მოლაპარაკება -- ვერსიასა და კომპრესიაზე შეთანხმება
4. აქტიური -- შეტყობინებების გაცვლა
5. გრაციოზული დახურვა -- გათიშვის შეტყობინების გაგზავნა და დახურვა

დაკავშირებული გვერდები

• კვანძების მიმოხილვა
• კვანძის დაწყვილება