Add week 7 materials

2026-10-21 23:03:28 +03:00
parent 4bb38fb0a8
commit a987b82834
22 changed files with 1265 additions and 0 deletions
@@ -0,0 +1,90 @@
+# Consul: от имени до ответа приложения
+
+Consul хранит сведения об экземплярах сервисов: их идентификаторы, адреса и результаты проверок работоспособности. Клиент может найти экземпляр по имени сервиса, а затем отправить запрос непосредственно ему.
+
+В стенде у сервиса `orders` два экземпляра: `app-a` и `app-b`. **Предскажите:** если остановить один из них, изменятся ли каталог Consul, список здоровых экземпляров и сохранённый клиентом адрес одновременно?
+
+Все команды выполняются из каталога `seminar`; [подготовка стенда](../readme.md#самостоятельный-запуск-опытов).
+
+## 1. Найти экземпляры
+
+Запустите сервисы и дождитесь, пока оба экземпляра пройдут проверки:
+
+~~~powershell
+docker compose up -d --wait consul app-a app-b
+docker compose run --rm -T tools python3 consul/client.py wait
+~~~
+
+Сравните каталог регистраций и список здоровых экземпляров:
+
+~~~powershell
+docker compose run --rm -T tools curl -fsS "http://consul:8500/v1/catalog/service/orders"
+docker compose run --rm -T tools curl -fsS "http://consul:8500/v1/health/service/orders?passing=true"
+~~~
+
+Каталог содержит зарегистрированные экземпляры независимо от их текущего состояния. Второй запрос с `passing=true` возвращает только экземпляры, прошедшие проверки. В ответе каталога найдите `ServiceName`, `ServiceID`, `ServiceAddress` и `ServicePort`: это имя сервиса, ID экземпляра, его адрес и порт.
+
+Адреса экземпляров можно получить и через DNS-интерфейс Consul:
+
+~~~powershell
+docker compose run --rm -T tools dig "@consul" -p 8600 orders.service.consul A +short
+docker compose run --rm -T tools dig "@consul" -p 8600 orders.service.consul SRV +short
+~~~
+
+Запись **A** содержит IPv4-адрес. Строка **SRV** имеет вид `приоритет вес порт имя-узла`, поэтому позволяет узнать и порт приложения — в нашем случае `8080`. Аргумент `-p 8600` задаёт порт самого DNS-сервера Consul.
+
+**Вопрос:** откуда клиент узнает порт приложения, если запросил только A-запись?
+
+## 2. Сохранить адрес и выполнить запрос
+
+~~~powershell
+docker compose run --rm -T tools python3 consul/client.py save
+docker compose run --rm -T tools python3 consul/client.py cached
+~~~
+
+Команда `save` выбирает первый здоровый экземпляр по ID — `app-a` — и сохраняет его адрес. Команда `cached` обращается по сохранённому адресу. В HTTP-ответе поле `instance` показывает, кто обработал запрос.
+
+Таким образом, клиент сначала получает адрес через HTTP API Consul, затем обращается к приложению. DNS-запросы выше иллюстрируют другой способ поиска адреса.
+
+## 3. Остановить приложение и сравнить результаты
+
+Остановите `app-a` и дождитесь, пока Consul обнаружит сбой:
+
+~~~powershell
+docker compose stop app-a
+docker compose run --rm -T tools python3 consul/client.py wait --ids app-b
+~~~
+
+Теперь сравните каталог, список здоровых экземпляров и DNS-ответ:
+
+~~~powershell
+docker compose run --rm -T tools curl -fsS "http://consul:8500/v1/catalog/service/orders"
+docker compose run --rm -T tools python3 consul/client.py list
+docker compose run --rm -T tools dig "@consul" -p 8600 orders.service.consul A +short
+~~~
+
+В каталоге всё ещё есть `app-a`: остановка приложения сама по себе не удаляет регистрацию. Список здоровых экземпляров содержит только `app-b`, а DNS возвращает лишь его адрес.
+
+Сравните запрос по сохранённому адресу с новым поиском:
+
+~~~powershell
+docker compose run --rm -T tools python3 consul/client.py cached
+docker compose run --rm -T tools python3 consul/client.py fresh
+~~~
+
+`cached` завершается с `REQUEST FAILED` и кодом 1 — это ожидаемый результат. `fresh` заново ищет здоровый экземпляр и получает ответ от `app-b`.
+
+Проверки выполняются периодически, поэтому Consul замечает остановку с задержкой. Но даже после обнаружения сбоя сохранённый клиентом адрес не меняется сам. В этом опыте клиент хранит его в файле без срока действия; автоматическое истечение записей рассмотрим в [разделе DNS](../dns/readme.md).
+
+**Вопросы для самопроверки:** гарантирует ли свежий поиск успех следующего запроса? Зачем клиенту тайм-аут и возможность выбрать другой экземпляр? Почему повтор операции с побочным эффектом требует отдельной защиты от повторного выполнения?
+
+## 4. Восстановить исходное состояние
+
+~~~powershell
+docker compose start app-a
+docker compose run --rm -T tools python3 consul/client.py wait
+~~~
+
+В этом стенде один агент Consul и два приложения. Отказоустойчивость самого Consul здесь не проверяется.
+
+Исходники: [приложение и регистрация](app.py), [клиент](client.py). Документация: [регистрация сервиса](https://developer.hashicorp.com/consul/api-docs/agent/service), [DNS-интерфейс](https://developer.hashicorp.com/consul/docs/discover/dns).