Il file delle risposte dell’import
Alcuni valori non possono trovarsi in nessuna sorgente: l’immagine di un’applicazione compilata dal tuo codice, l’email di un account proprietario, un modello che la sorgente non nomina, il nome di un Secret Kubernetes. aggrega import scrive in bozza ciascuno di questi valori come stringa vuota, sotto un commento che dice che cosa sia, e lo prende da te una sola volta — dal file delle risposte, o da una domanda al terminale. Le risposte sono conservate nel file delle risposte, import-answers.yaml, così ogni import successivo della stessa sorgente le legge da lì e non chiede nulla.
Questa pagina descrive dove si trova il file, che cosa contiene, come vi entrano i valori e che cosa fa un import quando un valore manca ancora. A che cosa serve un import, e le procedure guidate da una sorgente a una build, si trovano in Import.
Quali valori sono dovuti
Dopo la stesura delle bozze, l’import verifica ogni documento in bozza rispetto al proprio schema e rispetto allo schema di catalogo di ogni Component, Feature e connessione che il documento dichiara. Un valore è dovuto quando è ancora vuoto dove quello schema ne richiede uno, o dove lo schema dichiara la chiave e nulla l’ha fornita. Ogni valore dovuto è descritto dalla descrizione che lo schema stesso dà della sua chiave; dove lo schema non ne dà nessuna, dal commento che la bozza scrive sopra la chiave.
Finché un valore è dovuto, l’import non scarica le dipendenze della Release in bozza; le scarica non appena ogni valore ha una risposta (vedi Riesecuzione e --sync).
Dove si trova il file
| La sorgente è | Il file delle risposte è |
|---|---|
| un file | import-answers.yaml nella stessa directory del file sorgente |
| una directory | import-answers.yaml all’interno della directory sorgente |
--answers <file> indica un altro file. Un percorso relativo viene risolto rispetto alla directory in cui esegui il comando. Quando le bozze richiedono valori e il file delle risposte non è quello predefinito accanto alla sorgente, il record che l’import scrive accanto alle bozze, .aggrega-import.json, lo indica, così un successivo aggrega import --sync nella stessa directory lo legge senza che sia necessario indicarlo di nuovo. Il record non contiene mai una risposta.
La risposta per un segreto è il nome della provenienza del segreto, mai il segreto stesso (vedi Segreti), quindi il file delle risposte può essere conservato insieme alla sorgente nel controllo di versione.
Che cosa contiene
Il file è in YAML. Le sue chiavi di primo livello sono i file generati come bozza, indicati dal percorso in cui ciascuno viene generato. Sotto ciascuna, una chiave è il percorso puntato della chiave di un valore richiesto all’interno di quel documento, e il suo valore è la risposta. La descrizione della chiave fornita dallo schema è scritta come commento sopra di essa. Un segmento del percorso della chiave che è vuoto, o che contiene un punto, spazi bianchi o un segno di virgolette, è scritto tra virgolette doppie. Un file che non si legge secondo questa forma interrompe l’import, indicando il file e il motivo, e non viene scritto nulla.
Per esempio, l’import di Google ADK generato con --target helm richiede due valori nella sua Release: l’immagine dell’agente che costruisci dal tuo progetto e la provenienza della chiave API Gemini dell’agente. Con entrambe le risposte fornite, il file delle risposte all’interno della directory sorgente 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"Entrambe le risposte sono tue: ghcr.io/example/support-agent:1.0.0 sta per l’immagine che costruisci e pubblichi, e google-api-key per il nome del Secret Kubernetes che contiene la chiave nel namespace in cui esegui il deploy.
Ogni risposta è un solo valore, e l’import la scrive nella bozza come stringa, al posto di quella vuota, senza cambiare nient’altro nella bozza. Una risposta scritta in un Aggregate generato come bozza si rilegge esattamente come l’hai digitata, {{ compreso. Una risposta vuota lascia il valore richiesto.
Come vengono inseriti i valori
L’import risponde a ogni valore richiesto prima di tutto dal file delle risposte. Per ogni valore a cui il file non risponde, lo chiede a te, una domanda alla volta — ma solo quando lo standard input e lo standard output sono entrambi un terminale e --dry-run non è indicato:
- ogni domanda indica il file generato e il percorso della chiave, ed è formulata a partire dalla descrizione dello schema;
- le domande vengono scritte sullo standard error, così lo standard output contiene solo il risultato dell’import;
- premendo Invio si lascia il valore per dopo, e terminando l’input si interrompono le domande.
Ogni risposta che dai viene scritta nelle bozze e nel file delle risposte, e il file delle risposte è indicato tra i file scritti. Un’esecuzione che non cambia nulla nel file delle risposte non lo scrive di nuovo.
Segreti
Al valore di un segreto — uno che lo schema contrassegna come sensibile — si risponde indicando da dove proviene il segreto, mai con il segreto stesso. La relativa domanda chiede proprio questo, e la risposta è uno di questi nomi:
| Risposta | Esempio |
|---|---|
| un nome di variabile | OPENAI_API_KEY |
| un riferimento a una variabile | ${OPENAI_API_KEY} |
| il nome di un Secret di Kubernetes | openai-api-key |
L’import controlla che la risposta abbia la forma di uno di questi nomi e rifiuta qualsiasi altra cosa:
- in un terminale, la risposta viene rifiutata, viene mostrato il motivo e la domanda viene posta di nuovo;
- nel file delle risposte, l’import si arresta indicando il file delle risposte, il file in bozza e la chiave — mai la risposta, che potrebbe essere il segreto stesso — e non scrive nulla.
Il controllo legge la forma della risposta, quindi un segreto che per caso somiglia a un nome non viene distinto da un nome. Il segreto stesso resta dove punta il nome: nella variabile o nel Secret.
Senza terminale
Nell’integrazione continua, attraverso una pipe e dallo strumento di import dell’assistente (aggrega mcp), non viene chiesto nulla, e l’import dell’editor non chiede nulla mentre è in esecuzione. Un import che, dopo la lettura del file delle risposte, deve ancora dei valori:
- scrive le bozze, lasciando vuoto ogni valore dovuto;
- scrive il file delle risposte con ogni chiave dovuta presente e la sua risposta vuota;
- indica ogni valore dovuto sullo standard error, come avviso che nomina il file in bozza, il percorso della chiave e la sua descrizione;
- non esegue il pull delle dipendenze della Release in bozza;
- termina con stato 1 e una frase che dice quanti valori sono dovuti e dove scriverli:
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 againScrivi ogni risposta accanto alla sua chiave, poi esegui aggrega import <source> --sync nella stessa directory: genera le bozze per il target dato all’import precedente, scrive ogni risposta nelle bozze e non chiede nulla. Un semplice aggrega import in una directory che contiene già l’Aggregate in bozza si arresta, indicando --sync, e non scrive nulla. Anche un import in una nuova directory di output legge il file delle risposte: quello predefinito, o quello indicato da --answers.
Lo strumento di import dell’assistente riceve il file delle risposte come answers, indicato relativamente alla radice del workspace o in forma assoluta. Una chiamata che deve ancora dei valori fallisce con quella frase e riporta accanto a essa il risultato dell’import, avvisi inclusi. Anche l’import dell’editor accetta il file delle risposte, e la stessa frase chiude la sua diagnostica.
Entrambi elencano inoltre come dati ogni valore ancora dovuto, sotto owed: il file in bozza, il percorso della chiave come lista di chiavi, la domanda, se il valore è quello di un segreto e, per un segreto, che cosa deve essere la sua risposta (secretAdvice dall’editor, secret_advice dallo strumento di import dell’assistente). Rimanda ogni risposta sotto answered — il file in bozza, il percorso della chiave e la risposta — con sync, e l’import la controlla, la conserva nel file delle risposte e la scrive nelle bozze, come fa con una risposta digitata in un terminale. La risposta di un segreto che non è un nome non viene né conservata né scritta: il valore resta in owed, con il motivo al posto del suo consiglio.
Dopo un import che scrive le proprie bozze, l’editor si offre di chiedere ogni valore ancora in sospeso in una casella di input dedicata, e invia le risposte in questo modo; dopo un’anteprima non offre nulla, poiché con --dry-run non viene chiesto nulla. Fornire i valori che un import lascia in sospeso descrive le domande.
Con --dry-run non viene chiesto nulla e non viene scritto nulla, file delle risposte incluso. Ogni valore dovuto viene comunque indicato sullo standard error, e lo stato di uscita è quello del dry run stesso.
Riesecuzione e --sync
aggrega import --sync legge lo stesso file delle risposte dell’import precedente: quello indicato da --answers, altrimenti quello indicato dal record accanto alle bozze, altrimenti quello predefinito accanto alla sorgente. Scrive ogni risposta nelle bozze al posto del valore vuoto e, dove il file delle risposte risponde a ogni valore dovuto, non chiede nulla.
Una volta che non è dovuto più nulla e il workspace non è offline, l’import esegue il pull delle dipendenze della Release in bozza come fa aggrega pull, scrivendo release.lock, così aggrega validate e aggrega build funzionano subito sulle bozze. Con --offline non viene eseguito alcun pull, e l’import indica il comando aggrega pull --release <path> da eseguire successivamente.
Un solo file delle risposte per più target
La stessa sorgente messa in bozza per target diversi può dovere valori diversi: la Release di Google ADK vista sopra, messa in bozza con --target compose, deve solo l’immagine, mentre la stessa Release messa in bozza con --target helm deve anche indicare da dove proviene la chiave API Gemini dell’agente. Un solo file delle risposte serve entrambi i casi:
- l’import aggiunge le chiavi dovute dalle sue bozze e imposta le risposte che riceve;
- una risposta per una chiave che queste bozze non devono viene mantenuta nel file e non applicata;
- ogni altra chiave e ogni commento nel file restano invariati.
Il file delle risposte viene letto solo dove le bozze devono qualche valore. Dove lo devono, una riga informativa sullo standard error indica ogni risposta mantenuta e non applicata — qui per l’import di Flowise generato con --target compose, che deve solo l’email del proprietario, leggendo un file delle risposte che indica anche i due Secret di Kubernetes che lo stesso import deve con --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 appliedDove le bozze non devono nulla — l’import di Langflow generato con --target compose, per esempio, che legge ogni segreto da una variabile — il file delle risposte non viene letto, nessuna riga del genere viene stampata e il file resta com’è.
Vedi anche
aggrega import— il riferimento del comando, con tutti i flag.- Import — cosa mette in bozza un import, e una guida passo passo per ogni formato sorgente.