Файл відповідей імпорту
Деякі значення не може містити жодне джерело: образ застосунку, зібраного з вашого власного коду, електронна пошта облікового запису власника, модель, яку джерело не називає, ім’я Secret у Kubernetes. aggrega import записує кожне таке значення в чернетку як порожній рядок під коментарем, що пояснює, що це, і отримує його від вас один раз — з файлу відповідей або через запитання в терміналі. Відповіді зберігаються у файлі відповідей import-answers.yaml, тож кожен наступний імпорт того самого джерела читає їх звідти й нічого не запитує.
Ця сторінка описує, де розташований файл, що він містить, як у нього потрапляють значення і що робить імпорт, коли значення досі бракує. Для чого потрібен імпорт, а також покрокові приклади від джерела до збирання наведено в розділі Імпорт.
Які значення очікуються
Після створення чернеток імпорт перевіряє кожен документ-чернетку за його власною схемою, а також за схемою каталогу кожної сутності Component, Feature і кожного з’єднання, які оголошує документ. Значення є очікуваним, коли воно досі порожнє там, де ця схема його вимагає, або там, де схема оголошує ключ, а ніщо його не надало. Кожне очікуване значення описується власним описом його ключа в схемі; якщо схема його не наводить — коментарем, який чернетка записує над ключем.
Поки будь-яке значення очікується, імпорт не завантажує залежності чернетки сутності Release; він завантажує їх, щойно на кожне значення є відповідь (див. Повторний запуск і --sync).
Де розташований файл
| Джерело — це | Файл відповідей — це |
|---|---|
| файл | import-answers.yaml у тому самому каталозі, що й файл джерела |
| каталог | import-answers.yaml всередині каталогу джерела |
--answers <file> вказує інший файл. Відносний шлях розв’язується відносно каталогу, у якому ви запускаєте команду. Якщо в чернетках бракує значень, а файл відповідей не є типовим файлом поруч із джерелом, запис, який імпорт створює поруч із чернетками, .aggrega-import.json, вказує його, тож пізніший aggrega import --sync у той самий каталог читає його без повторного зазначення. Запис ніколи не містить відповіді.
Відповіддю для секрету є назва джерела, з якого надходить секрет, і ніколи не сам секрет (див. Секрети), тож файл відповідей можна зберігати разом із джерелом у системі контролю версій.
Що він містить
Файл має формат YAML. Його ключі верхнього рівня — це файли-чернетки, за шляхом, за яким створюється кожна з них. Під кожним із них ключ — це шлях ключа з крапками для відсутнього значення в цьому документі, а його значення — відповідь. Опис ключа зі схеми записується як коментар над ним. Сегмент шляху ключа, який порожній або містить крапку, пробільний символ чи лапки, записується в подвійних лапках. Файл, який не читається в такій формі, зупиняє імпорт із зазначенням файлу та причини, і нічого не записується.
Наприклад, імпорт Google ADK, створений із --target helm, має два відсутні значення у своїй сутності Release: образ агента, який ви збираєте зі свого проєкту, і джерело ключа API Gemini агента. Коли на обидва дано відповідь, файл відповідей у каталозі джерела support_agent/ має такий вигляд:
# Values the import could not draft from the source, keyed by the drafted file and the key path inside# it. Write each one beside its key; an import of the same source, and a sync, read them from here and# ask nothing. A secret is never written here: its key asks where the secret comes from — a variable# name, ${NAME}, or the name of a Kubernetes Secret.release.yaml: # Container image running the application built on ADK, serving its API on infra.port on every # interface. spec.components.support-agent.infra.image: "ghcr.io/example/support-agent:1.0.0" # The origin of the secret value, written by the operator in the Release. Read exactly as # values.origin is. Write it here or in values.origin, never in both. A secret: name where it comes # from, never the value. spec.components.support-agent.uses.model.gemini-2-5-flash.features.credential.infra.origin: "google-api-key"Обидві відповіді — ваші: ghcr.io/example/support-agent:1.0.0 позначає образ, який ви збираєте й публікуєте, а google-api-key — назву об’єкта Kubernetes Secret, що зберігає ключ у просторі імен, у який ви розгортаєте.
Кожна відповідь — це одне значення, і імпорт записує її в чернетку як рядок замість порожнього, нічого більше в чернетці не змінюючи. Відповідь, записана в сутність Aggregate, створену як чернетка, читається точно так, як ви її ввели, включно з {{. Порожня відповідь залишає значення відсутнім.
Як потрапляють значення
Імпорт спершу заповнює кожне відсутнє значення з файлу відповідей. Для кожного значення, на яке файл не дає відповіді, він запитує вас, по одному питанню за раз — але лише тоді, коли стандартний ввід і стандартний вивід обидва є терміналом, а --dry-run не вказано:
- кожне питання називає файл-чернетку та шлях ключа і сформульоване на основі опису зі схеми;
- питання записуються в стандартний потік помилок, тож стандартний вивід містить лише результат імпорту;
- натискання Enter відкладає значення на потім, а завершення введення припиняє запитання.
Кожна ваша відповідь записується в чернетки та у файл відповідей, а файл відповідей зазначається серед записаних файлів. Запуск, який нічого не змінює у файлі відповідей, не записує його повторно.
Секрети
На значення секрету — таке, яке його схема позначає як чутливе — відповідають тим, звідки береться секрет, і ніколи самим секретом. Його запитання питає саме про це, а відповідь — одна з цих назв:
| Відповідь | Приклад |
|---|---|
| ім’я змінної | OPENAI_API_KEY |
| посилання на змінну | ${OPENAI_API_KEY} |
| назва Kubernetes Secret | openai-api-key |
Імпорт перевіряє, що відповідь має форму однієї з цих назв, і відхиляє все інше:
- у терміналі відповідь відхиляється, показується причина, і запитання ставиться знову;
- у файлі відповідей імпорт зупиняється, називаючи файл відповідей, чорновий файл і ключ — ніколи не відповідь, яка може бути самим секретом — і нічого не записує.
Перевірка читає форму відповіді, тож секрет, який випадково схожий на назву, від назви не відрізняється. Сам секрет залишається там, куди вказує назва: у змінній або в Secret.
Без термінала
У безперервній інтеграції, через канал (pipe) і з інструмента імпорту асистента (aggrega mcp) нічого не запитується, а імпорт редактора нічого не запитує під час виконання. Імпорт, якому після читання файлу відповідей усе ще бракує значень:
- записує чернетки, залишаючи кожне потрібне значення порожнім;
- записує файл відповідей, у якому є кожен потрібний ключ із порожньою відповіддю;
- називає кожне потрібне значення в стандартному потоці помилок як попередження, що вказує чорновий файл, шлях ключа та його опис;
- не завантажує залежності чорнової сутності Release;
- завершується зі статусом 1 і одним реченням про те, скільки значень бракує і куди їх записати:
2 values the drafts leave empty are still owed, listed in the answers file <path>/support_agent/import-answers.yaml: write each beside its key there, then run the import againЗапишіть кожну відповідь поруч із її ключем, а потім виконайте aggrega import <source> --sync у той самий каталог: він створює чернетки для цілі, заданої попередньому імпорту, записує кожну відповідь у чернетки й нічого не запитує. Звичайний aggrega import у каталог, який уже містить чорнову сутність Aggregate, зупиняється, називаючи --sync, і нічого не записує. Імпорт у новий вихідний каталог теж читає файл відповідей: типовий або той, який вказує --answers.
Інструмент імпорту асистента приймає файл відповідей як answers, заданий відносно кореня робочої області або абсолютним шляхом. Виклик, якому ще бракує значень, завершується помилкою з цим реченням і містить поруч із ним результат імпорту, разом із попередженнями. Імпорт у редакторі теж приймає файл відповідей, і те саме речення завершує його діагностику.
Обидва також перелічують як дані кожне ще потрібне значення в owed: чорновий файл, шлях ключа як список ключів, запитання, чи належить значення секрету, а для секрету — якою має бути його відповідь (secretAdvice з редактора, secret_advice з інструмента імпорту асистента). Надішліть кожну відповідь назад у answered — чорновий файл, шлях ключа й відповідь — разом із sync, і імпорт перевіряє її, зберігає у файлі відповідей і записує в чернетки, так само як відповідь, введену в терміналі. Відповідь секрету, яка не є назвою, не зберігається й не записується: значення залишається в owed, а замість поради наводиться причина.
Після імпорту, що записує свої чернетки, редактор пропонує запитати кожне ще ненадане значення в окремому полі введення й надсилає відповіді назад у такий спосіб; після попереднього перегляду він нічого не пропонує, бо з --dry-run нічого не запитується. Запитання описано в розділі Відповіді на значення, яких імпорт ще не надав.
З --dry-run нічого не запитується і нічого не записується, зокрема файл відповідей. Кожне потрібне значення все одно називається в стандартному потоці помилок, а код виходу — це код самого пробного запуску.
Повторний запуск і --sync
aggrega import --sync читає той самий файл відповідей, що й попередній імпорт: той, який вказує --answers, інакше той, який вказує запис поруч із чернетками, інакше типовий поруч із джерелом. Він записує кожну відповідь у чернетки замість порожнього значення, а якщо файл відповідей відповідає на кожне потрібне значення, нічого не запитує.
Щойно нічого більше не бракує і робоча область не перебуває в офлайн-режимі, імпорт завантажує залежності чорнової сутності Release так, як це робить aggrega pull, записуючи release.lock, тож aggrega validate і aggrega build одразу працюють із чернетками. З --offline нічого не завантажується, і імпорт називає команду aggrega pull --release <path>, яку слід виконати далі.
Один файл відповідей для кількох цілей
Те саме джерело, оформлене в чернетки для різних цілей, може потребувати різних значень: наведена вище сутність Release для Google ADK, створена з --target compose, потребує лише образу, а та сама сутність Release, створена з --target helm, потребує також вказати, звідки береться ключ Gemini API агента. Один файл відповідей обслуговує обидва випадки:
- імпорт додає ключі, яких потребують його чернетки, і встановлює отримані відповіді;
- відповідь для ключа, якого ці чернетки не потребують, зберігається у файлі й не застосовується;
- усі інші ключі й коментарі у файлі залишаються без змін.
Файл відповідей читається лише там, де чернетки потребують якогось значення. Там, де потребують, інформаційний рядок у стандартному потоці помилок називає кожну збережену й не застосовану відповідь — тут для імпорту Flowise, створеного з --target compose, який потребує лише електронної адреси власника, і читає файл відповідей, що також називає два об’єкти Secret Kubernetes, яких той самий імпорт потребує з --target helm:
info: the answers file <path>/import-answers.yaml also answers spec.components.flowise.features.owner_password.infra.origin in release.yaml, spec.components.flowise.uses.model.chatopenai-0.features.credential.infra.origin in release.yaml, which these drafts do not leave empty; those answers are kept there and not appliedТам, де чернетки нічого не потребують — наприклад, для імпорту Langflow, створеного з --target compose, який читає кожен секрет зі змінної, — файл відповідей не читається, жоден такий рядок не виводиться, а файл залишається без змін.
Див. також
aggrega import— довідка команди, з усіма прапорцями.- Імпорт — що імпорт створює в чернетках, і покрокове керівництво для кожного формату джерела.