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 →remote
ak secrets remote run
Chạy một chương trình trên một relay device đang trực tuyến của bạn với secret trong vault đặt vào môi trường, rồi in đầu ra đã che giá trị; không chạy gì cục bộ (bản xem trước).
Dùng ak secrets remote run trên một máy không được giữ secret, như sandbox
của Agent trên cloud. Lệnh gọi tool secrets_run của vault, và một relay device
đang trực tuyến của bạn chạy chương trình với các secret trong môi trường của
nó. Đầu ra trả về với mọi giá trị đã cấp phát được che đi. Hãy đăng nhập trước
bằng ak secrets remote login.
Bản xem trước
Endpoint vault từ xa đang ở giai đoạn tiền phát hành và có thể chưa dùng được với mọi tài khoản.
Cách dùng
ak secrets remote run --env VAR=REF... [flags] -- PROGRAM [ARGS...]ak secrets remote run --env GH_TOKEN=GITHUB_TOKEN -- gh release list
ak secrets remote run --project my-app --env DATABASE_URL=PROD_DB -- ./scripts/migrate-status.shChương trình và các argument của nó phải đứng sau --; nếu không, lệnh thoát
với mã 2.
Tuỳ chọn
| Cờ | Mặc định | Mô tả |
|---|---|---|
--env VAR=REF | Bắt buộc | Đưa secret REF cho chương trình dưới tên VAR. Lặp lại từ 1 đến 16 lần. |
--project string | Không có | Project đã đăng ký trên relay device để chạy trong đó. |
--vault-id string | Không có | Vault cần dùng khi các thiết bị trực tuyến giữ nhiều vault. |
--timeout int | Do thiết bị chọn | Số giây thiết bị cho chương trình chạy, từ 1 đến 110. |
--issuer string | https://agentkit.best, hoặc AGENTKIT_OAUTH_ISSUER | Origin của máy chủ cấp quyền. |
--vault-origin string | https://vault.agentkit.best | Origin của vault. |
Các cờ dùng chung nằm trong quy ước CLI.
Lệnh kiểm tra các giới hạn sau trước khi gửi bất cứ thứ gì, và thoát với mã 2
khi vi phạm một giới hạn:
- Từ 1 đến 64 argument của chương trình sau
--. - Từ 1 đến 16 cặp
--env. MỗiVARkhớp[A-Z_][A-Z0-9_]*, dài tối đa 128 byte và chỉ xuất hiện một lần. Mỗi cặp phải nêu một secret. --projectdài tối đa 128 ký tự.--timeout, khi được đặt, nằm trong khoảng 1 đến 110 giây.
Lệnh làm gì
Lệnh không chạy gì cục bộ. Lệnh gia hạn thông tin đăng nhập trong
AGENTKIT_HOME/state/vault-remote.json khi cần, rồi nhờ vault chuyển lần chạy
tới một thiết bị đang giữ kết nối relay bằng
ak secrets sync now --watch --relay.
Relay device chỉ chạy chương trình khi một exec grant mà thiết bị giữ cho client
này bao phủ mọi cặp VAR=REF. Thiết bị không bao giờ hỏi. Nếu không, thiết bị
tạo một yêu cầu trong hộp duyệt của nó và lệnh này thoát với mã 8. Duyệt yêu
cầu trên thiết bị đó bằng ak secrets approve hoặc hộp duyệt của AgentKit
Desktop, rồi chạy lại lệnh. Hãy duyệt mọi phạm vi mà một tác vụ cần trước khi
tác vụ bắt đầu.
Chương trình, các argument của nó và --project được phân giải trên relay
device, không phải trên máy này.
Đầu ra
Stdout và stderr của chương trình được in ra stdout và stderr của lệnh này, với các giá trị đã cấp phát được thiết bị che đi. Việc che chỉ xoá đúng các giá trị nguyên văn; đầu ra in một giá trị đã mã hoá, bị tách nhỏ hoặc chỉ một phần thì không bị phát hiện.
Trước khi in, lệnh xoá những gì terminal sẽ thực thi: chuỗi escape ANSI, ký tự điều khiển trừ tab, xuống dòng và carriage return, các byte không phải UTF-8 hợp lệ, và các ký tự override hoặc isolate hai chiều (bidi).
Nếu thiết bị đã cắt bớt đầu ra cho vừa câu trả lời, lệnh in thêm
secrets remote run: the device cut the output to fit its answer ra stderr.
Lệnh không có đầu ra JSON khi thành công, kể cả với --json. Với --json, một
lần thất bại in error envelope chuẩn ra stderr.
Kết quả và mã thoát
Lệnh thoát với mã thoát của chương trình. Khi chương trình thoát với mã khác 0,
lệnh in trước secrets remote run: the program exited N ra stderr, để mã 5,
6 hoặc 8 của chương trình không bị nhầm là một lần từ chối. Mã lớn hơn 255
được giới hạn ở 255.
Khi vault hoặc relay device từ chối lần chạy hoặc không hoàn tất được nó, lệnh thoát với:
| Mã | Ý nghĩa |
|---|---|
2 | Cờ hoặc argument không hợp lệ, hoặc vault thấy chúng không hợp lệ, hoặc cần --vault-id hay --vault-id không xác định. |
3 | Relay device không có secret nào theo một ref đã cho. |
5 | Chưa đăng nhập, không có relay device nào trực tuyến, thiết bị không trả lời kịp (khi đó không biết kết quả), hoặc vault không phục vụ được lần chạy. Khi không có thiết bị trực tuyến, thông báo yêu cầu khởi động ak secrets sync now --watch --relay trên một thiết bị giữ vault. |
6 | Relay device từ chối lần chạy, ví dụ không tìm thấy chương trình hoặc chương trình không được phép. |
8 | Không exec grant nào bao phủ lần chạy; một yêu cầu đang chờ ak secrets approve trên relay device. |
9 | Quá nhiều lời gọi; thử lại sau. Thông báo nêu số giây cần chờ khi vault gửi kèm. |