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.akvLệnh nhóm không nhận argument và không có cờ riêng.
Quy trình
-
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 recipientage1...được in ra. -
Niêm phong các secret mà job cần bằng
ak secrets bundle create, ghi cùng ranh giới đó vào--profilevà recipient vào--encrypt-for. Đưa file bundle tới nơi job đọc được. -
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.shJob đọc key từ
AK_CI_DECRYPT_KEY, trừ khi--key-envchỉ định biến khác, và từ chối bundle được tạo cho profile khác. Xem chế độ bundle trongak 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ệnh | Kết quả | Tác động lên đĩa |
|---|---|---|
ak secrets bundle keygen | Tạ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 create | Niê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 |
|---|---|
0 | Thành công. |
1 | Lệnh thất bại. |
2 | Cờ hoặc argument không hợp lệ. |
Trang của từng lệnh con liệt kê mã thoát riêng.