Die Import-Antwortdatei
Manche Werte kann keine Quelle enthalten: das Image einer aus Ihrem eigenen Code gebauten Anwendung, die E-Mail-Adresse eines Eigentümerkontos, ein Modell, das die Quelle nicht nennt, der Name eines Kubernetes-Secrets. aggrega import entwirft jeden solchen Wert als leere Zeichenkette, unter einem Kommentar, der sagt, was er ist, und übernimmt ihn einmal von Ihnen — aus der Antwortdatei oder aus einer Frage im Terminal. Die Antworten werden in der Antwortdatei import-answers.yaml aufbewahrt, sodass jeder spätere Import derselben Quelle sie von dort liest und nichts fragt.
Diese Seite beschreibt, wo die Datei liegt, was sie enthält, wie die Werte hineingelangen und was ein Import tut, wenn ein Wert noch fehlt. Wozu ein Import dient, sowie Anleitungen von einer Quelle bis zu einem Build finden Sie unter Import.
Welche Werte ausstehen
Nach dem Entwerfen prüft der Import jedes entworfene Dokument gegen sein eigenes Schema und gegen das Katalogschema jeder Component, jedes Feature und jeder Verbindung, die das Dokument deklariert. Ein Wert ist ausstehend, wenn er noch leer ist, wo dieses Schema einen verlangt, oder wo das Schema den Schlüssel deklariert und nichts ihn geliefert hat. Jeder ausstehende Wert wird durch die eigene Beschreibung seines Schlüssels im Schema beschrieben; wo das Schema keine angibt, durch den Kommentar, den der Entwurf über den Schlüssel schreibt.
Solange ein Wert aussteht, lädt der Import die Abhängigkeiten des entworfenen Release nicht; er lädt sie, sobald jeder Wert beantwortet ist (siehe Erneutes Ausführen und --sync).
Wo sich die Datei befindet
| Die Quelle ist | Die Antwortdatei ist |
|---|---|
| eine Datei | import-answers.yaml im selben Verzeichnis wie die Quelldatei |
| ein Verzeichnis | import-answers.yaml innerhalb des Quellverzeichnisses |
--answers <file> benennt eine andere Datei. Ein relativer Pfad wird gegen das Verzeichnis aufgelöst, in dem Sie den Befehl ausführen. Wenn für die Entwürfe Werte ausstehen und die Antwortdatei nicht die Standarddatei neben der Quelle ist, benennt sie der Datensatz, den der Import neben die Entwürfe schreibt, .aggrega-import.json, sodass ein späteres aggrega import --sync in dasselbe Verzeichnis sie liest, ohne dass sie erneut angegeben werden muss. Der Datensatz enthält nie eine Antwort.
Die Antwort für ein Geheimnis ist der Name der Quelle, aus der das Geheimnis stammt, nie das Geheimnis selbst (siehe Geheimnisse), daher kann die Antwortdatei zusammen mit der Quelle in der Versionskontrolle aufbewahrt werden.
Was sie enthält
Die Datei ist YAML. Ihre Schlüssel der obersten Ebene sind die entworfenen Dateien, jeweils unter dem Pfad, unter dem sie entworfen werden. Darunter ist ein Schlüssel der gepunktete Schlüsselpfad eines ausstehenden Werts innerhalb dieses Dokuments, und sein Wert ist die Antwort. Die Beschreibung des Schlüssels aus dem Schema wird als Kommentar darüber geschrieben. Ein Segment des Schlüsselpfads, das leer ist oder einen Punkt, Leerraum oder ein Anführungszeichen enthält, wird in doppelte Anführungszeichen gesetzt. Eine Datei, die sich nicht in dieser Form lesen lässt, beendet den Import unter Angabe der Datei und des Grundes, und es wird nichts geschrieben.
Zum Beispiel hat der mit --target helm entworfene Google-ADK-Import zwei ausstehende Werte in seinem Release: das Image des Agenten, den Sie aus Ihrem Projekt bauen, und die Quelle des Gemini-API-Schlüssels des Agenten. Wenn beide beantwortet sind, lautet die Antwortdatei im Quellverzeichnis 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"Beide Antworten sind Ihre eigenen: ghcr.io/example/support-agent:1.0.0 steht für das Image, das Sie bauen und pushen, und google-api-key für den Namen des Kubernetes-Secrets, das den Schlüssel in dem Namespace enthält, in den Sie deployen.
Jede Antwort ist ein einzelner Wert, und der Import schreibt ihn als String in den Entwurf, anstelle des leeren, ohne sonst etwas am Entwurf zu ändern. Eine Antwort, die in ein entworfenes Aggregate geschrieben wird, liest sich genau so zurück, wie Sie sie eingegeben haben, {{ eingeschlossen. Eine leere Antwort lässt den Wert ausstehend.
Wie die Werte hineingelangen
Der Import beantwortet jeden ausstehenden Wert zuerst aus der Antwortdatei. Für jeden Wert, den die Datei unbeantwortet lässt, fragt er Sie, eine Frage nach der anderen — aber nur, wenn Standardeingabe und Standardausgabe beide ein Terminal sind und --dry-run nicht angegeben ist:
- jede Frage nennt die entworfene Datei und den Schlüsselpfad und ist anhand der Beschreibung des Schemas formuliert;
- die Fragen werden auf die Standardfehlerausgabe geschrieben, sodass die Standardausgabe nur das Ergebnis des Imports enthält;
- das Drücken der Eingabetaste stellt den Wert für später zurück, und das Beenden der Eingabe beendet die Fragen.
Jede Antwort, die Sie geben, wird in die Entwürfe und in die Antwortdatei geschrieben, und die Antwortdatei wird unter den geschriebenen Dateien genannt. Ein Lauf, der in der Antwortdatei nichts ändert, schreibt sie nicht erneut.
Geheimnisse
Der Wert eines Geheimnisses — eines Werts, den sein Schema als sensibel kennzeichnet — wird damit beantwortet, woher das Geheimnis stammt, niemals mit dem Geheimnis selbst. Die zugehörige Frage fragt genau danach, und die Antwort ist einer dieser Namen:
| Antwort | Beispiel |
|---|---|
| ein Variablenname | OPENAI_API_KEY |
| ein Verweis auf eine Variable | ${OPENAI_API_KEY} |
| der Name eines Kubernetes-Secrets | openai-api-key |
Der Import prüft, ob die Antwort die Form eines dieser Namen hat, und weist alles andere zurück:
- an einem Terminal wird die Antwort zurückgewiesen, der Grund angezeigt und die Frage erneut gestellt;
- in der Antwortdatei bricht der Import ab, nennt die Antwortdatei, die entworfene Datei und den Schlüssel — niemals die Antwort, die das Geheimnis selbst sein kann — und schreibt nichts.
Die Prüfung liest die Form der Antwort, daher wird ein Geheimnis, das zufällig wie ein Name aussieht, nicht von einem Namen unterschieden. Das Geheimnis selbst bleibt dort, worauf der Name verweist: in der Variablen oder im Secret.
Ohne Terminal
In der Continuous Integration, über eine Pipe und aus dem Import-Werkzeug des Assistenten (aggrega mcp) wird nichts gefragt, und der Import des Editors fragt nichts, während er läuft. Ein Import, der nach dem Lesen der Antwortdatei noch Werte schuldet:
- schreibt die Entwürfe und lässt jeden geschuldeten Wert leer;
- schreibt die Antwortdatei mit jedem geschuldeten Schlüssel und leerer Antwort;
- nennt jeden geschuldeten Wert auf der Standardfehlerausgabe, als Warnung mit der entworfenen Datei, dem Schlüsselpfad und seiner Beschreibung;
- lädt die Abhängigkeiten des entworfenen Release nicht herunter;
- endet mit Status 1 und einem Satz, der angibt, wie viele Werte geschuldet sind und wo sie einzutragen sind:
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 againSchreiben Sie jede Antwort neben ihren Schlüssel und führen Sie dann aggrega import <source> --sync in dasselbe Verzeichnis aus: Es entwirft für das Ziel, das dem früheren Import gegeben wurde, schreibt jede Antwort in die Entwürfe und fragt nichts. Ein einfaches aggrega import in ein Verzeichnis, das bereits das entworfene Aggregate enthält, bricht ab, nennt --sync und schreibt nichts. Ein Import in ein neues Ausgabeverzeichnis liest die Antwortdatei ebenfalls: die Standarddatei oder die, die --answers angibt.
Das Import-Werkzeug des Assistenten nimmt die Antwortdatei als answers entgegen, relativ zum Stammverzeichnis des Workspace oder absolut angegeben. Ein Aufruf, der noch Werte schuldet, schlägt mit diesem Satz fehl und liefert daneben das Ergebnis des Imports, einschließlich der Warnungen. Auch der Import des Editors nimmt die Antwortdatei entgegen, und derselbe Satz schließt seine Diagnosen ab.
Beide listen außerdem jeden noch geschuldeten Wert als Daten unter owed auf: die entworfene Datei, den Schlüsselpfad als Liste von Schlüsseln, die Frage, ob der Wert der eines Secrets ist, und für ein Secret, was seine Antwort sein muss (secretAdvice vom Editor, secret_advice vom Import-Werkzeug des Assistenten). Senden Sie jede Antwort unter answered zurück — die entworfene Datei, den Schlüsselpfad und die Antwort — mit sync, und der Import prüft sie, bewahrt sie in der Antwortdatei auf und schreibt sie in die Entwürfe, wie er es mit einer an einem Terminal eingegebenen Antwort tut. Die Antwort eines Secrets, die kein Name ist, wird weder aufbewahrt noch geschrieben: Der Wert bleibt in owed, mit dem Grund anstelle seines Hinweises.
Nach einem Import, der seine Entwürfe schreibt, bietet der Editor an, jeden noch offenen Wert in einem eigenen Eingabefeld abzufragen, und sendet die Antworten auf diesem Weg zurück; nach einer Vorschau bietet er nichts an, da unter --dry-run nichts gefragt wird. Die Werte beantworten, die ein Import noch schuldig bleibt beschreibt die Fragen.
Unter --dry-run wird nichts gefragt und nichts geschrieben, auch die Antwortdatei nicht. Jeder geschuldete Wert wird dennoch auf der Standardfehlerausgabe genannt, und der Exit-Status ist der des Probelaufs selbst.
Erneute Ausführung und --sync
aggrega import --sync liest dieselbe Antwortdatei wie der vorherige Import: die von --answers angegebene, sonst die, die der Datensatz neben den Entwürfen nennt, sonst die Standarddatei neben der Quelle. Es schreibt jede Antwort anstelle des leeren Werts in die Entwürfe und fragt nichts, wenn die Antwortdatei jeden geschuldeten Wert beantwortet.
Sobald nichts mehr geschuldet ist und der Workspace nicht offline ist, lädt der Import die Abhängigkeiten des entworfenen Release so herunter, wie es aggrega pull tut, und schreibt release.lock, sodass aggrega validate und aggrega build sofort mit den Entwürfen funktionieren. Unter --offline wird nichts heruntergeladen, und der Import nennt den als Nächstes auszuführenden Befehl aggrega pull --release <path>.
Eine Antwortdatei für mehrere Ziele
Dieselbe Quelle kann, für verschiedene Ziele entworfen, verschiedene Werte schulden: Das oben gezeigte Google-ADK-Release, entworfen mit --target compose, schuldet nur das Image, und dasselbe Release, entworfen mit --target helm, schuldet zusätzlich, woher der Gemini-API-Schlüssel des Agenten stammt. Eine Antwortdatei bedient beide:
- der Import fügt die Schlüssel hinzu, die seine Entwürfe schulden, und setzt die Antworten, die er erhält;
- eine Antwort für einen Schlüssel, den diese Entwürfe nicht schulden, bleibt in der Datei erhalten und wird nicht angewendet;
- jeder andere Schlüssel und jeder Kommentar in der Datei bleibt unverändert.
Die Antwortdatei wird nur gelesen, wo die Entwürfe einen Wert schulden. Wo sie das tun, nennt eine Informationszeile auf der Standardfehlerausgabe jede aufbewahrte und nicht angewendete Antwort — hier für den Flowise-Import, entworfen mit --target compose, der nur die E-Mail-Adresse des Eigentümers schuldet und eine Antwortdatei liest, die auch die beiden Kubernetes-Secrets nennt, die derselbe Import mit --target helm schuldet:
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 appliedWo die Entwürfe nichts schulden — etwa beim Langflow-Import, entworfen mit --target compose, der jedes Secret aus einer Variablen liest —, wird die Antwortdatei nicht gelesen, keine solche Zeile ausgegeben und die Datei bleibt, wie sie ist.
Siehe auch
aggrega import— die Referenz des Befehls, einschließlich aller Flags.- Import — was ein Import entwirft, und eine Schritt-für-Schritt-Anleitung für jedes Quellformat.