AgentKit
Tài liệuBộ kitTham chiếu CLIỨng dụng Desktop
BetaBạn đang đọc tài liệu kênh beta (3.2.0-beta.10). Tính năng có thể thay đổi trước bản stable tiếp theo.Chuyển sang stable →

bundle

ak secrets bundle create

Đọc một allowlist secret tường minh từ vault của thiết bị này và niêm phong chúng vào một CI bundle được mã hoá cho một ranh giới tin cậy.

Dùng ak secrets bundle create trên một thiết bị tin cậy để niêm phong các secret mà một CI job được bảo vệ cần vào một file mã hoá. Job giải mã file đó bằng ak secrets run --bundle. Vault có thể hỏi passphrase ở đây; trong CI không có gì hỏi cả.

Cách dùng

ak secrets bundle create --profile NAME --encrypt-for AGE_RECIPIENT --secret VAR=REF [--secret VAR=REF ...] --output FILE [flags]
ak secrets bundle create --profile ci-production --encrypt-for age1... --secret DEPLOY_TOKEN=${REF} --output ci-production.akv
ak secrets bundle create --profile ci-staging --encrypt-for age1... --secret A=${REF_A} --secret B=${REF_B} --output ci-staging.akv

Tuỳ chọn

CờMặc địnhMô tả
--profile NAMEBắt buộcNhãn ranh giới tin cậy lưu trong bundle, ví dụ ci-production. Từ 1 đến 64 ký tự thuộc a-z, 0-9, - hoặc _.
--encrypt-for AGE_RECIPIENTBắt buộcPublic age recipient (age1...) mà ak secrets bundle keygen đã in.
--secret VAR=REFBắt buộcĐưa secret đã lưu REF vào bundle, giao dưới biến môi trường VAR. Lặp lại được, tối đa 64 lần.
--output FILEBắt buộcFile bundle cần ghi, với mode 0600.
--backend <name>Từ AGENTKIT_SECRETS_BACKEND hoặc config.yaml, nếu không thì keychainStorage backend để đọc: keychain, file hoặc memory.
--unlock-with-recoveryfalseMở vault của file backend bằng recovery private key và đặt passphrase mới.

Các cờ dùng chung nằm trong quy ước CLI.

Lệnh làm gì

Việc chọn là một allowlist tường minh: chỉ các secret được --secret nêu tên mới được niêm phong, và không có chế độ export-all. Mỗi VAR phải là tên biến mà ak secrets run chấp nhận, và không VAR nào được xuất hiện hai lần, không phân biệt hoa thường. Mỗi giá trị phải khác rỗng và tối đa 16 KiB.

Lệnh đọc từng REF từ vault của thiết bị này và niêm phong các giá trị cho recipient của --encrypt-for. Bundle chỉ mang tên các VAR và giá trị của chúng, cùng profile và thời điểm tạo. Bundle không bao giờ mang grant, membership, device key, tài liệu khôi phục, tên ref hay bất kỳ metadata nào khác.

--profile đặt tên ranh giới tin cậy. ak secrets run --bundle từ chối bundle có profile khác với profile mà nó được báo là phải nhận, nên hãy dùng một bundle và một key cho mỗi ranh giới.

Lệnh ghi --output với mode 0600, thay file đã có ở đó và tạo các thư mục cha còn thiếu. Lệnh từ chối đích là symlink, thư mục, standard output hoặc terminal, nên bundle không bao giờ bị in ra.

Ai giữ bundle và key của nó đều đọc được mọi giá trị bên trong.

Đầu ra

Đầu ra text nêu file bundle, số secret và profile. JSON dùng kind=secrets.bundle.create với các trường sau dưới data:

out, count, profile

Đầu ra không bao giờ chứa giá trị secret.

Kết quả và mã thoát

MãÝ nghĩa
0Đã ghi bundle.
2Cờ, profile, recipient hoặc lựa chọn không hợp lệ, hoặc đích --output bị từ chối.
3Một secret được chọn không tồn tại.
5Không đọc được vault, hoặc không ghi được file.

Lệnh liên quan