cert-manager — контроллер жизненного цикла TLS-сертификатов в Kubernetes
Этот пример компилирует небольшой реальный стек — контроллер сертификатов cert-manager — из одной написанной разработчиком сущности Aggregate в Kubernetes. Разработчик объявляет, что такое cert-manager; единственный Recipe от Ops сопоставляет это намерение с официальным 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: размеры controller/webhook/CA-injector. |
Что демонстрирует пример
- Одна поверхность для написания, реализуемая через Recipe от Ops. Aggregate — источник истины о том, что такое cert-manager. Manifest указывает, как его реализовать, сопоставляя тип компонента с Recipe по имени; Release задаёт эксплуатационные размеры. Намерение разработчика и сопоставление Ops остаются раздельными.
- Три согласованные рабочие нагрузки из одного компонента. Recipe формирует все
три части cert-manager:
Deploymentдля контроллера, который согласовывает запросы сертификатов,Deploymentдля webhook, который проверяет пользовательские ресурсы и задаёт для них значения по умолчанию, иDeploymentдля CA injector, который встраивает CA-бандл webhook в кластер. - Установка API сертификатов. Значение разработчика
install_crdsпередаётся в чарт, который устанавливает ресурсыCustomResourceDefinitioncert-manager (ресурсыCertificate,Issuer,ClusterIssuerи ACMEOrder/Challenge). Установите значение false, если CRD управляются отдельно. - Подключение admission. Чарт создаёт
ValidatingWebhookConfigurationиMutatingWebhookConfiguration, которые обслуживает webhook,Serviceдля webhook и полный набор RBAC — по одномуClusterRole/ClusterRoleBindingна каждую обязанность контроллера плюсRoleдля выбора лидера, — чтобы у контроллера были нужные ему права. - Воспроизводимые образы. Чарт поставляется с разрешимыми тегами выпусков; Recipe заново закрепляет образы controller, webhook, CA-injector и ACME solver за этими тегами, чтобы сформированные рабочие нагрузки ссылались на закреплённые версии.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
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 (контроллер, webhook и CA injector), шесть ресурсов cert-manager CustomResourceDefinition, если install_crds включено, ValidatingWebhookConfiguration и MutatingWebhookConfiguration, Service для webhook, ресурсы ServiceAccount контроллера и набор RBAC из ресурсов ClusterRole, ClusterRoleBinding, а также Role и RoleBinding для выбора лидера. В него также входят Job после установки (стартовая проверка API, которая ожидает, пока API сертификатов не начнёт работать) и по одному Service метрик для контроллера и для CA injector — всего 50 объектов Kubernetes. Образы controller, webhook, CA-injector и ACME-solver закреплены за тегами выпусков, поэтому каждая рабочая нагрузка ссылается на закреплённый тег образа.