Helm Provider
Провайдер helm создаёт плоский отрендеренный YAML для Kubernetes, предназначенный для потребителей GitOps (ArgoCD, Flux). Провайдер выполняет сборку по каждой паре (path, provider): отрендеренный YAML каждого узла, нацеленного на helm, направляется в сборщик с ключом, образованным вычисленным значением directory: границы, объединённым со значением subDirectory: каждого компонента, и этот сборщик выдаёт по одному файлу YAML на каждый ресурс Kubernetes. Последующие инструменты сравнивают и применяют эти файлы напрямую, без шага установки Helm.
Если syncWave: <integer> границы не равен 0, каждый выданный ресурс Kubernetes несёт его в виде аннотации argocd.argoproj.io/sync-wave: "<N>"; хуки Helm дополнительно несут helm.sh/hook-weight: "<N>". ArgoCD читает аннотацию sync-wave, а Helm — вес хука, и каждый из них упорядочивает ресурсы по этому значению; граница с волной по умолчанию 0 не несёт ни того, ни другого, что оба инструмента читают как волну 0.
Эта страница — справочник по написанию для провайдера helm. Модель композиции входных данных, общую для всех провайдеров, см. в architecture/16-recipe-input-composition.md. Готовность каждого провайдера см. в разделе Состояние языка → Providers.
Поддерживаемые виды входных данных
Провайдер helm принимает все три вида входных данных Recipe в разных ролях:
- Режим с источником. Recipe с
source: <chart-path>указывает на каталог чарта Helm на диске. Helm Go SDK загружает чарт, словарь значений базового рендеринга объединяется со значениями чарта по умолчанию, а шаблоны чарта рендерятся в плоский YAML Kubernetes. - Режим Workload (синтезируемый). Recipe с
workload:(встроенным или загруженным через$import:) объявляет документ Workload. Провайдер синтезирует один или несколько ресурсов Kubernetes на каждый узел — объект-контроллер, выбираемый поformсущности Workload, а также Services для каждого сервиса и PVC для каждого постоянного тома — непосредственно из спецификации Workload; см. Режим Workload (синтезируемый). - Режим только артефактов. Recipe с
artifacts:и безsource:иworkload:выдаёт манифесты, написанные автором, встраивая метки и аннотации происхождения сборки в собственные метаданные каждого ресурса.
Эти три вида сочетаются: Recipe может одновременно объявить чарт, Workload и artifacts:, и каждый из них рендерится и выдаётся самостоятельно, бок о бок в выходных данных узла — см. Что принимает каждый провайдер, полностью.
Набор ключей source:
Поле source: провайдера helm указывает на чарт и принимает обе формы, которые может иметь поле source:: простую строку пути в файловой системе и структурированный объект, в котором url: содержит расположение. Если это расположение — путь в файловой системе, он отсчитывается от каталога, содержащего объявляющий его recipe.yaml, а не от каталога, из которого запущена сборка, и должен оставаться внутри этого каталога: путь, выходящий за его пределы, или абсолютный путь отклоняется, потому что каждый файл, который несёт публикация Recipe, берётся из её каталога — см. entities/recipe.md «Content paths stay inside the Recipe’s own directory». Чарт, указанный таким образом, публикуется вместе с Recipe — каждый файл в нём, который сохраняют правила игнорирования, записанные при закреплении Recipe: провайдер helm исключает каталоги системы контроля версий и скрытые файлы в templates/ чарта, учитывает собственный .helmignore чарта, а последнее слово остаётся за .aggregaignore автора, как описано в разделе Какие файлы поставляются с сущностью, — тогда как файл рядом с Recipe, на который не ссылается ничто из её объявлений, не публикуется. Рендеринг читает те же файлы, что несёт публикация, поэтому чарт рендерится одинаково из вашего каталога и из реестра. Форма записи на это не влияет: структурированный source:, у которого url: равен ./charts/api-server, отсчитывается точно так же, как простая строка ./charts/api-server.
spec: capability: helm source: ./charts/api-server # filesystem path to a chart directory valuesMapping: | image: "{{ .values.image }}" replicas: {{ optional .infra `replicas` 2 }}Структурированный source: выражает то же самое именованными полями, и содержимое его url: определяет, загружается ли что-либо. Если url: содержит схему транспорта — oci://… для OCI-чарта, https://….tgz для прямого архива чарта или корень репозитория https:// в паре с chart:, — чарт загружается: вид определяется схемой URL или явным kind:, aggrega pull загружает чарт и закрепляет его в lock-файле, а сборка извлекает его из кеша. Если url: указывает путь в файловой системе, ничего не загружается и ничего не закрепляется — чарт читается с диска и отсчитывается точно так же, как в форме простой строки выше.
spec: capability: helm source: kind: helm-oci-chart url: ./charts/api-server # a path, so nothing is fetched and nothing is pinned version: "1.0.0"Только url: определяет, откуда читается чарт. Остальные поля выбирают, что было бы загружено, поэтому для пути они ничего не выбирают — но по-прежнему доступны собственным шаблонам Recipe как .source.*.
Локальное размещение чарта (vendoring) поддерживается как альтернатива загрузке и не является обязательным. Схема принимает открытый структурированный объект.
Чарт по пути источника должен содержать корректный Chart.yaml. Если при рендеринге с источником чарт не удаётся загрузить, ошибка Helm SDK выводится дословно. Пустой source: "" не относится к helm: он не задаёт ни режим без источника, ни режим с источником, поэтому вызываемый им отказ одинаков для любого провайдера, на который нацелена Recipe, и возникает при чтении сущности Recipe, до загрузки какого-либо чарта и до передачи управления этому провайдеру. Какие команды сообщают о нём, описано в entities/recipe.md «Source field scheme inventory» и errors/fatal-halts.md «Recipe source: is an empty string (Поле source сущности Recipe — пустая строка)».
Режим с источником
Recipe с source: <chart-path> и valuesMapping: при базовом рендеринге выполняет следующий конвейер:
- Чарт по пути
<chart-path>загружается через Helm Go SDK. - Шаблон
valuesMappingвычисляется в контексте шаблонов сущности Recipe. Его вывод в формате YAML рассматривается как наложение значений (values overlay) для чарта. - Наложение объединяется со значениями по умолчанию из
values.yamlчарта один раз; при совпадении ключей побеждают ключи наложения (стандартная семантика Helmhelm install --values). Ключ, которому наложение присваиваетnull, удаляет значение чарта по умолчанию для него — на верхнем уровне, внутри таблицы или в значениях зависимости, — как это делаетhelm install --values, поэтому шаблоны чарта видят ключ как отсутствующий;nullдля ключа, у которого в чарте нет значения по умолчанию, доходит до шаблонов какnull. - Helm SDK рендерит шаблоны чарта с объединёнными значениями.
- Aggrega внедряет свои метаданные происхождения в отрендеренные манифесты путём переписывания YAML после рендеринга, так что вывод режима с источником несёт ту же разметку метками, что и вывод режима Workload. Значения идентичности становятся метками (
app.kubernetes.io/name,aggrega.ai/component-id,aggrega.ai/provider,aggrega.ai/provider-version,aggrega.ai/environmentи — если заданы —aggrega.ai/aggregate-name,aggrega.ai/compiler-version), каждая записывается в форме, которую Kubernetes принимает как значение метки; значения, которые метка Kubernetes не может представить, становятся аннотациями (aggrega.ai/recipe-uri,aggrega.ai/boundary-path,aggrega.ai/sync-wave, если волна не равна0, и дословное значение любой метки, значение которой пришлось переписать, — сущность Aggregate с именемimported/flowполучает меткуimported-flowи аннотациюimported/flowпод тем же ключом). Правило переписывания изложено в well-known-annotations.md «Метки происхождения, выводимые провайдерами». - Выходные файлы помещаются без вложенности в выходной каталог сущности Recipe, по одному на каждый отрендеренный ресурс, с именем
<name-basis>-<kind>[-<namespace>]-<name>.yaml— та же основа, из которой выводится имя релиза ниже, затем собственный вид ресурса, пространство имён, если оно есть, и имя; каждая часть приводится к нижнему регистру, а каждая последовательность прочих символов заменяется одним дефисом. Для обычного компонента эта основа — собственная идентичность компонента, которую также несёт меткаaggrega.ai/component-idресурса; для чарта, предоставленного автором подключения Feature, основа остаётся основой компонента-хоста, а метка несёт собственную идентичность подключения. Документ без вида или без имени получает имя по пути своего шаблона. Структура каталогов чарта уплощается: в отрендеренном выводе нет подкаталогаtemplates/, а два шаблона в разных подкаталогах с одинаковым именем файла остаются двумя файлами, поскольку имя берётся из ресурса, а не из шаблона. Файл, который называет блокartifacts:сущности Recipe, сюда не попадает: он лежит на один каталог ниже, в каталоге, названном по компоненту, который его объявил, поскольку такой файл назван по ключу, написанному его автором, а не по ресурсу, который он несёт, — без этого каталога два компонента, привязанные к одной Recipe, записали бы один путь, и ни один из авторов не смог бы их разделить.
Пространство имён, в котором рендерится чарт, считывается из аннотации aggrega.ai/namespace, наследуемой от границы, и передаётся чарту как пространство имён его релиза; если ни одна граница его не объявляет, чарт рендерится в default. Если граница объявляет пространство имён, каждый намespaced ресурс, который чарт рендерит без пространства имён — без metadata.namespace или с пустым либо null значением, — выводится в объявленном пространстве имён, то есть туда, куда его поместила бы установка чарта через Helm с этим пространством имён релиза, а его файл получает имя с сегментом пространства имён точно так же, как ресурс, шаблон которого записывает это поле. Ресурс, шаблон которого записывает пространство имён, сохраняет его, какое бы пространство имён там ни было указано. Ресурс уровня кластера остаётся без него. Является ли вид ресурсом пространства имён, определяется собственной областью Kubernetes API для вида, который API обслуживает сам, а для пользовательского вида — значением scope, которое для него объявляет CustomResourceDefinition в том же рендеринге, — из шаблонов чарта или из его каталога crds/. Ресурс вида, который не классифицирует ни один из этих источников, остаётся таким, каким его записал чарт, и сборка сообщает о нём один раз для каждого вида, называя вид и его группу API; то же происходит с документом kind: List, элементы которого не размещаются. Если ни одна граница не объявляет пространство имён, ничего не размещается и ни о чём не сообщается: ресурс, который чарт записывает без пространства имён, выводится без него и размещается туда, куда выберет применяющий инструмент.
Сообщение — это предупреждение сборки, которая при этом завершается:
warning: node "store" (provider "helm"): resources of kind "Probe" in API group "monitoring.example.org" write no namespace and are left without one rather than placed in namespace "shop": the kind is not one the Kubernetes API serves itself, and no CustomResourceDefinition in this chart's render gives it a single scope, so whether it is namespaced is not known when the build runs, and they land wherever the tool applying the output places themЕсли у чарта есть значение, которое рендерит CustomResourceDefinition этого вида, или значение, которое само записывает пространство имён, задание его через valuesMapping сущности Recipe размещает такой ресурс.
Версия Kubernetes, для которой рендерится чарт
Шаблоны чарта читают версию Kubernetes, для которой они рендерятся, как .Capabilities.KubeVersion, и многие выбирают по ней версию API, поле или целый механизм — например, проецируемый токен сервисного аккаунта начиная с 1.21 и собственный ниже. У сборки нет кластера, который можно спросить, поэтому версию указываете вы — там, где сущность Release определяет, куда развёртывается компонент: аннотацией aggrega.ai/kubernetes-version на границе или на компоненте, где она имеет приоритет над аннотацией его границы и наследуется каскадно точно так же, как aggrega.ai/namespace.
spec: boundaries: production: annotations: aggrega.ai/kubernetes-version: "1.31" components: api: {} legacy: annotations: aggrega.ai/kubernetes-version: "1.28" # this component deploys to an older clusterЗначение читается так же, как helm template --kube-version читает свой флаг, поэтому принимаются те же формы, что принимает этот флаг, и чарт получает ровно то, что дал бы ему этот флаг: "1.31" читается как v1.31, "v1.31.2" — как v1.31.2, а текст после чисел остаётся в .Capabilities.KubeVersion.Version как написан — "1.29.3-gke.100" читается как v1.29.3-gke.100, — тогда как .Capabilities.KubeVersion, выведенная целиком, читает версию без него. Чарт, сравнивающий .Capabilities.KubeVersion.Version с помощью semverCompare, воспринимает такой суффикс как пре-релиз, поэтому ограничение без нижней границы -0, например ">=1.21", с ним не совпадает, а значение с окружающими пробелами читается вместе с этими пробелами — " 1.30 " читается как "v 1.30 " — и такое сравнение не проходит вовсе: указывайте голую версию там, где чарт её сравнивает. Значение, не являющееся версией, — "one.two", "latest", одиночное число — останавливает сборку по условию для значения, которое плагин не может представить, с указанием значения, компонента и его границы; чарт никогда не рендерится вместо этого для какой-либо другой версии. См. A Kubernetes version the helm provider cannot render a chart for (Версия Kubernetes, для которой провайдер helm не может отрендерить чарт). Пустое значение считается незаданным.
Если ни одна аннотация не указывает версию, чарт рендерится для той версии, для которой рендерит стандартный helm template того же релиза helm, то есть для версии клиентской библиотеки Kubernetes, с которой собран провайдер: провайдер, собранный с клиентской библиотекой v0.37, рендерит для Kubernetes v1.37.0. Таким образом, в Aggrega чарт рендерится так же, как его рендерит helm template у его собственных авторов, а значение по умолчанию меняется, только когда меняется клиентская библиотека, с которой собран провайдер. Указывайте версию кластера, в который вы развёртываете, всякий раз, когда она отличается: чарт, отрендеренный для более новой версии, чем работает в кластере, может выдать версию API, которую этот кластер не обслуживает.
Так задаётся только версия. Все остальные возможности, которые читает чарт, — .Capabilities.APIVersions и .Capabilities.HelmVersion — встроенные в библиотеку helm, поэтому API, который кластер обслуживает благодаря установленному CustomResourceDefinition, чарту не сообщается. Собственный диапазон kubeVersion чарта в его Chart.yaml с версией не сравнивается: helm template отклоняет чарт, диапазон которого исключает версию, для которой он рендерит, а сборка его рендерит. Аннотация влияет только на чарт, отрендеренный из источника, и ни на что другое: синтезированный Workload и тело artifacts: не читают .Capabilities, а провайдер helm-chart передаёт свой чарт дальше неотрендеренным, чтобы тот был отрендерен при установке.
Исключение отрендеренных документов. Этот провайдер учитывает записи omits:, которые объявляет Recipe или FeatureRecipe, в этом режиме и ни в каком другом: синтезированный Workload и тело artifacts: рендерятся без их учёта. Каждый документ, который рендерит чарт, — из шаблона или из файла его каталога crds/ — сопоставляется с каждой записью, применимой к сборке, и документ, названный любой записью, исключается. Запись называет документ словами, которые несёт сам документ, теми же, из которых строятся его имя выходного файла и его факты рендеринга: его kind, его metadata.name и, только если запись его называет, пространство имён, в котором находится документ, — то, которое пишет его шаблон, или объявленное пространство имён границы, если этот провайдер помещает документ туда, как описано выше. Это никогда не пространство имён, относительно которого чарт лишь рендерится: если пространство имён не объявлено, чарт рендерится относительно default, однако документ, шаблон которого не пишет пространство имён, не находится ни в каком, поэтому запись с default с ним не совпадает. Документ без kind или без имени не совпадает ни с одной записью. Исключённые документы рендерятся и затем отбрасываются, когда имена всех файлов уже определены, поэтому каждый сохранённый документ получает имя и записывается точно так же, как без этих записей, а исключённый документ не попадает ни во что, что сборка делает дальше: ни в файл, ни в сравнение имён, которое отклоняет двух участников, претендующих на одно имя, ни в факт рендеринга, который читает Feature, ни во что, что передаётся шагу конвейера. Провайдер сообщает, сколько документов совпало с каждой записью, а запись, не совпавшая ни с одним, останавливает сборку; см. An omits entry left out nothing the source rendered (Запись omits не исключила ничего из отрендеренного источником).
Релиз Helm, под которым рендерится чарт
Провайдер рендерит с помощью Helm 4 SDK версии v4.3, поэтому чарт получает то же, что дал бы ему собственный helm template из Helm 4, а одни и те же чарт и значения дают одни и те же байты при каждой сборке. Чарт, написанный и проверенный под Helm 3, может столкнуться со следующими особенностями поведения Helm 4:
.Capabilities.HelmVersionсообщает версию Helm 4,v4.3.- Версия Kubernetes по умолчанию — v1.37.0, поскольку Helm 4 версии v4.3 собран с клиентской библиотекой v0.37, а
.Capabilities.APIVersions— это набор версий API этой клиентской библиотеки. Укажите версию, на которой работает ваш кластер, как описано в разделе Версия Kubernetes, для которой рендерится чарт. - Значение
nullпо умолчанию в чарте отбрасывается. Ключ, которомуvalues.yamlчарта присваиваетnull— на верхнем уровне или внутри таблицы, — отсутствует в.Values, если его не задают значения, передаваемые сущностью Recipe, поэтомуhasKeyсообщает, что его нет,toYamlего опускает, аvalues.schema.jsonчарта проверяется по значениям без него. - Блочный скаляр сохраняет завершающий перевод строки перед
---. Документ, который заканчивается блочным скаляром и за которым следует другой документ из того же шаблона, сохраняет последний перевод строки этого скаляра, поэтому он записывается как|, а не|-. .Chart— это словарь с ключами по именам полей..Chart.Name,.Chart.Version,.Chart.AppVersionи остальные поля читаются как прежде, ноtoYaml .ChartилиtoJson .Chart.Maintainersвыводят ключи какName,AppVersionи так далее, включая пустые поля, а поле, которого нет в метаданных чарта, читается как пустое, а не приводит к сбою рендеринга..Capabilities.KubeVersion.Versionсохраняет текст версии в том виде, в каком он записан, как описано выше для аннотацииaggrega.ai/kubernetes-version.- Файл
values.yaml, содержащий несколько документов YAML, читается целиком: более поздние документы объединяются поверх более ранних. .Files.Linesдля пустого файла возвращает ноль строк, а не приводит к сбою рендеринга.- Функции шаблонов, добавленные в Helm 4, —
mustToYaml,mustToJson,mustToToml,mustToDurationи преобразованияduration…— доступны шаблонам чарта. - Зависимость с двумя псевдонимами даёт каждому псевдониму собственную копию зависимостей этой зависимости.
- Проверка по схеме значений принимает или отклоняет значения иначе только в пограничных случаях: локальная часть адреса электронной почты в кавычках,
NaNи бесконечные числа, сравнение числа с нечислом вenumиconst, а также место, сообщаемое для не прошедших проверкуpropertyNames,contentSchemaили последующего элемента массива.
Шаблон, который не удаётся выполнить самому движку — например, при чтении значения через отсутствующую таблицу, — сообщается в форме Helm 4: файл, строка и столбец шаблона на отдельной строке, затем то, что выполнялось, и сообщение с отступом — для каждого шаблона, через который прошёл сбой. Собственные fail или required чарта сохраняют однострочную форму execution error at (<file>:<line>:<col>): <message>, как и ошибка, возвращаемая функцией шаблона.
Как выводится имя релиза
Чарт в режиме источника рендерится с именем релиза, которое попадает в каждый шаблон как .Release.Name. Чарты обычно называют по нему ресурсы, поэтому имя релиза — это идентичность внутри кластера, а не метка сборки.
Имя релиза — это закодированная форма той же основы, которой предваряется имя выходного файла отрендеренного ресурса, так что это одно имя, записанное дважды. Эта основа — instance_id для обычного компонента и составная идентичность, которую несёт сущность Feature, прикреплённая к границе. Для чарта, предоставленного автором прикрепления сущности Feature, это имя компонента-хоста: собственные шаблоны чарта рендерятся с именем релиза, поэтому вывод его из прикрепления переименовал бы ресурсы, объявленные чартом, в кластере, где они уже развёрнуты. Эти ресурсы по-прежнему несут собственную идентичность прикрепления в метке aggrega.ai/component-id: как называется ресурс и чему он принадлежит — здесь отдельные вопросы, и только для обычного компонента ответ на них совпадает. Имя релиза Helm допускает более узкий набор символов, чем идентичность: строчные буквы, цифры, дефисы и точки, начинаться и заканчиваться оно должно строчной буквой или цифрой, длина — до 53 символов. Вместо того чтобы заменять символ, который цель не принимает, вывод записывает его явно, поэтому две идентичности компонентов, различающиеся только пунктуацией или регистром, всегда дают два разных имени релиза.
- Строчная буква и цифра переносятся в точности как описаны.
- Дефис сохраняется как описан везде, где следующий за ним символ переносится напрямую и не является строчной
z. Дефис, за которым следует строчнаяz, открывает экранирование, поэтому описанный дефис в такой позиции сам записывается явно:api-zoneстановитсяapi-zhzone, и именно это позволяет разобрать любое имя обратно без догадок. Дефис, за которым ничего нет, записывается явно по той же причине, поэтомуdb-даётdb-zh. - Любой другой символ записывается как
-z, за которым следует буква, обозначающая его:dдля точки,uдля подчёркивания,sдля разделителя пути,hдля дефиса, который правило выше не сохраняет. Всё остальное, включая заглавную букву, записывается какxи шестизначная шестнадцатеричная кодовая точка символа, а байт, с которого не начинается ни один символ, — какbи его собственное двузначное значение. - Пустое значение записывается как
-ze, чего не может дать ни одно непустое значение.
Точка записывается явно, а не переносится, хотя Helm допускает её в имени релиза, потому что Helm требует строчную букву или цифру с каждой стороны точки, а вывод расставляет собственные дефисы.
Поскольку две сущности Features, прикреплённые к одному компоненту, рендерятся с именем релиза этого компонента, два чарта, каждый из которых называет ресурс по .Release.Name, порождают два ресурса с одним именем. Этот провайдер сообщает имя, которое несёт каждый ресурс, создаваемый его собственным рендерингом, в пределах вида этого ресурса и, для вида, который кластер хранит в пространстве имён, — в пределах его пространства имён, и сборка отклоняет два источника, попадающие на одно такое имя, вместо того чтобы выдать вывод, при применении которого остался бы только последний, — см. ../errors/fatal-halts.md «The same name is derived more than once inside the output (Одно и то же имя выводится внутри вывода более одного раза)». Вид, который кластер хранит вне всех пространств имён, — ClusterRole, CustomResourceDefinition или пользовательский вид, который CustomResourceDefinition в том же рендеринге объявляет с областью Cluster, — ограничивается только своим видом и классифицируется в точности так, как его классифицирует размещение по пространствам имён выше, поэтому два компонента одного вывода, каждый из которых записывает такой объект под одним именем, отклоняются, даже если сущность Release размещает их в разных пространствах имён. Исправление — составить имя, и какая координата для этого нужна, зависит от схемы. Два прикрепления на одном компоненте уже разделяют хост, поэтому до шаблона должно дойти прикрепление: передайте .attachment_name в чарт через valuesMapping: сущности FeatureRecipe и задайте его тому из собственных значений чарта, из которого строятся имена его ресурсов. Один чарт, прикреплённый к двум компонентам, — обратный случай: имя релиза уже различается для каждого хоста, поэтому ресурс, названный по .Release.Name, на каждом из них получает собственное имя, а литеральное имя — нет. О сущности FeatureRecipe, поставляющей свои ресурсы через artifacts:, сообщается на тех же условиях: этот провайдер читает имя каждого выдаваемого документа независимо от того, пришёл ли документ из шаблона чарта или из тела артефактов, поэтому литеральное имя в таком теле, прикреплённом к двум компонентам, тоже останавливает сборку. Тело артефактов является шаблоном, поэтому составляйте имя из .context.rendered_name — имени релиза хоста, которое различается для каждого хоста и записано символами, допустимыми в имени Kubernetes, — и .attachment_name, где оно должно быть уникальным в пределах хоста; на хосте, который размещает только набор артефактов и не сообщает имени релиза, составляйте его из .context.instance_id. Сообщается не каждое имя, поэтому сборка, которая не остановилась, сравнила не всё, что в итоге будет нести её вывод. Чаще всего при написании чарта вы встретите ресурс, объявляющий generateName: его имя достраивает кластер, поэтому сравнивать пока нечего. На странице по ссылке выше приведён полный набор.
Так, instance_id со значением api даёт имя релиза api, data.main-db даёт data-zdmain-db, а db_host даёт db-zuhost. Идентичность, состоящая только из строчных букв, цифр и дефисов, которые вывод сохраняет, выглядит в точности как описана. Одинаковый ввод всегда даёт одинаковое имя.
Два условия Helm — это свойства основы, а не вывода: имя релиза должно начинаться со строчной буквы или цифры и иметь длину не более 53 символов. Основа, первый символ которой записывается явно, начинает имя с дефиса, которым открывается каждое экранирование, а основа с явно записываемыми символами в закодированном виде длиннее, чем была описана. Сборка спрашивает этот провайдер об обоих условиях и действует по ответу во время сборки, а не оставляет отказ кластеру во время применения, — см. ../errors/fatal-halts.md «The target will not accept a name derived from an authored identity (Цель не примет имя, выведенное из описанной идентичности)». Что она делает с ответом, зависит от того, кто написал основу. Имя, написанное вами, отклоняется, а не изменяется, и в отказе указываются поле, которое вы написали, и доступный вам лимит; имя, составленное Aggrega, сокращается, пока этот провайдер его не примет.
К ресурсам, названным по компоненту, кластер применяет одно правило строже, чем Helm: имя Service должно начинаться с буквы, тогда как имя релиза может начинаться с цифры. Чарт обычно называет свои Services по имени релиза, и Services синтезированной рабочей нагрузки тоже начинаются с него, поэтому этот провайдер также отклоняет имя компонента, начинающееся с цифры, сообщая о нём как о Service name, которое цель не может использовать. Никакая длина не исправит первый символ, поэтому в этом отказе длина не указывается. Поэтому начинайте instance_id со строчной буквы и делайте его достаточно коротким, чтобы закодированная форма по-прежнему умещалась.
Изменение основы, из которой выводится имя релиза, переименовывает ресурсы кластера, которые чарт называет по .Release.Name, и каждый ресурс, который этот провайдер синтезирует для компонента, а Kubernetes не переименовывает ресурс на месте. Инструмент применения создаёт ресурс под новым именем и удаляет ресурс со старым, что для ресурсов с состоянием означает освобождение хранилища, привязанного к старому имени. Относитесь к такому изменению как к замене, которую нужно спланировать — с выводом нагрузки, миграцией или назначением времени, — а не как к обновлению, которое просто выкатывается.
Режим Workload (синтезируемый)
Recipe с workload: (встроенным или загруженным через $import:) синтезирует ресурсы Kubernetes из абстрактного намерения сущности Workload. Схема Workload описана в entities/workload.md; в этом разделе описано, что выдаёт провайдер helm.
Для каждого узла:
- Один объект-контроллер, выбираемый по
formсущности Workload:stateless(и значение по умолчанию) выдаёт Deployment,stateful— StatefulSet,daemon— DaemonSet,task— Job,scheduled— CronJob, у которогоspec.scheduleберётся из поляscheduleсущности Workload (выражение cron из 5 полей или макрос@); workload сscheduledбез расписания или с некорректным расписанием явно останавливает сборку. Workload сscheduled, объявляющийsuspend: true, выдаёт свой CronJob сspec.suspend: true, поэтому по расписанию ни один запуск не начинается, пока он не будет возобновлён, но Job по-прежнему можно создать из CronJob вручную; workload, который этого не объявляет, не выдаёт ключsuspendвовсе. Deployment и StatefulSet несут число реплик; DaemonSet, Job и CronJob его не несут. Для Workload сstatefulтребуется ровно один Servicetype: Headless, объявленный в Workload, чтобы управлять StatefulSet; провайдер связываетserviceNameу StatefulSet с отрисованным именем этого Service, и сборка останавливается, если headless Service не объявлен (или объявлено больше одного). ТомpersistentTemplateсопутствуетform: stateful: его объявление в любой другой форме останавливает сборку с сообщением, указывающим исправление. - Один Service на каждую объявленную запись
services:в Workload, открывающий именованные порты, перечисленные в спецификации сервиса.typeзаписи становится типом Service:ClusterIP,NodePortиLoadBalancerдословно, аHeadless— как ServiceClusterIPсclusterIP: None. ЗаписьLoopbackвместо этого останавливает сборку, называя узел и сервис: у Service в Kubernetes нет типа, привязывающегося к loopback-адресу хоста, а то, на каких адресах узлов слушает ServiceNodePort, — настройка всего кластера, поэтому запись отклоняется, а не отрисовывается с доступностью, которую она не запрашивала. См. A service type the helm provider cannot render (Тип сервиса, который провайдер helm не может отрисовать). - Один PersistentVolumeClaim на каждый том
persistent, с размером и формой по спецификации тома. ТомpersistentTemplateне выдаёт отдельной заявки: он становится записьюvolumeClaimTemplatesвнутри собственной спецификации StatefulSet, поэтому он и сопутствуетform: stateful.
Имена ресурсов. Каждый ресурс, который этот режим выдаёт для компонента, именуется по имени релиза компонента — тому же имени, с которым отрисовывается подключаемый chart, выведенному так, как описано в Как выводится имя релиза, — и провайдер сообщает это имя сборке как {{ .context.rendered_name }}. Объект-контроллер несёт само имя релиза; каждый Service — <release name>-<service key>; каждая отдельная заявка — <release name>-<volume>, и том пода ссылается именно на эту заявку; секрет, доставляемый как файл, монтируется из тома пода с именем <release name>-secret-<slot>, где слот записан в алфавите, который принимает кластер, так же как имя релиза, — поэтому слот server_certificate монтируется из <release name>-secret-server-zucertificate, а у слота, читаемого через соединение, точка после имени соединения записывается так же; serviceName у StatefulSet — имя выдаваемого им headless Service; а Workload, открытый только по внешнему имени, выдаёт один Service с именем релиза. Так, компонент api выдаёт Deployment api и Service default с именем api-default, а компонент my_api выдаёт my-zuapi и my-zuapi-default — имена, которые кластер принимает, тогда как идентификатор в исходном написании принят бы не был. Recipe, публикующий адрес одного из этих Service, строит его из {{ .context.rendered_name }}, как показано в ../templates/rendered-resource-names.md; для компонента, в имени которого нет подчёркивания и заглавных букв, имя релиза совпадает с его instance_id, поэтому его имена читаются в точности как идентификатор. Единственное исключение — workload, синтезируемый прикреплением Feature: он именуется по собственному составному идентификатору прикрепления — значению его метки aggrega.ai/component-id, — потому что прикрепление отрисовывается относительно своего компонента-хоста, и имя релиза, выведенное там, назвало бы workload прикрепления по хосту и столкнулось бы с собственным workload хоста. Этот идентификатор никогда не содержит заглавных букв: заглавная буква в имени хоста или прикрепления записывается как экранирование, как и любой другой символ, который не принимает имя ресурса, поэтому прикрепление worker на компоненте myApi выдаёт Deployment cfr--my-zx000041pi--worker и Service default с именем cfr--my-zx000041pi--worker-default, и каждое имя, которое несёт workload, кластер принимает.
Длины имён, зависящие от Workload. Два из этих имён кластер ограничивает собственными лимитами, и сборка проверяет оба, как только сущность Workload разрешена, вместо того чтобы оставлять отказ кластеру при применении. Имя CronJob — не более 52 символов, короче других имён кластера, потому что контроллер называет Job каждого запуска по имени CronJob с добавленным суффиксом; оно проверяется только для сущности Workload с формой scheduled. Каждое имя Service, <release name>-<service key>, — не более 63 символов. При превышении любого из лимитов результат зависит от того, кто написал имя, точно так же, как для имени релиза: написанное вами имя компонента отклоняется, и сборка останавливается на написанном вами ключе spec.components, указывая вид имени, его длину и бюджет длины, доступный вашему имени, — см. ../errors/fatal-halts.md «The target will not accept a name derived from an authored identity (цель не принимает имя, выведенное из написанной идентичности)»; составная идентичность, например та, по которой назван workload присоединения Feature, сокращается, пока каждое имя не уместится. Имя Service строится из вашего имени компонента и ключа, который объявляет workload — в сущности Recipe или FeatureRecipe, — поэтому отказ называет этот ключ и место, где workload его объявляет, spec.workload.services.<key>; если ключ не оставляет места ни для какого имени компонента, сократить нужно сам ключ. Таким образом, компонент с сущностью Workload формы scheduled может иметь закодированное имя длиной до 52 символов, а компонент web может иметь ключи Service длиной до 59 символов. Сущность Feature, присоединённая ко всей границе, получает свою идентичность до разрешения её сущности Workload, потому что место сборки её вывода может зависеть от этой идентичности, поэтому ни один из лимитов не проверяется для синтезируемых ею ресурсов.
Каждый выдаваемый ресурс несёт полный набор меток и аннотаций происхождения Aggrega, а также пару селекторов (app: <instance_id>), связывающую Deployment/StatefulSet с его Services. Значение метки допускает идентификатор в исходном написании, поэтому селектор сохраняет его, тогда как приведённые выше имена берут имя релиза. Имена контейнеров в отрисованном Deployment — это ключи контейнеров Workload, в которых символы . и _ заменены на - (санитизация имён Kubernetes).
Транспорт порта. Порт контейнера, объявляющий транспорт, выдаёт его дословно как protocol: в отрисованном containerPort, и каждый порт Service, ссылающийся на этот порт контейнера, несёт то же значение: транспорт объявляется один раз, на порту контейнера, поэтому открытие порта не может ему противоречить. Порт, не объявляющий транспорт, не выдаёт ключ protocol ни в одном из ресурсов, оставляя в силе значение кластера по умолчанию. Все три значения, которые допускает Workload (TCP, UDP, SCTP), выдаются дословно; helm не требует деградации, поскольку Kubernetes выражает каждое из них напрямую.
Работа в сети узла. Workload, объявляющий hostNetwork: true, выдаёт hostNetwork: true в отрисованной спецификации пода, поэтому под работает в собственном сетевом пространстве имён узла, а порты, открываемые его контейнерами, доступны по адресам узла. Kubernetes выражает этот выбор напрямую, поэтому ничего не деградирует. Объявление попадает в спецификацию пода и никуда больше: оно не добавляет, не удаляет и не переписывает ни одного порта, а выдаваемые Services одинаковы с ним и без него. Workload, не объявляющий его, вообще не выдаёт ключ hostNetwork.
Количества ресурсов. Каждое количество, которое провайдер копирует в манифесты, выдаётся дословно, и каждое сначала проверяется на соответствие форме количества, описанной в Workload → Количества ресурсов: значения resources.requests и resources.limits каждого контейнера и init-контейнера — cpu, memory и каждый расширенный ресурс, например nvidia.com/gpu, — а также ephemeral.sizeLimit, persistent.size и persistentTemplate.size каждого тома. Проверка выполняется над Workload в том виде, в каком его вычислили шаблоны Recipe, поэтому значение, пришедшее через infra или параметр Release, оценивается по тому, во что оно отрисовалось. Значение вне этой формы останавливает сборку с TRANSLATION_ERROR, называя узел, путь поля в Workload и значение, — например, containers.main.resources.requests.cpu: "lots" is not a quantity: it does not begin with a number (“lots” не является количеством: оно не начинается с числа), — тогда как иначе chart собрался бы без ошибок и был бы отклонён кластером при установке. Пустые cpu, memory или sizeLimit опускаются из манифестов и поэтому не проверяются; пустое значение расширенного ресурса или размера постоянного тома всё равно было бы выдано, поэтому оно отклоняется. Проверка оценивает только форму: может ли кластер запланировать это количество, провайдер во время сборки знать не может.
Имена выходных файлов имеют два вида. Объект-контроллер именуется по имени релиза и своему виду — <release name>-deployment.yaml, <release name>-statefulset.yaml, <release name>-daemonset.yaml, <release name>-job.yaml, <release name>-cronjob.yaml. Файл отдельного ресурса именуется по ресурсу, который он содержит, с видом в конце: <release name>-<svcName>-service.yaml и <release name>-<volName>-pvc.yaml, каждое берётся из собственного metadata.name этого ресурса согласно соглашению о синтезируемых именах в entities/workload.md. Workload, открытый только по внешнему имени, выдаёт <release name>-service.yaml, поскольку ключа сервиса, который можно было бы нести, нет.
Факты рендеринга
Помимо файлов, которые он рендерит, этот провайдер сообщает о каждом узле четыре факта рендеринга: что выпущенные им документы Kubernetes говорят о своих подах, своих селекторах, своих портах и о пространстве имён, в которое выпущен каждый из них. Сущность FeatureRecipe, присоединённая к компоненту, читает собственные факты компонента в .context.render_facts; сущность, которая задаёт readsCallerRenderFacts: true, также читает в каждой записи .context.used_by факты компонента, подключающегося к её хосту, а сущность, которая задаёт readsTargetRenderFacts: true, читает в каждой записи .context.uses факты компонента, к которому подключён её хост. Так сущность Feature может назвать поды компонентов, вызывающих её хост, или компонентов, к которым обращается её хост, — например, сетевая политика, пропускающая ровно их, — исходя из того, что действительно выпустили их рендеринги, и никому не нужно вручную повторять метку. Имена и записи ниже — контракт этого провайдера.
| Факт | Одна запись на каждый | Каждая запись содержит |
|---|---|---|
pod_template_labels | выпущенный шаблон пода: spec.template объекта Deployment, StatefulSet, DaemonSet, ReplicaSet или Job, шаблон задания CronJob, а также отдельный Pod, который является собственным шаблоном | kind, name и namespace ресурса, содержащего шаблон; labels — метки шаблона |
controller_selectors | выпущенный Deployment, StatefulSet, DaemonSet, ReplicaSet, Job и CronJob | kind, name, namespace; match_labels — matchLabels его селектора |
service_selectors | выпущенный Service | name, namespace; selector — метки, на которые он направляет трафик |
container_ports | контейнер шаблона пода, объявляющий список ports, включая init-контейнеры | kind, name и namespace ресурса, содержащего шаблон; container — имя контейнера; ports — по одной записи на порт с его name, container_port и protocol |
Как читаются факты:
- Каждый факт — список. Шаблон всегда перебирает факт, даже если в нём одна запись; отдельного единичного значения для чтения нет.
- Все четыре — при каждом рендеринге. Каждый факт сообщается всякий раз, когда этот провайдер рендерит узел, — пустым списком, если рендеринг не выпустил ничего, что он описывает: компонент, чарт которого выпускает только ConfigMap, сообщает четыре пустых списка. Рендеринг другого провайдера не сообщает ни одного из этих имён, а имя, о котором никто не сообщил, читается как пустое значение.
- Читаются из выпущенного, на любом пути. Факты берутся из документов, выпущенных рендерингом, независимо от того, какой режим их создал: из отрендеренных манифестов чарта, из манифестов синтезированной сущности Workload и из манифестов, размещённых автором через
artifacts:, которые сообщают ровно то, что содержат эти манифесты. Они читаются в том же проходе и по тем же документам, что и имена ресурсов, которые этот провайдер сообщает для проверки сборки на повторяющиеся имена. Собственные метки происхождения ресурса входят в то, что он содержит, поэтомуlabelsотдельного Pod включают их; шаблон пода чарта или артефакта сохраняет метки, написанные его автором. - Записи могут поступать из собственного рендеринга компонента и из рендерингов его сущностей Features. Один компонент может рендериться несколькими вызовами — например, чартом и размещением
artifacts:, — и списки, которые одно имя получает из этих вызовов, объединяются в один в порядке выполнения вызовов. В.context.used_byи.context.usesк фактам компонента на другом конце подключения после его собственных также добавляется то, что отрендерили присоединённые к нему сущности Features;.context.render_factsсодержит только собственный рендеринг компонента. - В порядке выпуска. Записи следуют порядку, в котором рендеринг выпустил ресурсы. Карта меток — это карта с ключами, как и любая другая в контексте, поэтому шаблон, перебирающий её, получает ключи в порядке ключей.
- Чего нет в документе, того нет и в записи. У ресурса, названного через
generateName, нетname; у ресурса, не задающегоmetadata.namespace, нетnamespace, как нет его и у ресурса, задающего это поле пустым или null, поскольку такое значение тоже не называет пространство имён; у контроллера, написанного безmatchLabels, — например, Job, полагающегося на селектор, генерируемый кластером, — нетmatch_labels; у Service без селектора нетselector; у порта без имени или протокола нет ни того, ни другого. Любая другая часть, заданная пустой, сообщается пустой.protocolсообщается, только если документ его задаёт, поэтому шаблон, которому он нужен, сам подставляет значение кластера по умолчанию,TCP.container_port— число везде, где документ его задаёт. namespace— тот, что задаёт документ, а не догадка. Это собственноеmetadata.namespaceресурса — для шаблона пода это пространство имён ресурса, который его содержит, то есть там, где работают его поды; пространство имён, заданное внутри самого шаблона пода, не читается. Синтезированная сущность Workload задаёт пространство имён, объявленное её границей, на каждом выпускаемом ресурсе, поэтому её записи содержат это пространство имён. Записи чарта содержат то, что задают его выпущенные документы: если граница объявляет пространство имён — это пространство имён (проецируют ли его шаблоны чарта или провайдер помещает в него ресурс, см. Режим с источником), если только шаблон не закрепляет собственное, которое тогда и содержит запись; если ничего не объявлено — пространство имён релиза,default, там, где шаблоны его проецируют, и ничего там, где они его не задают. Если ничего не задано, запись не содержитnamespace, а не значение по умолчанию границы или кластера, потому что такой ресурс окажется там, куда его поместит инструмент, применяющий вывод, а это неизвестно во время сборки. Шаблон различает эти случаи с помощьюoptional:{{ optional . "namespace" "" }}пусто ровно там, где документ ничего не задал, поэтому сущность Feature, размещающая что-то рядом с подами компонента, может отличить компонент, пространство имён подов которого известно, от компонента, у которого оно неизвестно.- Распознаются по виду и группе API.
PodиServiceчитаются в группе core, четыре контроллера — вapps,JobиCronJob— вbatch, в любой версии группы. Пользовательский ресурс другой группы, у которого случайно одно из этих имён вида, не читается как таковой.matchExpressionsселектора не сообщаются, как и ресурс, обёрнутый в документkind: List, или значение, заданное через ключ слияния YAML.
Чего факты не видят. Они описывают документы, которые выпускает сборка, и ничего из того, что кластер создаёт позже. Поды, которые контроллер создаёт во время выполнения из пользовательского ресурса — например, кластер базы данных оператора, — не появляются ни в одном выпущенном документе, поэтому по построению отсутствуют; как и любая метка, которую изменяющий admission-контроллер добавляет при применении манифестов. Сущность Feature, которой нужно пропустить такие поды, берёт их метки из документации самого пользовательского ресурса, как сделал бы автор без этих фактов.
Сущность FeatureRecipe, пропускающая к подам своего хоста ровно поды вызывающих его компонентов и выбирающая собственные поды хоста по селектору его контроллера:
apiVersion: aggrega.ai/v1beta1kind: FeatureRecipemetadata: name: admit-callers version: 1.0.0spec: capability: helm implements: example/admit-callers:1.0.0 readsCallerRenderFacts: true artifacts: allow-callers.yaml: | apiVersion: networking.k8s.io/v1 kind: NetworkPolicy metadata: name: {{ .context.rendered_name }}-allow-callers spec: podSelector: matchLabels: {{- range .context.render_facts.controller_selectors }} {{- range $k, $v := .match_labels }} {{ $k }}: {{ toJson $v }} {{- end }} {{- end }} policyTypes: - Ingress ingress: - from: {{- range .context.used_by }} {{- range .render_facts.pod_template_labels }} - podSelector: matchLabels: {{- range $k, $v := .labels }} {{ $k }}: {{ toJson $v }} {{- end }} {{- end }} {{- end }}Для хоста api, вызываемого компонентом web, сущность Workload которого синтезировал этот провайдер, политика выбирает app: "api" и пропускает podSelector, содержащий все метки шаблона пода web, — те же метки, что содержит spec.template.metadata.labels его выпущенного Deployment. Поскольку FeatureRecipe задаёт этот ключ, её присоединение рендерится после рендеринга всех компонентов, поэтому факты доступны, какой бы из api и web сборка ни достигла первым; без ключа шаблон, читающий render_facts в .context.used_by, останавливает сборку до начала рендеринга.
podSelector в from политики сопоставляет поды в собственном пространстве имён политики, поэтому приведённая политика пропускает вызывающие компоненты, выпущенные в пространство имён, в котором она применена. Вызывающий компонент, записи которого содержат другой namespace, пропускается путём сочетания его podSelector с namespaceSelector по метке kubernetes.io/metadata.name этого пространства имён, которую Kubernetes устанавливает на каждом пространстве имён.
Особенности, специфичные для Provider
-
Загрузка чартов использует только встроенные обработчики Helm. Чарт, получаемый из репозитория Helm, загружается собственными встроенными обработчиками Helm
httpиhttps. К плагину-загрузчику Helm — установленному для командыhelmили лежащему в каталоге, из которого запускается сборка, — обращения никогда не происходит, поэтому содержимое этого каталога не может изменить способ получения чарта. -
Внедрение меток происхождения. Пути sourced и synthesized приводят к одному и тому же набору меток и аннотаций; при рендеринге в режиме sourced они внедряются путём переписывания YAML после рендеринга (когда Helm SDK уже выполнил рендеринг), поэтому авторам чартов не нужно протягивать метки Aggrega через свои шаблоны.
-
Порядок переменных окружения — сначала записи, читаемые из Secret. Список
envсинтезированного контейнера содержит записи двух видов: каждая записьattachments, доставляемаяas: env, читает своё значение из Secret черезvalueFrom.secretKeyRef, а каждая записьvariablesсодержит простое значениеvalue. Провайдер записывает сначала все записи, читаемые из Secret, а после них — все простые переменные, каждый вид в порядке, в котором он задан автором, а источникиenvFromперечисляет отдельно вenvFrom. Kubernetes раскрывает ссылку$(NAME)в значенииenvпо записям, перечисленным перед ней в том же контейнере, и никогда — по записи, перечисленной после неё, поэтому такой порядок позволяет простой переменной составить значение по ссылке на значение из Secret, тогда как сам секрет остаётся в Secret:containers:api:image: "api:1.0"variables:DATABASE_URL: "postgres://app:$(DB_PASSWORD)@db:5432/app"attachments:DB_PASSWORD: { from: db-credentials, as: env }В отрендеренном контейнере
DB_PASSWORDперечислена передDATABASE_URL, поэтому процесс получает URL с уже подставленным паролем. Переменная также может ссылаться на любую переменную, заданную перед ней, благодаря чему порядок, заданный автором, сохраняет смысл внутриvariables. Init-контейнеры следуют тому же порядку. Контейнер, который задаёт одно имя и как записьvariables, и как записьattachments, доставляемуюas: env, останавливает сборку, а не записывает обе записи, поскольку иначе лишь этот порядок решал бы, какое значение увидит процесс (см. A container gives one environment variable two values (Контейнер задаёт одной переменной окружения два значения)). -
Каскад пространства имён — два режима доходят до ресурса по-разному. Оба читают
aggrega.ai/namespaceиз каскада аннотаций границ, и ни один не придумывает пространство имён, если ни одна граница его не объявляет. В режиме synthesized провайдер записываетmetadata.namespaceнапрямую и полностью опускает поле, если каскад не даёт значения. В режиме sourced провайдер передаёт значение как пространство имён релиза чарта —default, если каскад ничего не даёт, — и собственный шаблон чарта решает, проецировать ли его; если пространство имён объявлено, провайдер затем записывает его в каждый ресурс с пространством имён, который чарт отрендерил без него (см. Sourced mode). Таким образом, при объявленном пространстве имён оба режима помещают в него каждый ресурс с пространством имён — за исключением пространства имён, которое чарт закрепляет сам, и вида ресурса, который провайдер не может классифицировать. Если пространство имён не объявлено, режимы расходятся: чарт, проецирующий пространство имён релиза, помещает свои ресурсы вdefault, тогда как синтезированный вывод не записывает никакого, а чарт, не записывающий пространство имён, не помещает их ни в какое, так что они оказываются там, куда их поместит инструмент, применяющий манифесты. Локальные чарты, которые несут FeatureRecipes стандартной библиотеки, вместо этого читают значение каскада напрямую через свойvaluesMapping: это позволяет им опускать поле, когда ни одна граница не объявляет пространство имён, в соответствии с синтезированным выводом, чего одно лишь пространство имён релиза выразить не может, поскольку оно никогда не бывает пустым.
Разобранные примеры
Режим sourced — Recipe, указывающий на вендорный чарт:
apiVersion: aggrega.ai/v1beta1kind: Recipemetadata: name: api-server-helm version: 1.0.0spec: capability: helm implements: core/api-server source: ./vendor/charts/api-server valuesMapping: | image: "{{ .values.image }}" replicaCount: {{ optional .infra `replicas` 2 }} service: type: ClusterIP port: {{ .values.port }} env: LOG_LEVEL: "{{ optional .values `log_level` "info" }}"Режим Workload — Recipe, объявляющий встроенный Workload:
apiVersion: aggrega.ai/v1beta1kind: Recipemetadata: name: api-server-workload version: 1.0.0spec: capability: helm implements: core/api-server workload: | apiVersion: aggrega.ai/v1beta1 kind: Workload replicas: {{ optional .infra `replicas` 2 }} containers: api: image: "{{ .values.image }}" ports: web: {{ .values.port }} services: svc: type: ClusterIP ports: web: {{ .values.port }}Перекрёстные ссылки
entities/recipe.md— средства написания сущности Recipe и три вида входных данных.entities/workload.md— схема сущности Workload для синтезированного режима.providers/helm-chart.md— родственный провайдер, который генерирует каркас Helm-чарта, а не плоские манифесты.providers/well-known-annotations.md— общеизвестные аннотации, которые применяет провайдер helm (aggrega.ai/namespaceи др.).architecture/16-recipe-input-composition.md— матрица возможностей Provider (Provider Capability Matrix) для всех провайдеров.10-status.md#providers— текущая классификация готовности.