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

Helm Provider

Провайдер helm створює пласкі відрендерені Kubernetes YAML для споживачів 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 завантажує чарт, словник значень базового рендерингу об’єднується зі значеннями чарту за замовчуванням, і шаблони чарту рендеряться у плаский Kubernetes YAML.
  • Режим 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 автора, як описано в Which files ship with an entity, — тоді як файл поруч із 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.*.

Локальне вендорування чарту підтримується як альтернатива завантаженню й не є обов’язковим. Схема приймає відкритий структурований об’єкт.

Чарт за шляхом джерела має містити коректний Chart.yaml. Рендеринги в режимі з джерелом, яким не вдається завантажити чарт, показують помилку Helm SDK, що лежить в основі, дослівно. Порожнє source: "" не стосується helm: воно не задає ні режиму без джерела, ні режиму з джерелом, тому відмова, яку воно спричиняє, однакова, хоч би на який провайдер була спрямована Recipe, і вона настає під час читання сутності Recipe, до завантаження будь-якого чарта та до виклику цього провайдера. Які команди про неї повідомляють, описано в entities/recipe.md, розділ «Перелік схем поля джерела», та в errors/fatal-halts.md, розділ «Recipe source: is an empty string (поле джерела Recipe є порожнім рядком)».

Режим із джерелом

Recipe із source: <chart-path> і valuesMapping: під час базового рендерингу виконує такий конвеєр:

  1. Чарт за шляхом <chart-path> завантажується через Helm Go SDK.
  2. Шаблон valuesMapping обчислюється в контексті шаблонів сутності Recipe. Його вивід YAML розглядається як накладка значень для чарта.
  3. Накладка поєднується зі стандартними значеннями values.yaml чарта один раз; у разі збігу ключів перемагають ключі накладки (стандартна семантика Helm helm install --values). Ключ, який накладка встановлює в null, вилучає стандартне значення чарта для нього — на верхньому рівні, усередині таблиці чи в значеннях залежності, — як це робить helm install --values, тож шаблони чарта бачать ключ як відсутній; null для ключа, якому чарт не задає стандартного значення, доходить до шаблонів як null.
  4. Helm SDK рендерить шаблони чарта з об’єднаними значеннями.
  5. Aggrega вставляє свої метадані походження у відрендерені маніфести шляхом переписування YAML після рендерингу, щоб вивід із джерела мав ті самі мітки, що й вивід у режимі робочого навантаження. Значення ідентичності стають мітками (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 «Мітки походження, які видають провайдери».
  6. Вихідні файли потрапляють пласко до вихідного каталогу сутності Recipe, по одному на кожен відрендерений ресурс, з назвою <name-basis>-<kind>[-<namespace>]-<name>.yaml — та сама основа, від якої походить назва релізу нижче, а за нею власні тип ресурсу, простір імен, якщо він є, та ім’я, кожне в нижньому регістрі, де кожну послідовність інших символів зведено до одного дефіса. Для звичайного компонента ця основа — власна ідентичність компонента, яку також несе мітка aggrega.ai/component-id ресурсу; для чарта, наданого автором приєднання сутності Feature, основа лишається від компонента-хоста, тоді як мітка несе власну ідентичність приєднання. Документ без типу або без імені натомість називається за шляхом свого шаблону. Структура каталогів чарта сплощується: у відрендереному виводі немає підкаталогу templates/, і два шаблони в різних підкаталогах з однаковою назвою файлу лишаються двома файлами, бо назва береться з ресурсу, а не з шаблону. Файл, який називає блок artifacts: сутності Recipe, сюди не потрапляє: він лежить на рівень нижче, у каталозі, названому за компонентом, що його оголосив, бо такий файл називається за ключем, який написав його автор, а не за ресурсом, який він несе, — тож без цього каталогу два компоненти, прив’язані до однієї Recipe, записали б один шлях, і жоден автор не зміг би їх розділити.

Простір імен, для якого рендериться чарт, зчитується з анотації aggrega.ai/namespace, що каскадно успадковується від межі, і доходить до чарта як простір імен його релізу; коли жодна межа його не оголошує, чарт рендериться для default. Якщо межа його оголошує, кожен ресурс у просторі імен, який чарт рендерить без простору імен — без 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… — доступні шаблонам чарту.
  • Залежність із двома псевдонімами дає кожному псевдоніму власну копію залежностей цієї залежності.
  • Валідація схеми значень приймає або відхиляє по-іншому лише в граничних випадках: локальна частина email у лапках, NaN і нескінченні числа, порівняння числа з нечислом в enum і const, а також місце, що повідомляється для хибного propertyNames, contentSchema чи пізнішого елемента масиву.

Шаблон, який сам рушій не може виконати — скажімо, значення, прочитане через відсутню таблицю, — повідомляється у формі Helm 4: файл, рядок і стовпець шаблону в окремому рядку, а потім, з відступом, те, що виконувалося, і повідомлення — для кожного шаблону, через який пройшов збій. Власні fail чи required чарту зберігають однорядкову форму execution error at (<file>:<line>:<col>): <message>, як і помилка, яку повертає функція шаблону.

Як виводиться назва релізу

Chart у режимі джерела рендериться з назвою релізу, яка доходить до кожного шаблону як .Release.Name. Charts зазвичай називають ресурси за нею, тож назва релізу — це ідентичність усередині кластера, а не мітка збірки.

Назва релізу — це закодована форма тієї самої основи, якою починається назва вихідного файлу відрендереного ресурсу, тож це одна назва, записана двічі. Для звичайного компонента ця основа — instance_id, а для Feature, приєднаної до межі, — складена ідентичність, яку вона несе. Для chart, наданого автором приєднання Feature, це назва компонента-хоста: власні шаблони chart рендеряться з назвою релізу, тож виведення її з приєднання перейменувало б ресурси, які оголошує chart, у кластері, де вони вже розгорнуті. Ці ресурси все одно несуть власну ідентичність приєднання у своїй мітці 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, приєднані до одного компонента, обидві рендеряться з назвою релізу цього компонента, два charts, кожен з яких називає ресурс за .Release.Name, створюють два ресурси з однією назвою. Цей провайдер повідомляє назву, яку несе кожен ресурс, створений його власним рендерингом, в межах типу цього ресурсу і, для типу, який кластер тримає в просторі імен, — у межах його простору імен, і збірка відхиляє двох учасників, що потрапляють на одну з них, замість того щоб видати результат, де після застосування обох залишиться лише останній, — див. ../errors/fatal-halts.md «The same name is derived more than once inside the output (Одна й та сама назва виводиться більше одного разу в межах результату)». Тип, який кластер тримає поза всіма просторами імен, — ClusterRole, CustomResourceDefinition або власний тип, який CustomResourceDefinition у тому самому рендерингу оголошує з областю Cluster, — обмежується лише своїм типом і класифікується точно так, як його класифікує розміщення в просторах імен вище, тож два компоненти одного результату, кожен з яких записує один такий об’єкт під однією назвою, відхиляються навіть там, де Release розміщує їх у різних просторах імен. Виправлення — скласти назву, і яка координата для цього потрібна, залежить від розташування. Два приєднання до одного компонента вже мають спільний хост, тож до шаблону має дійти саме приєднання: передайте .attachment_name у chart через valuesMapping: сутності FeatureRecipe і встановіть його в тому з власних значень chart, з якого будуються назви його ресурсів. Один chart, приєднаний до двох компонентів, — протилежний випадок: назва релізу вже відрізняється для кожного хоста, тож ресурс, названий за .Release.Name, має власну назву на кожному з них, а буквальна назва — ні. Про FeatureRecipe, що доставляє свої ресурси через artifacts:, повідомляється на тих самих умовах: цей провайдер читає назву, яку несе кожен виданий документ, незалежно від того, чи походить документ із шаблону chart, чи з тіла artifacts, тож буквальна назва в такому тілі, приєднаному до двох компонентів, теж зупиняє збірку. Тіло artifacts — це шаблон, тож складайте назву з .context.rendered_name — назви релізу хоста, яка відрізняється для кожного хоста й записана символами, дозволеними в назві Kubernetes, — і .attachment_name, де вона має бути унікальною в межах хоста; на хості, який розміщує лише набір артефактів і не повідомляє назви релізу, складайте її натомість з .context.instance_id. Повідомляється не кожна назва, тож збірка, яка не зупинилася, не порівняла всього, що зрештою нестиме її результат. Найімовірніше, під час написання chart ви зустрінете ресурс, що оголошує 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 має починатися з літери, тоді як назва релізу може починатися з цифри. Chart зазвичай називає свої Services за назвою релізу, і Services синтезованого workload теж починаються з неї, тож цей провайдер також відхиляє назву компонента, що починається з цифри, повідомляючи про неї як про Service name, яку ціль не може використати. Жодна довжина не виправить перший символ, тож ця відмова довжини не вказує. Отже, починайте instance_id з малої літери й робіть його достатньо коротким, щоб закодована форма все ще вміщалася.

Зміна основи, з якої виводиться назва релізу, перейменовує ресурси кластера, які chart називає за .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 потребує рівно одного Service type: Headless, оголошеного в Workload, для керування StatefulSet; провайдер пов’язує serviceName StatefulSet з відрендереною назвою цього Service, і збірка зупиняється, якщо headless Service не оголошено (або якщо їх більше одного). Том persistentTemplate є супутником form: stateful: його оголошення для будь-якої іншої форми зупиняє збірку з повідомленням, що називає виправлення.
  • Один Service на кожен оголошений запис services: у Workload, що відкриває іменовані порти, перелічені в специфікації сервісу. Поле type запису стає типом Service: ClusterIP, NodePort і LoadBalancer дослівно, а Headless — як Service ClusterIP з clusterIP: None. Запис Loopback натомість зупиняє збірку, називаючи вузол і сервіс: Service у Kubernetes не має типу, що прив’язується до loopback-адреси хоста, а те, на яких адресах вузлів слухає Service NodePort, є налаштуванням усього кластера, тож запис відхиляється, а не рендериться з досяжністю, якої він не просив. Див. A service type the helm provider cannot render (Тип сервісу, який провайдер helm не може відрендерити).
  • Один PersistentVolumeClaim на кожен том persistent, розмір і форма якого визначаються специфікацією тому. Том persistentTemplate не генерує окремого claim: він стає записом volumeClaimTemplates у власній специфікації StatefulSet, тому він і є супутником form: stateful.

Назви ресурсів. Кожен ресурс, який цей режим генерує для компонента, названо за назвою релізу компонента — тією самою назвою, з якою рендериться chart у режимі джерела, виведеною так, як описано в розділі Як виводиться назва релізу, — і провайдер повідомляє цю назву збірці як {{ .context.rendered_name }}. Об’єкт-контролер має саму назву релізу; кожен Service — <release name>-<service key>; кожен окремий claim — <release name>-<volume>, і том pod посилається саме на цей claim; секрет, доставлений як файл, монтується з тому pod з назвою <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 з його Service. Значення мітки допускає ідентичність у записаному вигляді, тож селектор зберігає її, тоді як назви вище беруть назву релізу. Назви контейнерів у відрендереному Deployment — це ключі контейнерів сутності Workload, у яких символи . і _ замінено на - (санітизація назв Kubernetes).

Транспорт портів. Порт контейнера, що оголошує транспорт, генерує його дослівно як protocol: у відрендереному containerPort, і кожен порт Service, що називає цей порт контейнера, несе те саме значення: транспорт оголошується один раз, на порту контейнера, тож відкриття не може йому суперечити. Порт без оголошеного транспорту не генерує ключа protocol у жодному з ресурсів, залишаючи в силі типове значення кластера. Усі три значення, які допускає Workload (TCP, UDP, SCTP), генеруються дослівно; helm не потребує деградації, бо Kubernetes виражає кожне з них безпосередньо.

Запуск у мережі вузла. Workload, що оголошує hostNetwork: true, генерує hostNetwork: true у відрендереній специфікації pod, тож pod працює у власному мережевому просторі імен вузла, а порти, які відкривають його контейнери, досяжні на адресах вузла. Kubernetes виражає цей вибір безпосередньо, тож нічого не деградує. Оголошення потрапляє лише в специфікацію pod: воно не додає, не видаляє й не переписує жодного порту, а згенеровані Service однакові з ним і без нього. 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, — там, де інакше 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 і CronJobkind, name, namespace; match_labels — matchLabels його селектора
service_selectorsвиведений Servicename, 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, що розміщує щось поруч із подами компонента, може відрізнити компонент, простір імен подів якого відомий, від того, чий невідомий.
  • Розпізнаються за kind і групою API. Pod і Service читаються в основній групі, чотири контролери — в apps, Job і CronJob — у batch, за будь-якої версії групи. Користувацький ресурс іншої групи, який випадково має одну з цих назв kind, не читається як такий. matchExpressions селектора не повідомляються, як і ресурс, загорнутий у документ kind: List, чи значення, записане через ключ злиття YAML.

Чого факти не бачать. Вони описують документи, які виводить збірка, і нічого з того, що кластер створює пізніше. Поди, які контролер створює під час виконання з користувацького ресурсу — скажімо, кластер бази даних оператора, — не з’являються в жодному виведеному документі, тож їх немає за самою побудовою; так само й будь-якої мітки, яку додає мутаційний контролер допуску під час застосування маніфестів. Сутність Feature, яка має допустити такі поди, бере їхні мітки з власної документації користувацького ресурсу, як зробив би автор без цих фактів.

Сутність FeatureRecipe, що допускає до подів свого хоста саме поди компонентів, які його викликають, і вибирає власні поди хоста за селектором контролера хоста:

apiVersion: aggrega.ai/v1beta1
kind: FeatureRecipe
metadata:
name: admit-callers
version: 1.0.0
spec:
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). Отже, коли простір імен оголошено, обидва режими розміщують у ньому кожен ресурс із простором імен — за винятком простору імен, який чарт фіксує сам, і виду, який провайдер не може класифікувати. Коли його не оголошено, режими розходяться: чарт, що проєктує простір імен релізу, розміщує свої ресурси в default, тоді як вивід synthesized не записує жодного, а чарт, що не записує простору імен, не розміщує їх у жодному, тож вони потрапляють туди, куди їх поміщає інструмент, що застосовує маніфести. Локальні чарти, які містять FeatureRecipes стандартної бібліотеки, натомість читають значення каскаду безпосередньо через свій valuesMapping: це дає їм змогу пропускати поле, коли жодна межа не оголошує простору імен, відповідно до виводу synthesized, чого простір імен релізу сам по собі виразити не може, бо він ніколи не буває порожнім.

Робочі приклади

Режим із джерелом — Recipe, що вказує на вендорований чарт:

apiVersion: aggrega.ai/v1beta1
kind: Recipe
metadata:
name: api-server-helm
version: 1.0.0
spec:
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/v1beta1
kind: Recipe
metadata:
name: api-server-workload
version: 1.0.0
spec:
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 — поточна класифікація готовності.