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

Loki — сервер агрегації журналів для Kubernetes

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

Loki — це бекенд журналів: він отримує потоки журналів через свій HTTP push API, індексує їх за мітками, а не за повнотекстовим вмістом, зберігає їх в об’єктному сховищі чанків і відповідає на запити журналів і запити діапазонів через той самий HTTP API. В однобінарній формі кожна підсистема Loki — distributor, ingester, querier, compactor — працює в одному процесі з локальним сховищем чанків, тож увесь сервер є одним робочим навантаженням зі станом. Відправник журналів надсилає потоки в Loki; сервер дашбордів зчитує їх назад через API запитів.

Файли

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

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

  • Одна поверхня написання. Єдиний Aggregate є джерелом істини щодо того, чим є Loki; Manifest визначає, як це реалізувати.
  • Однобінарний бекенд журналів. Запозичений Recipe рендерить Loki як один StatefulSet із томом даних, його конфігурацію в об’єктах ConfigMap, об’єкти Service, що відкривають HTTP-ендпоінт надсилання й запитів, і ServiceAccount — єдине самодостатнє робоче навантаження, без розподілених шляхів масштабування та вбудованих допоміжних сервісів.
  • Термін зберігання, заданий розробником. Значення retention_period від розробника передається у вбудований compactor, який видаляє збережені потоки журналів, щойно вони стають старішими за нього.
  • Експортований контракт приймання. Компонент експортує свій внутрішньокластерний хост і порт сервісу через топологію uses, тож відправник журналів під’єднується до нього і надсилає туди потоки.
  • Відтворювані образи. Recipe фіксує образ сервера Loki та образ sidecar-контейнера перезавантаження конфігурації на теги, що розв’язуються, тож відрендерене робоче навантаження посилається на зафіксовані версії.

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

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

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

Terminal window
aggrega scaffold --example loki-logging

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

Terminal window
cd loki-logging

Збирання

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

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

Відрендерені артефакти потрапляють у dist/. Збірка розв’язує висхідний чарт за посиланням OCI під час aggrega pull і фіксує його в lock-файлі.

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

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

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

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

Збірка видає сервер Loki як єдиний самодостатній набір об’єктів Kubernetes:

  • StatefulSet — однобінарний процес Loki зі сховищем чанків на постійному томі,
  • об’єкти ConfigMap — конфігурація Loki та конфігурація часу виконання,
  • об’єкти Service — відкривають HTTP-ендпоінт надсилання й запитів на порту 3100,
  • ServiceAccount для робочого навантаження з його прив’язками доступу.

Розподілені робочі навантаження read/write/backend, сабчарт об’єктного сховища, кеш чи оператор не рендеряться — результат є одним робочим навантаженням Loki. Образи сервера Loki та sidecar-контейнера перезавантаження конфігурації зафіксовано на їхніх релізних тегах, тож робоче навантаження посилається на зафіксовані образи.