Англійською для HashiCorp Consul

Consul обробляє дві пов’язані, але відмінні роботи - виявлення сервісу і, все більше, мережевий сервіс - і розмови про це часто розмивають два разом. Вміння чітко розділити їх англійською мовою і назвати конкретні концепції Consul точно, робить набагато легше діагностувати, чи проблема стосується пошуку служби або мережевого шляху до неї.

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

** Реєстрація служби ** — процес, за допомогою якого запущена служба повідомляє Consul про те, що вона існує, зокрема, про її адресу, порт і будь- які мітки, щоб інші служби могли виявити її. “Новий екземпляр не з’ являється у виявленні, оскільки він ніколи не закінчував реєстрацію служби — перевірте, чи налаштування агента вказують на правильний кластер Consul.”

** Перевірка стану ** — періодичне обстеження, яке виконує Consul на зареєстрованій службі (HTTP, TCP або скрипту) для визначення того, чи можна вважати її стан належним і чи можна отримувати з неї трафік.

• “Цей екземпляр зареєстровано, але позначено як непрацездатний, отже Consul правильно маршрутизує трафік навколо нього — помилка у перевірці стану, а не у виявленні.” *

** Service mesh ** — виділений шар інфраструктури, у випадку з Consul побудований на проксі- серверах, що обробляє обмін даними між службами, шифрування і політику трафіку без зміни коду програми. “Якщо ми знаходимося у мережі служб, ми отримуємо взаємний TLS між кожною службою автоматично, без необхідності для будь- якої з них керувати сертифікатами самостійно.”

** Intent ** — правило Consul Connect, яке явно дозволяє або забороняє обмін даними між двома службами у мережі, формуючи основу моделі мережі нульової довіри. “Ця служба не може дістатися API платежів, оскільки не має наміру дозволяти це — нам потрібно додати його, перш ніж мережа дозволить з’ єднання.”

** Каталог ** — центральний реєстр Consul, який містить всі відомі служби, вузли і їх стан стану у кластері, з якого читаються запиту обнаружения і пошуку DNS. “Запит до каталогу безпосередньо показав, що служба зареєстрована правильно, отже, проблема з розв’ язанням DNS, мабуть, є в інших налаштуваннях клієнта.”

Звичайні фрази

• Чи є служба дійсно зареєстрована, або це невдача перевірки стану здоров’я?
• Чи є у нас намір дозволити це з’єднання в мережі, або ж воно заблоковане за замовчуванням?
• «Давайте перевіримо каталог безпосередньо, щоб виключити проблему виявлення перед зневадженням мережі.»
• Чи це обробляється служби виявлення, або це потребує mesh’s traffic policy? ”
• Процитовано 2011-03-14.  Which health check is failing — HTTP, TCP, or the custom script?

Приклади висловлювань

Діагностика помилки маршрутизації: “Транспорт не доходить до цього екземпляра, оскільки його перевірка стану не спрацювала протягом останніх десяти хвилин — Consul правильно уникнув цього, це не помилка виявлення.”

Пояснення обмеження сітки: “Ви не можете викликати цю службу, оскільки наразі немає намірів її дозволяти — як тільки ми додамо її, взаємний TLS і маршрутизація працюватимуть автоматично.”

Впровадження нової служби: “Якщо ваша служба завершить реєстрацію і пройде перевірку стану, її буде показано у каталогу і буде можливо знайти за допомогою інших служб.”

Професійні поради

• Відокремте ** service discovery ** від ** service mesh ** у розмові — це може бути або помилка маршрутизації, або назва, яку ви підозрюєте, що є фокусом зневадження.
• Перевірте стан ** перевірки стану ** перед тим, як вважати, що відсутня служба є вадами реєстрації — непрацездатна, але зареєстрована служба виглядає так само, як і пошкоджене відкриття з точки зору клієнта.
• Коли в з’ єднанні mesh відмовлено, спочатку запитайте про ** намерення ** — Consul Connect зазвичай відмовляє, тому відсутнє намерення є найпоширенішою причиною « чому ця служба не може досягти цього. »
• Використовувати запит до ** каталогу ** безпосередньо під час зневадження проблем з виявленням — він дасть вам остаточну інформацію про те, чи є проблемою реєстрація, чи щось інше, наприклад, кешування DNS або клієнта.

Практичні вправи

1. Поясніть одним реченням різницю між виявленням служб і мережею служб.
2. Описати, що таке « намір » і чому з’ єднання мережею може зазнати невдачі, навіть якщо обидві служби працюють належним чином і зареєстровані.
3. Напишіть два речення, у яких ви поясните співробітнику команди, як ви визначаєте, чи є проблема « Службу не знайдено » проблемою реєстрації або проблемою перевірки стану.

Наприклад, описати нову функцію: Перевірити значення в графі

Consul, як основний компонент багатьох сучасних розподілених систем, часто вимагає точного спілкування при описі проблем або запропоновані зміни. Для не рідних носіїв англійської мови, оволодіння тонкими нюансами професійного словника може значно поліпшити співпрацю і зменшити непорозуміння. Це не просто переклад слів; це про передачу намірів, невідкладності і технічних деталей ефективно. Поширеною пасткою є використання надто буквальних перекладів з вашої рідної мови - це може призвести до двозначності і розчарування в команді, звичній до певного стилю спілкування.

Розглянемо коментар перегляду коду на запиті на збирання для нової кінцевої точки реєстрації служби: « Перевірку стану слід поліпшити ». Хоча це технічно вірно, у цьому коментарі бракує контексту. Більш гладким підходом буде: “Я помітив, що поточна перевірка стану тільки перевіряє базове з’єднання. Чи можемо ми розширити це, щоб включити перевірки на кінцевих точках API служби? Це дасть більш надійну индикацію загальної доступності послуги і дозволить нам проактивно визначати потенційні проблеми.”Різниця не тільки в самих словах; це в наслідках - пропозиція щодо поліпшення оформляється як проактивне рішення, а не просто спостереження. Аналогічно, повідомлення Slack повинні бути чіткими і короткими. Замість того, щоб сказати « Консуль не працює », спробуйте « Служба періодично не може виконати перевірку стану — дослідження потенційних проблем з’ єднання з мережею »

Інший поширений сценарій включає опис змін у описі запиту на завантаження. Хорошим підходом буде: « Ця публікація вводить нове налаштування агента Consul, яке дозволяє автоматично повторювати механізми для невдалих перевірок стану. Це зменшує вплив перехідних помилок мережі і покращує загальну стійкість системи. Налаштування включає 3- секундний інтервал повторних спроб з експоненціальним відновленням. » Зауважте використання фраз на зразок « покращує загальну стійкість системи » — це стандартні терміни, які використовуються для вираження * впливу * зміни, а не просто того, що код * робить *. Сфокусування на бізнес-цінності і потенційних наслідках є ключовим при обміні технічними деталями. Також важливо визнати потенційні ризики; заява «Ця конфігурація змінює типову поведінку повторних спроб, яка може потенційно погіршити певні проблеми мережі, якщо не буде належним чином моніторити» демонструє обізнаність і заохочує подальшу дискусію.

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

consul version check
consul version --format=json