Điều kiện tiên quyết
- Tài khoản AWS mà bạn có quyền tạo IAM role (hoặc IAM user, nếu dùng phương thức access key).
- Quyền dùng AWS CloudShell trong tài khoản đó. Script thiết lập chạy trong CloudShell nên bạn không cần cài gì.
- Với câu hỏi về chi phí và Optimize: Cost Explorer phải được bật trong tài khoản (Billing and Cost Management → Cost Explorer → Launch Cost Explorer, trong management account nếu dùng organization). AWS có thể cần tới 24 giờ để kích hoạt Cost Explorer trên tài khoản mới.
- Trong AWS Organization, hãy kiểm tra các service control policy (SCP). SCP chặn
sts:AssumeRoletừ principal bên ngoài sẽ chặn role, còn SCP chặn region sẽ ẩn các region đó khỏi agent. Từ management account, liệt kê SCP của tài khoản tại AWS Organizations → AWS accounts → tài khoản của bạn → Policies, hoặc chạyaws organizations list-policies-for-target --target-id <account-id> --filter SERVICE_CONTROL_POLICY. - Các region cần opt-in, như
ap-east-1hoặcme-south-1, sẽ vô hình với agent cho đến khi bạn bật chúng tại Account → AWS Regions trong AWS console.
Thiết lập
Trước tiên, mở hộp thoại kết nối: ở thanh bên, nhấn More → Workspace settings → Connections, chọn Amazon Web Services, rồi nhấn Connect. Sau đó làm theo tab tương ứng với phương thức bạn chọn ở đầu hộp thoại.- Role-Based (khuyến nghị)
- Access Keys
Hộp thoại sinh ra một External ID (mã định danh duy nhất gắn role của bạn với workspace CloudThinker này và ngăn lỗi confused deputy; AWS không coi đây là bí mật) và dựng script thiết lập dựa trên mã đó.Bạn muốn tự tạo role, chẳng hạn bằng Terraform hoặc CloudFormation? Mở rộng Manual steps trong hộp thoại. Mục này hiển thị trust policy đã điền sẵn External ID của bạn và principal của CloudThinker. Principal giống nhau cho mọi workspace. Chỉ External ID thay đổi theo từng hộp thoại. Với cách làm thủ công, bạn có thể đặt role bất kỳ tên nào, vì CloudThinker dùng ARN bạn dán vào. Cấu trúc như sau:Cùng role đó viết bằng Terraform, với hai giá trị truyền vào dưới dạng biến:Sao chép cả hai giá trị từ một hộp thoại đang mở, và giữ hộp thoại đó mở cho đến khi
1
Đặt tên tài khoản
Điền Alias (ví dụ
production) và Description (ví dụ Production AWS account, main workloads). Agent đọc phần mô tả để chọn đúng tài khoản. Default AWS region (optional) chỉ là điểm bắt đầu: agent có thể dùng bất kỳ region nào mà role truy cập được.2
Mở CloudShell
Nhấn Open CloudShell và đăng nhập vào tài khoản AWS bạn muốn kết nối.
3
Chạy script thiết lập
Để đọc script trước, nhấn View script trong hộp thoại. Sau đó nhấn Copy Script to Clipboard, dán vào CloudShell và nhấn Enter. Script sẽ:
Phần cuối kết quả trông như sau:
- Dừng lại nếu đã có role tên
CloudThinkerAccessRole. - Tạo
CloudThinkerAccessRolevới trust policy chỉ cho phép CloudThinker assume, và chỉ khi có External ID của bạn. - Gắn policy AWS managed
ReadOnlyAccess. - In ra ARN của role.
Toàn bộ script, để bạn xem trước khi chạy
Toàn bộ script, để bạn xem trước khi chạy
Hộp thoại điền sẵn External ID của bạn và principal của CloudThinker. Script cũng in các thông báo tiến trình, được lược bỏ ở đây.
4
Dán Role ARN và kết nối
Dán ARN vào AWS Role ARN. Giữ nguyên AWS External ID: trường này đã được điền sẵn và phải khớp với script. Nhấn Connect.Trạng thái thành công: trạng thái chuyển qua Connecting và Verifying, rồi tài khoản hiển thị trạng thái Connected. Lúc này Discovery chạy một lần ở chế độ nền và tiêu tốn credit. Hãy xem mục Discovery trên bảng chi tiết trước khi gửi prompt đầu tiên. Xem Điều gì xảy ra sau khi bạn kết nối.
5
Đặt môi trường
Mở Amazon Web Services trong More → Workspace settings → Connections, nhấn biểu tượng bút chì trên hàng của tài khoản, rồi đặt Environment trong Edit Instance. Trường này gắn nhãn tài khoản cho cả người dùng lẫn agent. Xem Đặt môi trường.
6
Đặt câu hỏi xác minh
Mở một cuộc chat và hỏi câu hỏi xác minh. Câu trả lời phải nêu đúng account ID 12 chữ số của bạn.
terraform apply hoàn tất và bạn đã dán kết quả role_arn vào AWS Role ARN.Hộp thoại không có giới hạn thời gian, nhưng External ID chỉ tồn tại trong tab trình duyệt đang mở đó. Đóng hộp thoại hoặc tải lại trang sẽ làm mất mã, và không có cách nào đưa External ID cũ vào hộp thoại mới. Đây là hạn chế với Terraform được review qua pull request, khi apply có thể chạy trong CI sau vài giờ: hãy giữ hộp thoại mở đến khi pipeline xong, hoặc mở hộp thoại mới và cập nhật External ID trong trust policy trước khi nhấn Connect.Kết nối thêm tài khoản
Mỗi tài khoản AWS là một kết nối riêng. Nhấn Connect lần nữa trên Amazon Web Services, đặt alias riêng cho tài khoản, rồi chạy script từ hộp thoại đó trong CloudShell của tài khoản mới. Luôn sao chép script từ đúng hộp thoại bạn đang hoàn tất, để trust policy mang External ID mà hộp thoại đó hiển thị. Hiện chưa hỗ trợ onboard hàng loạt. Mỗi hộp thoại sinh External ID riêng, nên một StackSet hay một lần Terraform apply không thể tạo role cho nhiều kết nối cùng lúc. Mỗi tài khoản cần hộp thoại riêng và role riêng. Với nhiều tài khoản, cách nhanh nhất là dùng module Terraform ở trên, apply một lần cho mỗi tài khoản với các giá trị từ hộp thoại đang mở của tài khoản đó. Để xem chi phí trên toàn AWS Organization, hãy kết nối management account. Kết nối này chỉ cung cấp cho Optimize dữ liệu chi phí toàn tổ chức. Agent chỉ thấy tài nguyên trong một member account thông qua kết nối riêng của tài khoản đó.Chi tiết kết nối
Environment (Production, Staging, Development hoặc Not set) không có trong hộp thoại kết nối. Hãy đặt sau khi kết nối, như ở bước thiết lập cuối: trường này gắn nhãn tài khoản cho cả người dùng lẫn agent. Rule phê duyệt không đọc trường này, nên Rule muốn áp dụng cho một tài khoản phải nêu tên kết nối đó.
Quyền yêu cầu
Script thiết lập gắn policy AWS managedReadOnlyAccess. Policy này cho phép agent describe và list tài nguyên trên các dịch vụ, đọc metric CloudWatch và đọc Cost Explorer. Policy không thể tạo, thay đổi hay xóa bất cứ thứ gì.
Để chuyển một role hiện có sang bộ quyền hẹp hơn, hãy chạy lệnh sau trong CloudShell:
read_only bằng attachment cho hai policy ARN đó và một aws_iam_role_policy chứa statement ce:Get*.
Khả năng của agent
Xác minh kết nối
Ví dụ prompt
Quyền ghi
Allow writes trên bảng chi tiết của kết nối quyết định agent có được thay đổi gì trong AWS hay không. Với AWS, tùy chọn này bật theo mặc định, nhưng role do script tạo là chỉ đọc, nên chính AWS sẽ từ chối mọi thao tác ghi cho đến khi bạn cấp thêm quyền.
Để khóa thao tác ghi ngay trong CloudThinker, mở Amazon Web Services trong More → Workspace settings → Connections và tắt công tắc Allow writes trên bảng chi tiết.
Khắc phục sự cố
Script báo CloudThinkerAccessRole đã tồn tại
Script báo CloudThinkerAccessRole đã tồn tại
Nguyên nhân: một lần thiết lập trước đó trong tài khoản này đã tạo role, nhiều khả năng với External ID khác.Cách khắc phục: nếu không có kết nối CloudThinker nào khác dùng role đó, hãy gỡ các policy của role và xóa role, rồi chạy script mới. Để kiểm tra một kết nối CloudThinker còn dùng role hay không, mở Event history của CloudTrail, lọc Event name =
delete-role sẽ thất bại cho đến khi mọi policy được gắn và inline policy đều bị gỡ, nên hãy liệt kê chúng trước:AssumeRole, rồi tìm các event gần đây trên CloudThinkerAccessRole có session name bắt đầu bằng cloudthinker-. Nếu còn kết nối dùng role, đừng thay External ID của role. Thay vào đó, dùng Manual steps để tạo role thứ hai với tên khác cho workspace này.Kiểm tra thất bại với AccessDenied trên sts:AssumeRole
Kiểm tra thất bại với AccessDenied trên sts:AssumeRole
Nguyên nhân: trust policy không khớp với thông tin CloudThinker gửi lên.Kiểm tra: ARN bạn dán đúng là ARN do script in ra, và
sts:ExternalId trong trust policy khớp chính xác với AWS External ID trong hộp thoại.Cách khắc phục: kiểm tra thất bại thì kết nối không được lưu. Sửa trust policy, rồi nhấn Connect lại trong chính hộp thoại đó để External ID giữ nguyên. Nếu bạn đã đóng hộp thoại, hãy chạy lại thiết lập từ một hộp thoại mới. Retry chỉ xuất hiện trên kết nối đã lưu và sau đó hiển thị Error.Kết nối hiển thị Error và các tác vụ theo lịch đã dừng
Kết nối hiển thị Error và các tác vụ theo lịch đã dừng
Nguyên nhân: ba lần liên tiếp thông tin xác thực thất bại khi chạy nền (role bị xóa, trust policy hỏng, hoặc key bị thu hồi) sẽ chuyển kết nối sang Error. Việc làm mới chi phí của Optimize, các automation theo lịch và việc thăm dò của Pulse tạm dừng cho kết nối đó, và admin của workspace nhận một thông báo.Cách khắc phục: sửa role hoặc key trong AWS, rồi nhấn Retry trên kết nối, hoặc Replace credentials để nhập key mới. Các tác vụ theo lịch chạy lại ở chu kỳ kế tiếp khi trạng thái trở về Connected.
Câu hỏi về chi phí không trả về dữ liệu
Câu hỏi về chi phí không trả về dữ liệu
Kiểm tra: Cost Explorer đã được bật trong AWS Billing console, và đã qua ít nhất 24 giờ kể từ khi bật. Với member account trong AWS Organizations, management account có thể chặn member account truy cập Cost Explorer.Cách khắc phục: bật Cost Explorer, hoặc kết nối management account để xem chi phí của toàn tổ chức.
Kiểm tra hiển thị Timed out
Kiểm tra hiển thị Timed out
Nguyên nhân: bài kiểm tra không hoàn tất kịp thời. Endpoint của AWS là công khai, nên hiếm khi lỗi nằm ở mạng của bạn.Cách khắc phục: kết nối lại. Nếu vẫn tiếp tục hết thời gian chờ, hãy liên hệ với chúng tôi.
Một region hoặc dịch vụ trả về AccessDenied với explicit deny
Một region hoặc dịch vụ trả về AccessDenied với explicit deny
Nguyên nhân: một service control policy đang chặn. Lỗi của AWS cho biết yêu cầu bị từ chối
with an explicit deny in a service control policy. Nếu SCP chặn sts:AssumeRole, chính bài kiểm tra kết nối sẽ thất bại.Kiểm tra: liệt kê các SCP trên tài khoản, như trong mục Điều kiện tiên quyết.Cách khắc phục: nhờ admin AWS Organizations miễn trừ CloudThinkerAccessRole khỏi SCP, hoặc chấp nhận rằng agent không thấy được region hay dịch vụ đó.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 dùng role. CloudThinker assume role qua AWS STS và nhận thông tin xác thực ngắn hạn, nên không có secret dài hạn nào có thể bị lộ. External ID ngăn người khác dùng role của bạn thông qua CloudThinker.
- Kiểm toán bằng CloudTrail. Mọi lệnh gọi của agent đều là lệnh gọi AWS API thông thường. CloudThinker đặt tên mỗi role session là
cloudthinker-<8 ký tự đầu của workspace ID>-<Unix timestamp>, và Event history của CloudTrail hiển thị session name đó ở cột User name. Để xem mọi lệnh gọi qua các session, lọc theouserIdentity.sessionContext.sessionIssuer.userName=CloudThinkerAccessRoletrong CloudTrail Lake hoặc Athena. Với access key, lọc Event history theo User name =CloudThinkerUser.
Liên quan
Bắt đầu nhanh với Optimize
Biến kết nối này thành các phát hiện về chi phí và đề xuất tiết kiệm.
Kết nối
Xoay vòng thông tin xác thực, đặt môi trường và đọc kết quả Discovery.
Approvals
Quyết định thay đổi nào cần người duyệt trước khi bạn cấp bất kỳ quyền ghi nào.