File jawaban impor
Beberapa nilai tidak dapat dimuat oleh sumber mana pun: image aplikasi yang dibangun dari kode Anda sendiri, email akun pemilik, model yang tidak disebutkan oleh sumber, nama Secret Kubernetes. aggrega import membuat draf setiap nilai semacam itu sebagai string kosong, di bawah komentar yang menjelaskan apa nilai itu, dan mengambilnya dari Anda satu kali — dari file jawaban, atau dari pertanyaan di terminal. Jawaban disimpan di file jawaban, import-answers.yaml, sehingga setiap impor berikutnya dari sumber yang sama membacanya dari sana dan tidak menanyakan apa pun.
Halaman ini menjelaskan di mana file berada, apa isinya, bagaimana nilai-nilai masuk ke dalamnya, dan apa yang dilakukan impor saat suatu nilai masih belum ada. Kegunaan impor, serta panduan langkah demi langkah dari sumber hingga build, ada di Impor.
Nilai mana yang masih harus diisi
Setelah membuat draf, impor membaca setiap dokumen draf terhadap skemanya sendiri, dan terhadap skema katalog setiap Component, Feature, dan koneksi yang dideklarasikan dokumen tersebut. Suatu nilai masih harus diisi ketika nilai itu masih kosong di tempat skema tersebut mewajibkannya, atau di tempat skema mendeklarasikan kuncinya dan tidak ada yang menyediakannya. Setiap nilai yang masih harus diisi dijelaskan oleh deskripsi skema itu sendiri tentang kuncinya; jika skema tidak memberikannya, oleh komentar yang ditulis draf di atas kunci tersebut.
Selama masih ada nilai yang harus diisi, impor tidak menarik dependensi Release yang didrafkan; impor menariknya begitu setiap nilai telah dijawab (lihat Menjalankan ulang dan --sync).
Lokasi file
| Sumbernya adalah | File jawaban adalah |
|---|---|
| sebuah file | import-answers.yaml di direktori yang sama dengan file sumber |
| sebuah direktori | import-answers.yaml di dalam direktori sumber |
--answers <file> menunjuk file lain. Path relatif di-resolve terhadap direktori tempat Anda menjalankan perintah. Jika draf masih memerlukan nilai dan file jawaban bukan file default di samping sumber, catatan yang ditulis import di samping draf, .aggrega-import.json, menyebutkannya, sehingga aggrega import --sync berikutnya ke direktori yang sama membacanya tanpa perlu diberi tahu lagi. Catatan tersebut tidak pernah menyimpan jawaban.
Jawaban untuk sebuah rahasia adalah nama asal rahasia tersebut, tidak pernah rahasia itu sendiri (lihat Rahasia), sehingga file jawaban dapat disimpan bersama sumber di kontrol versi.
Isinya
File ini berformat YAML. Kunci tingkat atasnya adalah file draf, berdasarkan path tempat masing-masing dibuat. Di bawah masing-masing, sebuah kunci adalah path kunci bertitik dari nilai yang masih diperlukan di dalam dokumen tersebut, dan nilainya adalah jawabannya. Deskripsi kunci dari skema ditulis sebagai komentar di atasnya. Segmen path kunci yang kosong, atau berisi titik, spasi putih, atau tanda kutip, ditulis dalam tanda kutip ganda. File yang tidak terbaca dalam bentuk ini menghentikan import, dengan menyebutkan file dan alasannya, dan tidak ada yang ditulis.
Sebagai contoh, import Google ADK yang dibuat dengan --target helm memerlukan dua nilai dalam Release-nya: image agen yang Anda build dari proyek Anda, dan asal kunci API Gemini milik agen. Setelah keduanya dijawab, file jawaban di dalam direktori sumber support_agent/ berisi:
# 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"Kedua jawaban adalah milik Anda: ghcr.io/example/support-agent:1.0.0 mewakili image yang Anda build dan push, dan google-api-key mewakili nama Secret Kubernetes yang menyimpan kunci tersebut di namespace tujuan deploy Anda.
Setiap jawaban adalah satu nilai, dan import menuliskannya ke draf sebagai string, menggantikan nilai yang kosong, tanpa mengubah hal lain di draf. Jawaban yang ditulis ke dalam Aggregate hasil draf terbaca kembali persis seperti yang Anda ketik, termasuk {{. Jawaban kosong membiarkan nilai tetap diperlukan.
Cara nilai dimasukkan
Import menjawab setiap nilai yang diperlukan terlebih dahulu dari file jawaban. Untuk setiap nilai yang tidak dijawab oleh file, import menanyakannya kepada Anda, satu pertanyaan setiap kali — tetapi hanya jika input standar dan output standar keduanya adalah terminal, dan --dry-run tidak diberikan:
- setiap pertanyaan menyebutkan file draf dan path kunci, serta dirumuskan dari deskripsi skema;
- pertanyaan ditulis ke error standar, sehingga output standar hanya memuat hasil import;
- menekan Enter menunda nilai untuk nanti, dan mengakhiri input menghentikan pertanyaan.
Setiap jawaban yang Anda berikan ditulis ke dalam draf dan ke file jawaban, dan file jawaban disebutkan di antara file yang ditulis. Eksekusi yang tidak mengubah apa pun di file jawaban tidak menulisnya lagi.
Rahasia
Nilai rahasia — nilai yang ditandai sensitif oleh skemanya — dijawab dengan asal rahasia tersebut, tidak pernah dengan rahasia itu sendiri. Pertanyaannya menanyakan hal itu, dan jawabannya adalah salah satu nama berikut:
| Jawaban | Contoh |
|---|---|
| nama variabel | OPENAI_API_KEY |
| referensi ke variabel | ${OPENAI_API_KEY} |
| nama Kubernetes Secret | openai-api-key |
Impor memeriksa bahwa jawaban berbentuk salah satu nama ini, dan menolak yang lainnya:
- di terminal, jawaban ditolak, alasannya ditampilkan, dan pertanyaan diajukan lagi;
- di file jawaban, impor berhenti dengan menyebutkan file jawaban, file draf, dan kuncinya — tidak pernah jawabannya, yang mungkin merupakan rahasia itu sendiri — dan tidak menulis apa pun.
Pemeriksaan membaca bentuk jawaban, sehingga rahasia yang kebetulan terlihat seperti nama tidak dapat dibedakan dari nama. Rahasia itu sendiri tetap berada di tempat yang ditunjuk nama: di variabel, atau di Secret.
Tanpa terminal
Di integrasi berkelanjutan, melalui pipe, dan dari alat impor asisten (aggrega mcp), tidak ada yang ditanyakan, dan impor dari editor tidak menanyakan apa pun selama berjalan. Impor yang masih memiliki nilai terutang setelah file jawaban dibaca:
- menulis draf, dengan setiap nilai terutang dibiarkan kosong;
- menulis file jawaban dengan setiap kunci terutang ada dan jawabannya kosong;
- menyebutkan setiap nilai terutang di standard error, sebagai peringatan yang menyebutkan file draf, path kunci, dan deskripsinya;
- tidak menarik dependensi Release draf;
- keluar dengan status 1 dan satu kalimat yang menyatakan berapa banyak nilai yang terutang dan di mana menuliskannya:
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 againTulis setiap jawaban di samping kuncinya, lalu jalankan aggrega import <source> --sync ke direktori yang sama: perintah ini menyusun draf untuk target yang diberikan pada impor sebelumnya, menulis setiap jawaban ke dalam draf, dan tidak menanyakan apa pun. aggrega import biasa ke direktori yang sudah berisi Aggregate draf akan berhenti, menyebutkan --sync, dan tidak menulis apa pun. Impor ke direktori output baru juga membaca file jawaban: yang default, atau yang disebutkan oleh --answers.
Alat impor asisten menerima file jawaban sebagai answers, disebutkan relatif terhadap root workspace atau secara absolut. Panggilan yang masih memiliki nilai terutang gagal dengan kalimat tersebut dan membawa hasil impor, termasuk peringatannya, di sampingnya. Impor di editor juga menerima file jawaban, dan kalimat yang sama menutup diagnostiknya.
Keduanya juga mencantumkan setiap nilai yang masih terutang sebagai data, di bawah owed: file draf, jalur kunci sebagai daftar kunci, pertanyaannya, apakah nilai tersebut milik sebuah rahasia, dan untuk rahasia, apa yang harus menjadi jawabannya (secretAdvice dari editor, secret_advice dari alat impor asisten). Kirim kembali setiap jawaban di bawah answered — file draf, jalur kunci, dan jawabannya — bersama sync, dan impor akan memeriksanya, menyimpannya di file jawaban, dan menuliskannya ke dalam draf, sama seperti jawaban yang diketik di terminal. Jawaban rahasia yang bukan sebuah nama tidak disimpan maupun ditulis: nilainya tetap di owed, dengan alasannya menggantikan sarannya.
Setelah impor yang menulis drafnya, editor menawarkan untuk menanyakan setiap nilai yang masih belum dipenuhi dalam kotak input tersendiri, lalu mengirim jawabannya kembali dengan cara ini; setelah pratinjau, editor tidak menawarkan apa pun, karena di bawah --dry-run tidak ada yang ditanyakan. Menjawab nilai yang masih belum dipenuhi impor menjelaskan pertanyaan-pertanyaannya.
Dengan --dry-run, tidak ada yang ditanyakan dan tidak ada yang ditulis, termasuk file jawaban. Setiap nilai terutang tetap disebutkan di standard error, dan status keluarnya adalah status dry run itu sendiri.
Menjalankan ulang dan --sync
aggrega import --sync membaca file jawaban yang sama dengan impor sebelumnya: yang disebutkan oleh --answers, jika tidak, yang disebutkan oleh catatan di samping draf, jika tidak, yang default di samping sumber. Perintah ini menulis setiap jawaban ke draf sebagai pengganti nilai kosong, dan jika file jawaban menjawab setiap nilai terutang, tidak ada yang ditanyakan.
Setelah tidak ada lagi yang terutang dan workspace tidak sedang offline, impor menarik dependensi Release draf seperti yang dilakukan aggrega pull, dengan menulis release.lock, sehingga aggrega validate dan aggrega build langsung berfungsi pada draf. Dengan --offline, tidak ada yang ditarik, dan impor menyebutkan aggrega pull --release <path> yang perlu dijalankan berikutnya.
Satu file jawaban untuk beberapa target
Sumber yang sama yang didrafkan untuk target berbeda dapat memiliki nilai terutang yang berbeda: Release Google ADK di atas, yang didrafkan dengan --target compose, hanya memerlukan image, sedangkan Release yang sama yang didrafkan dengan --target helm juga memerlukan asal kunci API Gemini milik agen. Satu file jawaban melayani keduanya:
- impor menambahkan kunci yang diperlukan drafnya dan menetapkan jawaban yang diberikan kepadanya;
- jawaban untuk kunci yang tidak diperlukan draf ini tetap disimpan di file dan tidak diterapkan;
- setiap kunci dan komentar lain di file tetap apa adanya.
File jawaban hanya dibaca jika draf masih memerlukan suatu nilai. Jika demikian, sebuah baris informasi di standard error menyebutkan setiap jawaban yang disimpan dan tidak diterapkan — di sini untuk impor Flowise yang disusun dengan --target compose, yang hanya memerlukan email pemilik, saat membaca file jawaban yang juga menyebutkan dua Secret Kubernetes yang diperlukan impor yang sama dengan --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 appliedJika draf tidak memerlukan apa pun — misalnya impor Langflow yang disusun dengan --target compose, yang membaca setiap rahasia dari sebuah variabel — file jawaban tidak dibaca, tidak ada baris seperti itu yang dicetak, dan file dibiarkan apa adanya.
Lihat juga
aggrega import— referensi perintah, termasuk setiap flag.- Impor — apa yang didrafkan oleh impor, dan panduan langkah demi langkah untuk setiap format sumber.