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
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
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.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
Ví dụ prompt
Khắc phục sự cố
Connect fails with Failed to connect to AWX
Connect fails with Failed to connect to AWX
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.Yêu cầu trả về 401
Yêu cầu trả về 401
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.
Chạy job hoặc đồng bộ bị từ chối
Chạy job hoặc đồng bộ bị từ chối
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.
Danh sách trả về trống
Danh sách trả về trống
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.
Extra variables bị bỏ qua khi chạy job
Extra variables bị bỏ qua khi chạy job
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.
Output của job trống
Output của job trống
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.