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

Коли варто вдаватися до кроку конвеєра

FeatureRecipe дає вам два способи сформувати вихідні дані, які додає Feature: шаблонний FeatureRecipe, що генерує власні документи, і крок конвеєра (pipeline:), що запускає Wasm-плагін над відрендереним результатом. Вони розв’язують різні задачі. Ця сторінка — посібник із вибору: вдавайтеся до кроку конвеєра рівно за двох умов, а для всього іншого використовуйте шаблонний FeatureRecipe.

Два інструменти

Шаблонний FeatureRecipe локальний і генеративний. Він створює власні документи з власних значень через шаблон Go — ConfigMap сайдкара, CRD політики, об’єкт автомасштабування. Усе, що він видає, є функцією від values: і infra: сутності Feature та контексту рендерингу, переданого його шаблонам. Він ніколи не втручається у вихідні дані іншої сутності; він додає власні документи. Якщо те, що потрібно створити, можна записати на основі того, що Feature вже знає, шаблонний FeatureRecipe — правильний і простіший інструмент: без плагіна, без конвеєра.

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

Дві умови для кроку конвеєра

Вдавайтеся до кроку конвеєра лише тоді, коли виконується одна з цих умов. Якщо жодна не виконується, згенеруйте документ шаблонним FeatureRecipe.

  1. Патч в області хоста — потрібно втрутитися в структуру іншої, вже відрендереної сутності. Класичний випадок — додавання змінної середовища, монтування тому або контейнера-сайдкара до робочого навантаження компонента-споживача — документа, автором якого сам Feature не є. Шаблонний FeatureRecipe цього не може: він створює власні документи й не редагує чужі. Крок конвеєра може, бо працює з відрендереним набором і може звертатися до документів компонента-хоста за ключем.

  2. Видання або патч, залежні від вмісту, — результат залежить від того, що містить відрендерений набір. Коли ресурс, який ви видаєте, або патч, який застосовуєте, є функцією від вмісту, створеного збіркою, — фактичних портів, оголошених у Deployment, імен контейнерів, що потрапили до маніфесту, ресурсів, на які розгорнувся чарт, — для рішення потрібен відрендерений вміст. Шаблонний FeatureRecipe рендерить із власних значень Feature і ніколи не бачить готового набору, тож не може ухвалити рішення, залежне від вмісту; крок конвеєра спершу читає вміст, а потім діє.

Обидві умови мають спільну форму: їм потрібна інформація, що існує лише після рендерингу, — структура іншої сутності або сам виданий вміст. Локальній генерації це ніколи не потрібно, тож локальній генерації ніколи не потрібен крок конвеєра.

Крок трансформує; політика перевіряє

Крок конвеєра — це трансформатор: він змінює відрендерений набір. Це не місце для перевірки, чи прийнятний результат. Щоб перевірити збірку — переконатися, що патчене робоче навантаження має сайдкар, що жоден незашифрований секрет не потрапив до виводу, що потрібна мітка присутня, — підключіть політику етапу рендерингу: плагін керування в ролі render-verdict, який виконується після рендерингу над виданими артефактами й повертає вердикт. Вердикт halt зупиняє збірку; вердикт warn або info інформує без блокування.

Тримайте їх окремо. Не вбудовуйте логіку перевірки в крок конвеєра і не вдавайтеся до політики, щоб змінювати вивід: плагін керування, підключений у ролі вердикту, повертає вердикти й ніколи не патчить, а хост читає вивід ролі вердикту лише як рішення. Крок формує вивід; політика render-verdict оцінює його. Сторінка сокета керування описує всі чотири ролі керування та рівні серйозності вердиктів.

Кроки компонуються

Крок конвеєра може оголосити типізований контракт входу й виходу, тож його вхід with: і повернені виходи є перевіреними формами, а не довільними блоками даних. Крок також повертає іменовані outputs, а крок, оголошений пізніше в тому самому конвеєрі, читає виходи попереднього кроку зі свого шаблону with: як .steps.<id>.outputs.<key>. Так двочастинний шаблон компонується без зв’язування: крок Fetcher видає ресурс облікових даних і публікує ім’я отриманого Secret як вихід; крок Injector читає це ім’я й патчить робоче навантаження-споживача, щоб змонтувати його. Кожен крок відповідає за одне завдання, а конвеєр передає їхні виходи в оголошеному порядку.

Перехресні посилання

  • entities/featurerecipe.md — поверхня створення FeatureRecipe, зокрема pipeline:.
  • plugins/plugin-contract.md — формат обміну кроку конвеєра: на вході набір документів із ключами, на виході патчі RFC 6902, побічні ефекти, діагностика та виходи кроку.
  • plugins/policy-socket.md — сокет керування, зокрема роль вердикту етапу рендерингу, що перевіряє вивід збірки.
  • templates/template-context-contract.md — поле .steps.<id>.outputs, яке читає пізніший крок.
  • examples/04-secrets.md — форма конвеєра Fetcher + Injector.