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

Niêm phong một allowlist secret tường minh vào CI bundle được mã hoá, để một CI job được bảo vệ giải mã bằng key riêng của nó.

Dùng ak secrets bundle trên thiết bị tin cậy của bạn để đưa cho một CI job được bảo vệ đúng vài secret mà nó cần. Bạn niêm phong các giá trị đã chọn vào một file bằng một CI key riêng, và job giải mã file đó cục bộ bằng ak secrets run --bundle. Job không cần truy cập cloud và không có bước tương tác nào. Chạy lệnh nhóm không kèm lệnh con sẽ in help.

Cách dùng

ak secrets bundle <command>
ak secrets bundle keygen --key-out ./ci-production.key
ak secrets bundle create --profile ci-production --encrypt-for age1... --secret DEPLOY_TOKEN=${REF} --output ci-production.akv

Lệnh nhóm không nhận argument và không có cờ riêng.

Quy trình

  1. Tạo một key cho mỗi ranh giới tin cậy (trust boundary), ví dụ production tách khỏi staging, bằng ak secrets bundle keygen. Nạp file key vào kho secret của môi trường CI được bảo vệ, rồi xoá file. Giữ lại recipient age1... được in ra.

  2. Niêm phong các secret mà job cần bằng ak secrets bundle create, ghi cùng ranh giới đó vào --profile và recipient vào --encrypt-for. Đưa file bundle tới nơi job đọc được.

  3. Trong job, chạy đúng một chương trình cần các giá trị đó:

    ak secrets run --bundle ci-production.akv --profile ci-production -- ./deploy.sh

    Job đọc key từ AK_CI_DECRYPT_KEY, trừ khi --key-env chỉ định biến khác, và từ chối bundle được tạo cho profile khác. Xem chế độ bundle trong ak secrets run.

Đừng bao giờ dùng lại passphrase của vault cá nhân, recovery key hay device key làm CI key.

Bundle không phải là gì

Bundle không phải cloud sync, và key của nó là toàn bộ quyền truy cập:

  • Ai giữ bundle và key của nó đều đọc được mọi giá trị bên trong.
  • Nhà cung cấp CI giữ key.
  • Runner thấy plaintext trong lúc job chạy.
  • Một bản sao bundle không thể bị thu hồi từ xa. Để cắt quyền truy cập, hãy rotate các secret mà nó mang tại nhà cung cấp của chúng.

Bundle chỉ mang tên biến và giá trị bạn đã chọn, không bao giờ mang grant, membership, device key, tài liệu khôi phục, tên ref trong vault hay metadata khác.

Lệnh con

LệnhKết quảTác động lên đĩa
ak secrets bundle keygenTạo một CI key giải mã riêng và in public recipient của nó.Ghi một file key mới với mode 0600.
ak secrets bundle createNiêm phong các secret đã chọn cho một CI recipient.Ghi file bundle với mode 0600.

Mỗi lệnh con chỉ ghi đúng file được chỉ định.

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

MãÝ nghĩa
0Thành công.
1Lệnh thất bại.
2Cờ hoặc argument không hợp lệ.

Trang của từng lệnh con liệt kê mã thoát riêng.

Lệnh liên quan