Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Jaeger — однонодовий бекенд трасування в Kubernetes

Цей приклад компілює невеликий реальний стек — бекенд розподіленого трасування Jaeger в однонодовій конфігурації — з одного Aggregate, написаного розробником, у Kubernetes, синтезуючи його безпосередньо з офіційного образу Jaeger без upstream-чарта.

Jaeger — це бекенд трас: він отримує спани за протоколом OpenTelemetry, зберігає їх у локальному вбудованому сховищі «ключ-значення» й відповідає на запити пошуку трас через свій UI запитів. В однонодовій конфігурації приймач OTLP, записувач сховища й сервіс запитів працюють в одному процесі з локальним сховищем на диску, тож увесь сервер — це одне робоче навантаження зі станом. Інструментований застосунок надсилає спани до приймача OTLP у Jaeger; оператор читає їх через UI.

Файли

ФайлРоль
aggregate.yamlНамір розробника: один компонент tracing (core/observability/jaeger).
manifest.yamlЗіставляє тип компонента із синтезувальним Recipe для Jaeger (jaeger).
release.yamlЗапис оператора для цілі Kubernetes: обчислювальні ресурси сервера й розмір тому сховища трас.

Що демонструє приклад

  • Одна поверхня авторингу. Єдиний Aggregate є джерелом істини щодо того, що таке Jaeger; Manifest визначає, як це реалізувати.
  • Однонодовий бекенд трас. Синтезувальний Recipe рендерить Jaeger як один StatefulSet із томом даних, один ConfigMap із конфігурацією Jaeger v2 і два об’єкти Service — ClusterIP, що відкриває приймачі та UI, і headless-сервіс, який керує StatefulSet.
  • Конфігурація як файл. Jaeger v2 — це дистрибутив OpenTelemetry Collector, який налаштовується YAML-файлом. Recipe видає цю конфігурацію як ConfigMap і монтує її в контейнер у /etc/jaeger, а контейнер читає її за допомогою --config /etc/jaeger/config.yaml.
  • Постійні траси. Вбудоване сховище «ключ-значення» записує дані в постійний том у /badger, тож дані трас зберігаються після перезапусків.
  • Експортований контракт приймання. Компонент експортує хост і порт свого приймача OTLP gRPC через топологію uses, тож виробник трас підключається до нього й надсилає туди спани.
  • Відтворювані образи. Recipe фіксує образ сервера Jaeger на тезі, що розв’язується, тож відрендерене робоче навантаження посилається на зафіксовану версію.

Створення прикладу

Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.

Запишіть приклад у нову теку, названу за ним:

Terminal window
aggrega scaffold --example jaeger-tracing

Потім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:

Terminal window
cd jaeger-tracing

Збирання

Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Відрендерені артефакти потрапляють у dist/. Ціль Kubernetes рендерить звичайні маніфести офлайн — завантаження чарта не потрібне.

З ШІ-асистентом

ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.

Використовуйте лише інструменти Aggrega і не створюйте жодної теки самостійно. Якщо тека робочого простору ще не містить теки `jaeger-tracing`, викличте один раз інструмент `scaffold`, задавши для `example` значення `jaeger-tracing`, без `dir`: він запише приклад у нову теку `jaeger-tracing`. Потім викличте інструмент `build`, задавши для `workspace_root` значення `jaeger-tracing`, для `release` — `release.yaml`, для `auto_pull` — true і для `write` — true. Скажіть, які файли записала збірка; вони розташовані в `jaeger-tracing/dist/`.

Що рендериться

Збирання видає сервер Jaeger як чотири об’єкти Kubernetes:

  • StatefulSet — однонодовий процес Jaeger із вбудованим сховищем трас на постійному томі, змонтованому в /badger, і конфігурацією, змонтованою в /etc/jaeger,
  • ConfigMap — конфігурація Jaeger v2 (приймачі OTLP, пакетний процесор і вбудоване сховище «ключ-значення», що записує в /badger/key і /badger/data),
  • ClusterIP Service — відкриває приймач OTLP gRPC на порту 4317, приймач OTLP HTTP на 4318 і UI запитів на 16686,
  • headless Service — керівний сервіс, потрібний StatefulSet для стабільної ідентичності кожної репліки.

Образ Jaeger зафіксовано на тезі його релізу, тож робоче навантаження посилається на зафіксований тег образу.