Le fichier de réponses d’import
Certaines valeurs ne peuvent figurer dans aucune source : l’image d’une application construite à partir de votre propre code, l’adresse e-mail d’un compte propriétaire, un modèle que la source ne nomme pas, le nom d’un Secret Kubernetes. aggrega import ébauche chacune de ces valeurs sous forme de chaîne vide, sous un commentaire indiquant ce qu’elle est, et vous la demande une seule fois — depuis le fichier de réponses, ou par une question dans un terminal. Les réponses sont conservées dans le fichier de réponses, import-answers.yaml, si bien que chaque import ultérieur de la même source les y lit et ne demande rien.
Cette page décrit où se trouve le fichier, ce qu’il contient, comment les valeurs y entrent et ce que fait un import lorsqu’une valeur manque encore. À quoi sert un import, ainsi que des parcours guidés d’une source jusqu’à un build, se trouvent dans Import.
Quelles valeurs sont dues
Après l’ébauche, l’import vérifie chaque document ébauché par rapport à son propre schéma, et par rapport au schéma de catalogue de chaque Component, Feature et connexion que le document déclare. Une valeur est due lorsqu’elle est encore vide là où ce schéma en exige une, ou là où le schéma déclare la clé et que rien ne l’a fournie. Chaque valeur due est décrite par la description que le schéma donne lui-même de sa clé ; là où le schéma n’en donne aucune, par le commentaire que l’ébauche écrit au-dessus de la clé.
Tant qu’une valeur est due, l’import ne récupère pas les dépendances de la Release ébauchée ; il les récupère dès que chaque valeur a reçu une réponse (voir Réexécution et --sync).
Emplacement du fichier
| La source est | Le fichier de réponses est |
|---|---|
| un fichier | import-answers.yaml dans le même répertoire que le fichier source |
| un répertoire | import-answers.yaml à l’intérieur du répertoire source |
--answers <file> désigne un autre fichier. Un chemin relatif est résolu par rapport au répertoire dans lequel vous exécutez la commande. Lorsque des valeurs restent attendues dans les brouillons et que le fichier de réponses n’est pas celui par défaut, à côté de la source, l’enregistrement que l’import écrit à côté des brouillons, .aggrega-import.json, le désigne, de sorte qu’un aggrega import --sync ultérieur dans le même répertoire le lit sans qu’il faille l’indiquer à nouveau. L’enregistrement ne contient jamais de réponse.
La réponse pour un secret est le nom de l’endroit d’où provient le secret, jamais le secret lui-même (voir Secrets), de sorte que le fichier de réponses peut être conservé avec la source dans le contrôle de version.
Ce qu’il contient
Le fichier est au format YAML. Ses clés de premier niveau sont les fichiers rédigés en brouillon, désignés par le chemin où chacun est rédigé. Sous chacune, une clé est le chemin de clé pointé d’une valeur attendue dans ce document, et sa valeur est la réponse. La description de la clé fournie par le schéma est écrite en commentaire au-dessus d’elle. Un segment du chemin de clé qui est vide, ou qui contient un point, une espace ou un guillemet, est écrit entre guillemets doubles. Un fichier qui ne se lit pas selon cette forme arrête l’import, en indiquant le fichier et la raison, et rien n’est écrit.
Par exemple, l’import Google ADK rédigé avec --target helm attend deux valeurs dans sa Release : l’image de l’agent que vous construisez à partir de votre projet, et la provenance de la clé d’API Gemini de l’agent. Une fois les deux renseignées, le fichier de réponses dans le répertoire source support_agent/ se lit ainsi :
# 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"Les deux réponses vous appartiennent : ghcr.io/example/support-agent:1.0.0 représente l’image que vous construisez et publiez, et google-api-key le nom du Secret Kubernetes contenant la clé dans le namespace où vous déployez.
Chaque réponse est une seule valeur, et l’import l’écrit dans le brouillon sous forme de chaîne, à la place de la valeur vide, sans rien changer d’autre dans le brouillon. Une réponse écrite dans un Aggregate rédigé en brouillon se relit exactement telle que vous l’avez saisie, {{ compris. Une réponse vide laisse la valeur attendue.
Comment les valeurs sont renseignées
L’import renseigne d’abord chaque valeur attendue à partir du fichier de réponses. Pour chaque valeur que le fichier laisse sans réponse, il vous la demande, une question à la fois — mais seulement lorsque l’entrée standard et la sortie standard sont toutes deux un terminal, et que --dry-run n’est pas fourni :
- chaque question indique le fichier rédigé et le chemin de clé, et est formulée à partir de la description du schéma ;
- les questions sont écrites sur la sortie d’erreur standard, de sorte que la sortie standard ne contient que le résultat de l’import ;
- appuyer sur Entrée laisse la valeur pour plus tard, et mettre fin à l’entrée arrête les questions.
Chaque réponse que vous donnez est écrite dans les brouillons et dans le fichier de réponses, et le fichier de réponses figure parmi les fichiers écrits. Une exécution qui ne change rien dans le fichier de réponses ne l’écrit pas à nouveau.
Secrets
La valeur d’un secret — une valeur que son schéma marque comme sensible — reçoit pour réponse la provenance du secret, jamais le secret lui-même. Sa question demande cela, et la réponse est l’un de ces noms :
| Réponse | Exemple |
|---|---|
| un nom de variable | OPENAI_API_KEY |
| une référence à une variable | ${OPENAI_API_KEY} |
| le nom d’un Secret Kubernetes | openai-api-key |
L’import vérifie que la réponse a la forme de l’un de ces noms, et refuse tout le reste :
- dans un terminal, la réponse est refusée, la raison est affichée et la question est posée à nouveau ;
- dans le fichier de réponses, l’import s’arrête en nommant le fichier de réponses, le fichier ébauché et la clé — jamais la réponse, qui peut être le secret lui-même — et n’écrit rien.
La vérification lit la forme de la réponse, de sorte qu’un secret qui ressemble par hasard à un nom n’est pas distingué d’un nom. Le secret lui-même reste là où pointe le nom : dans la variable ou dans le Secret.
Sans terminal
En intégration continue, à travers un pipe et depuis l’outil d’import de l’assistant (aggrega mcp), rien n’est demandé, et l’import de l’éditeur ne demande rien pendant son exécution. Un import qui doit encore des valeurs une fois le fichier de réponses lu :
- écrit les ébauches, en laissant vide chaque valeur due ;
- écrit le fichier de réponses avec chaque clé due présente et sa réponse vide ;
- nomme chaque valeur due sur la sortie d’erreur standard, sous forme d’avertissement indiquant le fichier ébauché, le chemin de la clé et sa description ;
- ne récupère pas les dépendances de la Release ébauchée ;
- se termine avec le statut 1 et une phrase indiquant combien de valeurs sont dues et où les écrire :
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Écrivez chaque réponse à côté de sa clé, puis exécutez aggrega import <source> --sync dans le même répertoire : il produit les brouillons pour la cible donnée à l’import précédent, écrit chaque réponse dans les brouillons et ne demande rien. Un simple aggrega import dans un répertoire qui contient déjà l’Aggregate ébauché s’arrête, en nommant --sync, et n’écrit rien. Un import dans un nouveau répertoire de sortie lit lui aussi le fichier de réponses : celui par défaut, ou celui que nomme --answers.
L’outil d’import de l’assistant prend le fichier de réponses comme answers, désigné relativement à la racine de l’espace de travail ou de manière absolue. Un appel qui doit encore des valeurs échoue avec cette phrase et porte à côté le résultat de l’import, avertissements compris. L’import de l’éditeur prend lui aussi le fichier de réponses, et la même phrase clôt ses diagnostics.
Tous deux listent aussi chaque valeur encore due sous forme de données, sous owed : le fichier ébauché, le chemin de la clé sous forme de liste de clés, la question, si la valeur est celle d’un secret, et pour un secret ce que doit être sa réponse (secretAdvice depuis l’éditeur, secret_advice depuis l’outil d’import de l’assistant). Renvoyez chaque réponse sous answered — le fichier ébauché, le chemin de la clé et la réponse — avec sync, et l’import la vérifie, la conserve dans le fichier de réponses et l’écrit dans les brouillons, comme il le fait pour une réponse saisie dans un terminal. La réponse d’un secret qui n’est pas un nom n’est ni conservée ni écrite : la valeur reste dans owed, avec la raison à la place de son conseil.
Après un import qui écrit ses brouillons, l’éditeur propose de demander chaque valeur encore due dans une zone de saisie distincte, et renvoie les réponses de cette façon ; après un aperçu, il ne propose rien, puisque rien n’est demandé sous --dry-run. Répondre aux valeurs encore dues par un import décrit les questions.
Avec --dry-run, rien n’est demandé et rien n’est écrit, fichier de réponses compris. Chaque valeur due est tout de même nommée sur la sortie d’erreur standard, et le statut de sortie est celui de l’exécution à blanc elle-même.
Réexécution et --sync
aggrega import --sync lit le même fichier de réponses que l’import précédent : celui que nomme --answers, sinon celui que nomme l’enregistrement à côté des ébauches, sinon celui par défaut à côté de la source. Il écrit chaque réponse dans les ébauches à la place de la valeur vide et, là où le fichier de réponses répond à chaque valeur due, il ne demande rien.
Une fois que plus rien n’est dû et que l’espace de travail n’est pas hors ligne, l’import récupère les dépendances de la Release ébauchée comme le fait aggrega pull, en écrivant release.lock, de sorte que aggrega validate et aggrega build fonctionnent aussitôt sur les ébauches. Avec --offline, rien n’est récupéré, et l’import indique la commande aggrega pull --release <path> à exécuter ensuite.
Un seul fichier de réponses pour plusieurs cibles
La même source ébauchée pour des cibles différentes peut devoir des valeurs différentes : la Release Google ADK ci-dessus, ébauchée avec --target compose, ne doit que l’image, et la même Release ébauchée avec --target helm doit aussi la provenance de la clé d’API Gemini de l’agent. Un seul fichier de réponses sert les deux :
- l’import ajoute les clés que ses ébauches doivent et définit les réponses qu’il reçoit ;
- une réponse pour une clé que ces ébauches ne doivent pas est conservée dans le fichier sans être appliquée ;
- toutes les autres clés et tous les commentaires du fichier restent tels quels.
Le fichier de réponses n’est lu que là où les brouillons doivent une valeur. Là où c’est le cas, une ligne d’information sur la sortie d’erreur standard nomme chaque réponse conservée et non appliquée — ici pour l’import Flowise produit avec --target compose, qui ne doit que l’adresse e-mail du propriétaire, lisant un fichier de réponses qui nomme aussi les deux Secrets Kubernetes que le même import doit avec --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 appliedLà où les brouillons ne doivent rien — l’import Langflow produit avec --target compose, par exemple, qui lit chaque secret depuis une variable —, le fichier de réponses n’est pas lu, aucune ligne de ce type n’est affichée et le fichier est laissé tel quel.
Voir aussi
aggrega import— la référence de la commande, avec tous ses flags.- Import — ce qu’un import ébauche, et un guide pas à pas pour chaque format source.