Tệp câu trả lời nhập
Có những giá trị mà không nguồn nào có thể chứa: image của một ứng dụng được build từ mã của chính bạn, email của một tài khoản chủ sở hữu, một mô hình mà nguồn không nêu tên, tên của một Secret Kubernetes. aggrega import soạn nháp mỗi giá trị như vậy thành một chuỗi rỗng, bên dưới một chú thích cho biết nó là gì, và lấy nó từ bạn một lần — từ tệp câu trả lời, hoặc từ một câu hỏi tại terminal. Các câu trả lời được giữ trong tệp câu trả lời, import-answers.yaml, nên mọi lần nhập sau đó của cùng một nguồn đều đọc chúng từ đó và không hỏi gì.
Trang này mô tả tệp nằm ở đâu, chứa gì, các giá trị đi vào nó như thế nào, và lệnh nhập làm gì khi một giá trị vẫn còn thiếu. Mục đích của việc nhập, cùng các hướng dẫn từng bước từ một nguồn đến một bản build, có trong Nhập.
Những giá trị còn thiếu
Sau khi soạn nháp, lệnh nhập đối chiếu mọi tài liệu nháp với schema của chính nó, và với schema danh mục của mỗi Component, Feature và kết nối mà tài liệu khai báo. Một giá trị còn thiếu khi nó vẫn rỗng ở nơi schema đó yêu cầu một giá trị, hoặc ở nơi schema khai báo khóa mà không có gì cung cấp nó. Mỗi giá trị còn thiếu được mô tả bằng chính mô tả của schema về khóa của nó; nơi schema không đưa ra mô tả nào, thì bằng chú thích mà bản nháp ghi phía trên khóa.
Khi vẫn còn giá trị còn thiếu, lệnh nhập không kéo các phụ thuộc của Release đã soạn nháp; nó kéo chúng ngay khi mọi giá trị đã được trả lời (xem Chạy lại và --sync).
Vị trí của tệp
| Nguồn là | Tệp câu trả lời là |
|---|---|
| một tệp | import-answers.yaml trong cùng thư mục với tệp nguồn |
| một thư mục | import-answers.yaml bên trong thư mục nguồn |
--answers <file> chỉ định một tệp khác. Đường dẫn tương đối được phân giải theo thư mục mà bạn chạy lệnh. Khi các bản nháp còn thiếu giá trị và tệp câu trả lời không phải tệp mặc định bên cạnh nguồn, bản ghi mà lệnh import ghi bên cạnh các bản nháp, .aggrega-import.json, sẽ nêu tên tệp đó, để một lần chạy aggrega import --sync sau đó vào cùng thư mục đọc được tệp mà không cần chỉ định lại. Bản ghi không bao giờ chứa câu trả lời.
Câu trả lời cho một bí mật là tên của nơi cung cấp bí mật, không bao giờ là chính bí mật đó (xem Bí mật), vì vậy tệp câu trả lời có thể được lưu cùng với nguồn trong hệ thống quản lý phiên bản.
Nội dung của tệp
Tệp có định dạng YAML. Các khóa cấp cao nhất là các tệp được soạn nháp, theo đường dẫn mà mỗi tệp được soạn nháp tại đó. Bên dưới mỗi khóa, một khóa là đường dẫn khóa phân cách bằng dấu chấm của một giá trị còn thiếu trong tài liệu đó, và giá trị của nó là câu trả lời. Mô tả của schema cho khóa được ghi thành chú thích phía trên khóa. Một đoạn đường dẫn khóa trống, hoặc chứa dấu chấm, khoảng trắng hay dấu ngoặc kép, được viết trong dấu ngoặc kép. Một tệp không đọc được theo cấu trúc này sẽ dừng lệnh import, nêu tên tệp và lý do, và không có gì được ghi.
Ví dụ, import Google ADK được soạn nháp với --target helm còn thiếu hai giá trị trong Release của nó: image của agent mà bạn build từ dự án của mình, và nơi cung cấp khóa API Gemini của agent. Khi cả hai đã được trả lời, tệp câu trả lời bên trong thư mục nguồn support_agent/ có nội dung:
# 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"Cả hai câu trả lời là của bạn: ghcr.io/example/support-agent:1.0.0 đại diện cho image mà bạn build và push, còn google-api-key đại diện cho tên của Secret Kubernetes chứa khóa trong namespace mà bạn triển khai vào.
Mỗi câu trả lời là một giá trị, và lệnh import ghi nó vào bản nháp dưới dạng chuỗi, thay cho giá trị trống, không thay đổi gì khác trong bản nháp. Một câu trả lời được ghi vào một Aggregate được soạn nháp sẽ được đọc lại đúng như bạn đã gõ, kể cả {{. Một câu trả lời trống khiến giá trị vẫn còn thiếu.
Cách các giá trị được điền vào
Lệnh import trước tiên trả lời từng giá trị còn thiếu từ tệp câu trả lời. Với mỗi giá trị mà tệp chưa trả lời, nó hỏi bạn, mỗi lần một câu hỏi — nhưng chỉ khi cả đầu vào chuẩn và đầu ra chuẩn đều là terminal, và --dry-run không được chỉ định:
- mỗi câu hỏi nêu tên tệp được soạn nháp và đường dẫn khóa, và được diễn đạt từ mô tả của schema;
- các câu hỏi được ghi vào luồng lỗi chuẩn, để đầu ra chuẩn chỉ chứa kết quả của lệnh import;
- nhấn Enter để lại giá trị cho sau, và kết thúc đầu vào sẽ dừng việc hỏi.
Mọi câu trả lời bạn đưa ra đều được ghi vào các bản nháp và vào tệp câu trả lời, và tệp câu trả lời được nêu trong số các tệp đã ghi. Một lần chạy không thay đổi gì trong tệp câu trả lời sẽ không ghi lại tệp đó.
Bí mật
Giá trị của một bí mật — giá trị mà lược đồ của nó đánh dấu là nhạy cảm — được trả lời bằng nơi bí mật đến từ đó, không bao giờ bằng chính bí mật. Câu hỏi của nó hỏi điều đó, và câu trả lời là một trong các tên sau:
| Câu trả lời | Ví dụ |
|---|---|
| tên biến | OPENAI_API_KEY |
| tham chiếu đến một biến | ${OPENAI_API_KEY} |
| tên của một Kubernetes Secret | openai-api-key |
Quá trình nhập kiểm tra rằng câu trả lời có dạng của một trong các tên này, và từ chối mọi thứ khác:
- tại terminal, câu trả lời bị từ chối, lý do được hiển thị và câu hỏi được hỏi lại;
- trong tệp câu trả lời, quá trình nhập dừng lại, nêu tên tệp câu trả lời, tệp bản nháp và khóa — không bao giờ nêu câu trả lời, vì đó có thể chính là bí mật — và không ghi gì cả.
Việc kiểm tra đọc dạng của câu trả lời, nên một bí mật tình cờ trông giống một tên sẽ không được phân biệt với một tên. Bản thân bí mật vẫn nằm ở nơi tên trỏ đến: trong biến, hoặc trong Secret.
Khi không có terminal
Trong tích hợp liên tục, qua một pipe và từ công cụ nhập của trợ lý (aggrega mcp), không có gì được hỏi, và lần nhập của trình soạn thảo không hỏi gì trong khi chạy. Một lần nhập vẫn còn thiếu giá trị sau khi đã đọc tệp câu trả lời sẽ:
- ghi các bản nháp, để trống mỗi giá trị còn thiếu;
- ghi tệp câu trả lời với mọi khóa còn thiếu có mặt và câu trả lời của nó để trống;
- nêu tên mỗi giá trị còn thiếu trên standard error, dưới dạng cảnh báo nêu tệp bản nháp, đường dẫn khóa và mô tả của nó;
- không kéo các phụ thuộc của Release bản nháp;
- thoát với trạng thái 1 và một câu cho biết còn thiếu bao nhiêu giá trị và cần ghi chúng ở đâu:
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 againGhi mỗi câu trả lời bên cạnh khóa của nó, rồi chạy aggrega import <source> --sync vào cùng thư mục: lệnh này soạn bản nháp cho đích đã được chỉ định cho lần nhập trước, ghi từng câu trả lời vào các bản nháp và không hỏi gì cả. Một lệnh aggrega import thông thường vào thư mục đã chứa Aggregate bản nháp sẽ dừng lại, nêu --sync, và không ghi gì cả. Một lần nhập vào thư mục đầu ra mới cũng đọc tệp câu trả lời: tệp mặc định, hoặc tệp mà --answers chỉ định.
Công cụ nhập của trợ lý nhận tệp câu trả lời qua answers, được chỉ định tương đối với thư mục gốc của workspace hoặc tuyệt đối. Một lời gọi vẫn còn thiếu giá trị sẽ thất bại với câu đó và kèm theo kết quả của lần nhập, bao gồm cả các cảnh báo, bên cạnh nó. Lệnh nhập của trình soạn thảo cũng nhận tệp câu trả lời, và cùng câu đó khép lại phần chẩn đoán của nó.
Cả hai cũng liệt kê mỗi giá trị vẫn còn thiếu dưới dạng dữ liệu, dưới owed: tệp bản nháp, đường dẫn khóa dưới dạng danh sách các khóa, câu hỏi, giá trị đó có phải của một bí mật hay không, và với một bí mật thì câu trả lời của nó phải là gì (secretAdvice từ trình soạn thảo, secret_advice từ công cụ nhập của trợ lý). Gửi lại mỗi câu trả lời dưới answered — tệp bản nháp, đường dẫn khóa và câu trả lời — kèm sync, và lần nhập sẽ kiểm tra nó, giữ nó trong tệp câu trả lời và ghi nó vào các bản nháp, giống như với một câu trả lời được gõ tại terminal. Câu trả lời của một bí mật mà không phải là một tên thì không được giữ lại cũng không được ghi: giá trị vẫn nằm trong owed, với lý do thay cho lời khuyên của nó.
Sau một lần nhập ghi các bản nháp của nó, trình soạn thảo đề nghị hỏi từng giá trị còn thiếu trong một ô nhập riêng, và gửi lại các câu trả lời theo cách này; sau một bản xem trước, nó không đề nghị gì, vì không có gì được hỏi khi dùng --dry-run. Trả lời các giá trị mà một lần nhập vẫn còn thiếu mô tả các câu hỏi.
Với --dry-run, không có gì được hỏi và không có gì được ghi, kể cả tệp câu trả lời. Mỗi giá trị còn thiếu vẫn được nêu trên standard error, và trạng thái thoát là trạng thái của chính lần chạy thử.
Chạy lại và --sync
aggrega import --sync đọc cùng tệp câu trả lời như lần nhập trước đó: tệp mà --answers chỉ định, nếu không thì tệp mà bản ghi bên cạnh các bản nháp chỉ định, nếu không nữa thì tệp mặc định bên cạnh nguồn. Lệnh này ghi mỗi câu trả lời vào các bản nháp thay cho giá trị trống, và khi tệp câu trả lời trả lời mọi giá trị còn thiếu thì không hỏi gì cả.
Khi không còn thiếu gì và workspace không ở chế độ ngoại tuyến, quá trình nhập kéo các phụ thuộc của Release bản nháp như aggrega pull làm, ghi release.lock, nhờ đó aggrega validate và aggrega build hoạt động ngay trên các bản nháp. Với --offline, không có gì được kéo, và quá trình nhập nêu lệnh aggrega pull --release <path> cần chạy tiếp theo.
Một tệp câu trả lời cho nhiều mục tiêu
Cùng một nguồn được soạn nháp cho các mục tiêu khác nhau có thể thiếu các giá trị khác nhau: Release Google ADK ở trên, khi soạn nháp với --target compose, chỉ thiếu image, còn cùng Release đó khi soạn nháp với --target helm thì còn thiếu cả nơi khóa API Gemini của agent đến từ đó. Một tệp câu trả lời phục vụ cả hai:
- quá trình nhập thêm các khóa mà bản nháp của nó cần và đặt các câu trả lời mà nó nhận được;
- câu trả lời cho một khóa mà các bản nháp này không cần sẽ được giữ trong tệp và không được áp dụng;
- mọi khóa và chú thích khác trong tệp vẫn giữ nguyên.
Tệp câu trả lời chỉ được đọc khi các bản nháp còn thiếu giá trị nào đó. Khi đó, một dòng thông tin trên standard error nêu từng câu trả lời được giữ lại và không được áp dụng — ở đây là cho lần nhập Flowise được soạn với --target compose, vốn chỉ thiếu email của chủ sở hữu, khi đọc một tệp câu trả lời cũng nêu tên hai Secret Kubernetes mà cùng lần nhập đó cần với --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 appliedKhi các bản nháp không thiếu gì — chẳng hạn lần nhập Langflow được soạn với --target compose, vốn đọc mọi bí mật từ một biến — tệp câu trả lời không được đọc, không có dòng nào như vậy được in ra, và tệp được giữ nguyên.
Xem thêm
aggrega import— tài liệu tham khảo của lệnh, bao gồm mọi cờ.- Nhập — những gì một lần nhập soạn nháp, và hướng dẫn từng bước cho mỗi định dạng nguồn.