Chuyển đến nội dung chính
Kết nối AWX để agent CloudThinker tìm job thất bại và đọc output, kiểm tra inventory, host và project, và chạy job template sau khi được phê duyệt. Kết nối đăng nhập bằng một access token của AWX và chạy công cụ dòng lệnh awx trên server của bạn.

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

  • AWX server, hoặc controller của Ansible Automation Platform, mà CloudThinker truy cập được qua HTTPS. Với server trong mạng riêng, xem Tiếp cận dịch vụ trong mạng riêng.
  • Một user AWX dành cho CloudThinker, có quyền truy cập các organization, inventory và template mà agent cần dùng.

Thiết lập

1

Tạo user cho CloudThinker

Trong AWX, tạo một user như cloudthinker và chỉ gán role trên những tài nguyên agent cần (xem Quyền yêu cầu). User riêng giúp phạm vi của token nhỏ và dễ thu hồi.
2

Tạo access token

Đăng nhập bằng user đó. Mở menu user, chọn User Details, vào tab Tokens và nhấn Add:
  • Application: để trống
  • Scope: Read nếu chỉ giám sát, hoặc Write nếu agent cần chạy và thay đổi tài nguyên
Sao chép token. AWX chỉ hiển thị token một lần. Token hết hạn sau khoảng thời gian đặt trong thiết lập OAuth 2 của AWX, nên hãy ghi lại ngày hết hạn và tạo token mới trước thời điểm đó.
3

Thêm kết nối trong CloudThinker

Mở More → Workspace settings → Connections, giữ nguyên tab Builtin Connections và chọn AWX. Điền:
  • TOWER_HOST: địa chỉ AWX của bạn, ví dụ https://awx.example.com
  • TOWER_OAUTH_TOKEN: token bạn vừa sao chép
Nhấn Connect. CloudThinker chạy awx me bằng token này để xác nhận đăng nhập được.Trạng thái thành công: hộp thoại đóng lại và kết nối hiển thị Connected. Chạy prompt xác minh bên dưới.

Chi tiết kết nối

Quyền yêu cầu

Hai yếu tố quyết định agent làm được gì: scope của token và role của user trong AWX. Token không bao giờ làm được nhiều hơn user. Với token Write, role của user là giới hạn trên, và Approvals quyết định từng thao tác trong giới hạn đó. Để chặn mọi thao tác ghi cả phía CloudThinker, tắt công tắc Allow writes trên bảng chi tiết của kết nối AWX.
Bắt đầu với token Read. Chỉ chuyển sang Write cho những template bạn muốn agent chạy, và cấp Execute theo từng template thay vì một role rộng ở cấp organization.

Khả năng của agent

Mọi thao tác ghi đều đi qua Approvals, và yêu cầu bị từ chối sẽ không được thử lại. Với token Read, AWX từ chối thao tác ghi ngay cả khi đã được phê duyệt.

Xác minh kết nối

Kết quả mong đợi gồm user mà CloudThinker dùng để đăng nhập, tên và số lượng của từng loại tài nguyên, rồi các job gần đây với trạng thái như successful hoặc failed.

Ví dụ prompt

Dùng đúng tên template, inventory hoặc project. Agent tra cứu tên trước và không đoán ID.

Khắc phục sự cố

CloudThinker không chạy được awx me với TOWER_HOST. Hộp thoại hiển thị cùng một thông báo cho cả trường hợp không truy cập được server lẫn token sai, nên hãy kiểm tra cả hai. Trước hết, mở TOWER_HOST trong trình duyệt từ bên ngoài mạng của bạn: trang phải tải được qua HTTPS. Nếu tải được, token đã hết hạn hoặc bị thu hồi. Tạo token mới, sửa kết nối và dán token vào.
Token bị thiếu, đã hết hạn hoặc bị thu hồi. Tạo token mới cho user CloudThinker và cập nhật TOWER_OAUTH_TOKEN.
Token có scope Read, hoặc user thiếu Execute trên template hay Update trên project. Tạo token Write hoặc cấp role trong AWX, rồi hỏi lại.
User không nhìn thấy các tài nguyên đó. Cấp Read trên các organization hoặc inventory mà agent cần truy cập. Không cần kết nối lại; role có hiệu lực từ yêu cầu tiếp theo.
AWX bỏ extra variables trừ khi template cho phép. Sửa job template, bật Prompt on launch cho Variables, rồi chạy lại.
AWX chỉ trả output sau khi job kết thúc. Hỏi lại khi job có trạng thái successful hoặc failed.

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.
  • Ưu tiên scope Read: chỉ dùng token Write khi agent cần chạy hoặc thay đổi tài nguyên, và giới hạn role của user trong các template đó.
  • Chỉ dùng HTTPS: luôn dùng TOWER_HOST dạng HTTPS. HTTP thường gửi token dưới dạng văn bản rõ.

Liên quan

Approvals

Quyết định những lượt chạy AWX nào phải chờ người duyệt.

Automation

Chạy kiểm tra AWX theo lịch, ví dụ báo cáo job thất bại hằng ngày.