Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

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 передаётся в чарт, который устанавливает ресурсы CustomResourceDefinition cert-manager (ресурсы Certificate, Issuer, ClusterIssuer и ACME Order/Challenge). Установите значение false, если CRD управляются отдельно.
  • Подключение admission. Чарт создаёт ValidatingWebhookConfiguration и MutatingWebhookConfiguration, которые обслуживает webhook, Service для webhook и полный набор RBAC — по одному ClusterRole/ClusterRoleBinding на каждую обязанность контроллера плюс Role для выбора лидера, — чтобы у контроллера были нужные ему права.
  • Воспроизводимые образы. Чарт поставляется с разрешимыми тегами выпусков; Recipe заново закрепляет образы controller, webhook, CA-injector и ACME solver за этими тегами, чтобы сформированные рабочие нагрузки ссылались на закреплённые версии.

Создание примера

Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.

Запишите пример в новую папку, названную по его имени:

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 (контроллер, 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 закреплены за тегами выпусков, поэтому каждая рабочая нагрузка ссылается на закреплённый тег образа.