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передається в чарт, який встановлює ресурсиCustomResourceDefinitioncert-manager (ресурсиCertificate,Issuer,ClusterIssuerта ACMEOrder/Challenge). Встановіть його в false, якщо CRD керуються окремо. - Підключення admission. Чарт генерує
ValidatingWebhookConfigurationіMutatingWebhookConfiguration, які обслуговує вебхук,Serviceвебхука та повний набір RBAC — по одній паріClusterRole/ClusterRoleBindingна кожен обов’язок контролера, а також ресурсиRoleдля вибору лідера, — тож контролер має потрібні йому дозволи. - Відтворювані образи. Чарт постачається з тегами релізів, які можна розв’язати; Recipe повторно фіксує образи контролера, вебхука, CA-інжектора та ACME-розв’язувача на цих тегах, тож відрендерені робочі навантаження посилаються на зафіксовані версії.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example cert-manager-tlsПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd cert-manager-tlsЗбирання
Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен:
aggrega pull --release release.yamlaggrega 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-розв’язувача зафіксовано на їхніх тегах релізів, тож кожне робоче навантаження посилається на зафіксований тег образу.