Chuyển đến nội dung chính
Kết nối một tổ chức Fly.io để CloudThinker có thể liệt kê app, cho biết machine nào đang chạy hay đã dừng và chạy ở đâu, đồng thời rà soát kích thước và trạng thái gắn của volume trong một sự cố hoặc một đợt đánh giá dung lượng. Kết nối dùng token tổ chức chỉ đọc và không thể thay đổi gì: CloudThinker không bao giờ gửi thay đổi đến Fly.io, và chính Fly.io cũng từ chối các thay đổi thực hiện bằng token này.

​
Điều kiện tiên quyết

  • Một tổ chức Fly.io chứa các app bạn muốn kiểm tra.
  • CLI flyctl (cài đặt), đã đăng nhập bằng fly auth login với tư cách thành viên của tổ chức đó.
  • Một workspace CloudThinker mà bạn có quyền thêm kết nối.
Mỗi token chỉ đọc chỉ áp dụng cho một tổ chức. Nếu app của bạn nằm ở nhiều tổ chức, hãy tạo một token và một kết nối cho mỗi tổ chức.

​
Thiết lập

1

Tạo token tổ chức chỉ đọc

Chạy lệnh này trong terminal:
720h là 30 ngày. Luôn truyền --expiry: token Fly.io mặc định có thời hạn 20 năm. Nếu bạn thuộc nhiều tổ chức, thêm --org <slug> để chọn đúng tổ chức. Chạy fly orgs list để xem các slug.Sao chép toàn bộ giá trị lệnh in ra, bao gồm cả tiền tố FlyV1 (ví dụ FlyV1 fm2_...).Ghi ngày hết hạn vào lịch của bạn. Sau ngày đó, các prompt sẽ thất bại với lỗi xác thực được nêu trong Khắc phục sự cố.Nếu làm mất token, hãy tìm id của token bằng fly tokens list, thu hồi bằng fly tokens revoke <token-id>, rồi tạo token mới.
2

Thêm kết nối trong CloudThinker

Trên thanh bên, nhấn More → Workspace settings → Connections. Ở tab Builtin Connections, tìm Fly.io, dán token vào Access token và nhấn Connect. CloudThinker dùng token để liệt kê các tổ chức nhằm kiểm tra token.Trạng thái thành công: thẻ Fly.io hiển thị trạng thái Connected.
3

Chạy prompt xác minh

Chạy prompt xác minh trong một cuộc chat mới.Trạng thái thành công: CloudThinker liệt kê các tổ chức của bạn và app của chúng.

​
Chi tiết kết nối

Không cần nhập slug tổ chức hay region. CloudThinker đọc tổ chức từ token.

​
Quyền yêu cầu

Loại token chính là mô hình phân quyền. fly tokens create readonly tạo một token chỉ có thể đọc một tổ chức và tài nguyên của nó. Token không thể deploy, scale, khởi động lại hay hủy bất cứ thứ gì, và Fly.io không cung cấp phạm vi chi tiết hơn.
Đừng dùng fly tokens create org hoặc token xác thực cá nhân thay thế. Cả hai đều có thể thay đổi tổ chức của bạn, và kết nối này không cần quyền đó.

​
Khả năng của agent

Mọi khả năng đều là thao tác đọc, nên không có gì trên kết nối này yêu cầu phê duyệt. Danh sách mặc định hiển thị 25 dòng và cho biết đã ẩn bao nhiêu dòng. Hãy yêu cầu xem rộng hơn (tối đa 100) khi cần. Kết nối này không thể truy cập:

​
Cách đọc kết quả

Trạng thái app và trạng thái machine đến từ control plane của Fly.io. Chúng không phải là health check.
  • Machine started không có nghĩa là app của bạn phản hồi request.
  • Machine stopped không phải là lỗi. Fly.io dừng các machine có cấu hình autostop.
  • Machine đã dừng vẫn giữ volume gắn với nó, và Fly.io tính phí volume trong cả hai trường hợp. Volume đang gắn chưa chắc đã được dùng, còn volume chưa gắn thì đáng kiểm tra, vì bạn vẫn trả tiền cho volume đó dù không có machine nào dùng.
  • App không có machine nào là app chưa từng được deploy. Đó là một tên được giữ chỗ, không phải lỗi.

​
Xác minh kết nối

​
Ví dụ prompt

​
Khắc phục sự cố

Token bị thiếu, không hợp lệ hoặc đã hết hạn. Tạo token mới bằng fly tokens create readonly. Sau đó mở kết nối, nhấn biểu tượng chỉnh sửa trên instance, nhấn Replace… trong Edit Instance, dán token và nhấn Save and test.
Tên app sai, hoặc app thuộc một tổ chức mà token này không đọc được. Yêu cầu CloudThinker liệt kê app của bạn và dùng một tên trong danh sách đó.
Token không có quyền với tài nguyên đó. Kiểm tra xem bạn đã tạo token cho tổ chức sở hữu app và token chưa hết hạn hay không.
Fly.io đã từ chối hoặc không thể trả lời lệnh gọi đó, nên CloudThinker báo một khoảng trống thay vì một con số. Hãy coi mục đó là chưa biết, không phải bằng không.
Đó là hành vi mong đợi. Kết nối này chỉ đọc. Hãy yêu cầu lệnh fly chính xác và tự chạy.

​
Bảo mật

  • Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
  • Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
  • Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
  • Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
  • Chỉ đọc ở phía Fly.io: token không thể thực hiện thay đổi, nên nếu bị lộ, token chỉ làm lộ quyền đọc đối với một tổ chức và không gì hơn.
  • Thời hạn ngắn, thu hồi khi xong việc: liệt kê token bằng fly tokens list và thu hồi bằng fly tokens revoke <token-id> khi công việc hoàn tất.

​
Liên quan

Kết nối Render

Kết nối một nền tảng app khác, có log và deploy cần phê duyệt

Tổng quan kết nối

Xem mọi nền tảng bạn có thể kết nối và cách kết nối hoạt động