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

cert-manager — контролер життєвого циклу TLS-сертифікатів Kubernetes

Цей приклад компілює невеликий реальний стек — контролер сертифікатів cert-manager — з одного написаного розробником Aggregate у Kubernetes. Розробник оголошує, що таке cert-manager; єдиний операційний Recipe зіставляє цей намір з офіційним Helm-чартом cert-manager з реєстру jetstack і рендерить об’єкти Kubernetes.

cert-manager — це доповнення Kubernetes рівня кластера, яке автоматизує випуск і поновлення сертифікатів X.509 з джерел випуску, таких як ACME (Let’s Encrypt), приватний CA або Vault. Воно розширює кластер власними користувацькими ресурсами Certificate, Issuer і ClusterIssuer. Застосунки запитують сертифікати, оголошуючи ці ресурси, а не підключаючи висхідний сервіс, тому компонент не має ребра uses. З тієї самої причини він не має окремої форми локального контейнера, тож ця родина постачає лише Helm Recipe; цілі Compose немає. Усе, що публікує компонент, — це місце, де сервер Prometheus знаходить його метрики.

Файли

ФайлРоль
aggregate.yamlНамір розробника: єдиний компонент cert-manager (core/security/cert-manager) з увімкненим встановленням CRD.
manifest.yamlЗіставляє тип компонента з Helm Recipe для cert-manager (cert-manager).
release.yamlОператорський запис для цілі Kubernetes: розміри контролера, вебхука та CA-інжектора.

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

  • Одна поверхня авторингу, реалізована операційним Recipe. Aggregate є джерелом істини щодо того, що таке cert-manager. Manifest визначає, як його реалізувати, зіставляючи тип компонента з Recipe за назвою; Release надає операційні розміри. Намір розробника й операційне зіставлення залишаються розділеними.
  • Три узгоджені робочі навантаження з одного компонента. Recipe рендерить усі три частини cert-manager: Deployment для контролера, який узгоджує запити на сертифікати, Deployment для вебхука, який перевіряє користувацькі ресурси й задає їм типові значення, і Deployment для CA-інжектора, який вбудовує пакет CA вебхука в кластер.
  • Встановлення API сертифікатів. Значення розробника install_crds передається в чарт, який встановлює ресурси CustomResourceDefinition cert-manager (ресурси Certificate, Issuer, ClusterIssuer та ACME Order/Challenge). Встановіть його в false, якщо CRD керуються окремо.
  • Підключення admission. Чарт генерує ValidatingWebhookConfiguration і MutatingWebhookConfiguration, які обслуговує вебхук, Service вебхука та повний набір RBAC — по одній парі ClusterRole/ClusterRoleBinding на кожен обов’язок контролера, а також ресурси Role для вибору лідера, — тож контролер має потрібні йому дозволи.
  • Відтворювані образи. Чарт постачається з тегами релізів, які можна розв’язати; Recipe повторно фіксує образи контролера, вебхука, CA-інжектора та ACME-розв’язувача на цих тегах, тож відрендерені робочі навантаження посилаються на зафіксовані версії.

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

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

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

Terminal window
aggrega scaffold --example cert-manager-tls

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

Terminal window
cd cert-manager-tls

Збирання

Цей робочий простір не містить .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 і не створюйте жодної теки самостійно. Якщо тека робочого простору ще не містить теки `cert-manager-tls`, викличте один раз інструмент `scaffold`, задавши для `example` значення `cert-manager-tls` і не задаючи `dir`: він запише приклад у нову теку `cert-manager-tls`. Потім викличте інструмент `build`, задавши для `workspace_root` значення `cert-manager-tls`, для `release` — `release.yaml`, для `auto_pull` — true і для `write` — true. Скажіть мені, які файли записала збірка; вони лежать у `cert-manager-tls/dist/`.

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

Збірка генерує повний стек cert-manager — три ресурси Deployment (контролер, вебхук і CA-інжектор), шість ресурсів cert-manager CustomResourceDefinition, коли install_crds увімкнено, ValidatingWebhookConfiguration і MutatingWebhookConfiguration, Service вебхука, ресурси ServiceAccount контролера та набір RBAC із ресурсів ClusterRole, ClusterRoleBinding, а також Role і RoleBinding для вибору лідера. Він також містить післяінсталяційний Job (стартова перевірка API, яка блокує виконання, доки API сертифікатів не почне обслуговувати запити) і по одному Service метрик для контролера та для CA-інжектора — загалом 50 об’єктів Kubernetes. Образи контролера, вебхука, CA-інжектора та ACME-розв’язувача зафіксовано на їхніх тегах релізів, тож кожне робоче навантаження посилається на зафіксований тег образу.