Англійський словник для розробників Dapr Microservices

Dapr (Distributed Application Runtime) — це проект з відкритим кодом від Microsoft, який надає набір API — під назвою будівельні блоки — для створення портативних, надійних мікросервісних застосунків. Замість вбудовування розподілених системних примітивів (обмін повідомленнями pub/ sub, керування станом, виявлення служб) безпосередньо у код вашої програми, Dapr переміщає їх у процес, який працює разом з вашою службою. Це робить вашу програму незалежною від мови коду і переносимою з точки зору інфраструктури. Якщо ваша команда створює мікросервіси на Kubernetes або будь-якій контейнерній платформі за допомогою Dapr, розуміння її словника є обов’язковим для обговорення архітектури, перегляду налаштувань і реагування на інциденти. Цей запис охоплює основні терміни Dapr.

Ключовий словник

Сідко-вагонний шаблон Архітектурний стиль в серці Dapr. Допоміжний контейнер — це допоміжний контейнер, який виконується разом з вашим основним контейнером програми у тому ж підрозділі (у Kubernetes) або групі процесів. Ваша програма спілкується з блоками Dapr за допомогою sidecar за допомогою HTTP або gRPC на localhost, замість безпосереднього імпортування бібліотек розподілених систем.

• Приклад: “Dapr автоматично вставляє контейнер sidecar в кожен под — ваша служба викликає localhost:3500/v1.0/invoke/... і sidecar обробляє виявлення, повторні спроби та спостережливість без необхідності використання SDK.” *

Компонент Pub/sub Блок Dapr для обміну даними між службами за допомогою подій. Name Ваша служба публікує повідомлення у темі з назвою і підписується на отримання повідомлень з теми — Dapr абстрагує базовий брокер повідомлень (Kafka, RabbitMQ, Azure Service Bus, Redis Streams) за допомогою єдиного API. Зміна брокера вимагає лише зміни файла налаштувань, а не зміни коду. Приклад: “Використовуйте Dapr pub/sub для від’єднання служби замовлення від служби інвентарізації — служба замовлення публікує в темі order.placed, а служба інвентарізації підписується, без прямої залежності між ними.”

Статутний магазин Блок Dapr для керування станом ключів- значень. Name Служби зберігають і отримують стан за допомогою API для зберігання стану Dapr, а підставне зберігання (Redis, Cosmos DB, PostgreSQL, DynamoDB) налаштовується окремо як компонент Dapr. Стан можна адресувати за допомогою актора або служби в кластері.

• Приклад: “Зберігати стан кошика за допомогою API для зберігання стану Dapr — ми можемо переключитися з Redis на Cosmos DB у виробництві, змінивши компонент YAML, не торкаючись коду програми.” *

** Виклик служби ** Блок Dapr для синхронізації викликів HTTP або gRPC з однієї служби до іншої. Dapr обробляє виявлення послуг, балансування навантаження, шифрування mTLS і автоматичні повторні спроби. Ваша служба викликає додаток Dapr з ідентифікатором програми цільової служби, і Dapr маршрутизує запит до відповідного екземпляра. Приклад: «Використовувати виклик Dapr замість твердого кодування URL-адреси інвентарної служби — викликати localhost:3500/v1.0/invoke/inventory-service/method/check-stock і Dapr розв’язує адресу і повторює спроби при перехідних невдачах.»

Акторка-модель Реалізація Dapr віртуального акторського шаблону — моделі програмування, де кожен актор є легким, становим об’єктом з унікальним ID. Актор обробляє одне повідомлення за раз (без одночасності в акторі), керує своїм власним станом через сховище стану, і може бути неактивним допоки це потрібно. Dapr автоматично керує розташуванням акторів і життєвим циклом.

• Приклад: “Модель кожного сеансу користувача як Dapr Актор з ідентифікатором користувача як ідентифікатором актора - актор утримує стан сеансу, обробляє один запит за раз, щоб запобігти умовам гонки, і деактивується, коли сеанс закінчується.” *

** Секрети API ** Блок Dapr для доступу до секретів зі сховищ секретів (Kubernetes Secrets, Vault, AWS Secrets Manager) за допомогою єдиного API. Ваша програма запитує секрет за назвою у додатка Dapr, і Dapr отримує його з налаштованого сховища секретів, не повідомляючи програмі, яке з них використовується. Приклад: «Використовуйте Dapr Secrets API для отримання пароля бази даних — програма викликає localhost:3500/v1.0/secrets/my-secret-store/db-password і ніколи не повинна знати, чи є секрет у Vault або Kubernetes Secrets.»

Політика стійкості Налаштовувані правила Dapr для обробки помилок у викликах служб і pub/ sub — включаючи тайм- аути, повторні спроби з відновленням і обривами. Ви визначаєте правила збереження у файлах налаштувань YAML, застосованих до додатка Dapr, а не у коді програми, отже, їх можна оновити без повторного розгортання служб.

• Приклад: « Визначити політику стійкості з автоматичним переривником на виклику платіжної служби — якщо платіжна служба відмовляється 5 разів за 30 секунд, ланцюг відкривається і запитує швидку відмову на 60 секунд, щоб запобігти каскадним відмовам. »*

Як використовувати цей словник

Архітектура Dapr обговорюється навколо того, які будівельні блоки використовувати для кожного шаблону інтеграції. Поширеним рішенням щодо проектування є « чи повинні служби спілкуватися за допомогою виклику служби (синхронно) або pub/ sub (асинхронно)? » Відповідь залежить від того, чи потребує викликаючий негайну відповідь або може терпіти подальшу обробку.

Обговорення політики стійкості важливі в Dapr, тому що політика живе поза кодом програми. Команди обговорюють тайм-аути, конфігурації повторних спроб і пороги обмежувачів під час розгортання послуг, а не під час розробки, і вони можуть оновити ці правила без розгортання коду, що є значною операційною перевагою.

Приклад розмови

** Дмитро: ** Служба замовлень перевищує час очікування, коли вона викликає службу запасів під час піків навантаження. ** Ola: ** Чи налаштовано у нас правила стійкості для цього виклику служби? Нам нужно добавить выключатель, чтобы неисправности запасов не переросли в неисправности заказов. ** Дмитро: ** Ще ні — я додам YAML з стійкістю Dapr з 2- секундним таймом, 3 повторними спробами з експоненційним відхиленням і порогом автоматичного відключення. ** Ola: ** Також перевірте, чи слід службі інвентаризації використовувати pub/ sub замість цього — якщо службі замовлення не потрібне негайне підтвердження запасів, асинхронне зберігання є більш стійким.

Practice

1. Пояснити шаблон sidecar розробнику, який звик до безпосереднього імпортування бібліотек. Сфокусуйтеся на тому, чому переміщення логіки розподілених систем з коду вашої програми до додатка робить ваші служби більш портативними і простішими у підтримці. Використовуйте слова « мова- агностичний », « інфраструктура » і « налаштування »
2. Створення архітектури Dapr для програми доставки їжі з трьома службами: замовлення, сповіщення та інвентар. Визначте, які з обмінів між службами слід використовувати для виклику служб (синхронні) проти pub/ sub (асинхронні) і поясніть ваші аргументи щодо кожного з варіантів.
3. Пояснити, що таке політика стійкості Dapr і чому її краще налаштувати у файлі YAML поза кодом програми, а не у самому коді. Які операційні переваги дає це розділення, коли вам потрібно налаштувати поріг автоматичного виключника на виробництві?

Розвиток мовної культури: дослідження культурних відмінностей у мовах

Багато розробників, які вивчають професійну англійську, особливо ті, що переходять з різних мовних середовищ, знаходять тонкі, але важливі відмінності в тому, як обговорюються технічні концепції. Це не просто знати визначення «стійкості», але розуміти приховані очікування і розмовні норми навколо нього. Наприклад, пряме, тупе твердження, на кшталт «Ця служба часто не працює», може бути сприйнято як надто критичне або без контексту в деяких культурах. Аналогічно, надто багатослівні пояснення англійською мовою іноді можуть здатися неефективними в порівнянні з більш короткими стилями спілкування, поширеними в інших місцях. Виявлення цих нюансів дозволяє краще співпрацювати і зменшує потенційні непорозуміння при обговоренні складних архітектур мікросервісів, побудованих з Dapr.

Однією з ключових областей, де це проявляється, є зворотній зв’ язок перегляду коду. Поширена фраза, яку ви почуєте — і яку дехто може спочатку вважати жорсткою — це « Це можна поліпшити ». Хоча це технічно коректно, але це не надає конкретних рекомендацій. Більш конструктивний підхід, який відображає розуміння різних стилів спілкування, буде таким: « Під час тестування я помітив періодичні піки затримки; можливо, дослідження схеми переривання для цього виклику служби може збільшити її стійкість ». Це надає контекст (затримка), пропонує рішення (переривання) і розглядає це як * можливість * для поліпшення, а не як критику. Аналогічно, розмови Slack часто використовують пом’якшення потенційно критичного відгуку з фразами на кшталт «Це може бути корисно для…» або «Чи ви розглядали…» Ці пристрої демонструють повагу до перспективи розробника і заохочують спільне вирішення проблем. Сфокусування на впливі зміни — як вона впливає на продуктивність, безпеку або досвід користувача — часто є більш ефективним, ніж просто вказування на технічні недоліки.

Крім того, при написанні описів PR, уникайте надмірно настійної мови. Замість « Виправлено ваду », спробуйте « Виправлено проблему, що впливає на швидкість завершення операцій ». Кількісне вираження впливу — навіть за оцінками у відсотках — додає ясності і демонструє розуміння бізнес- пріоритетів. Пам’ятайте, що ваша мета - полегшити розуміння, а не просто передати інформацію. Чим більше контексту ви надасте, тим більше шансів на плавний процес інтеграції. Це виходить за рамки простого перекладу термінів; мова йде про прийняття моделей комунікації, які відповідають спільним інженерним практикам.

dapr export --name my-service --namespace default --output ./my-service/deployment.yaml

Ця команда, використовуючи dapr export, є прикладом типу докладних інструкцій, які часто вимагаються в технічній документації та обговореннях. Точність, необхідна для визначення конфігурації розгортання - вказуючи назву сервісу ( my-service ), простір імен ( default ) і шлях до файлу виводу ( ./my-service/deployment.yaml ) - підкреслює важливість ясності і точності при повідомленні технічних специфікацій. Це стосується передачі не тільки того, що потрібно зробити, але і того, як це зробити ефективно.