Chuyển đến nội dung chính
CloudThinker chạy AWS CLI trên tài khoản của bạn để trả lời các câu hỏi về compute, lưu trữ, danh tính, chi phí và giám sát. Bạn kết nối bằng IAM role mà CloudThinker assume để nhận thông tin xác thực ngắn hạn (khuyến nghị), hoặc bằng access key của một IAM user.

Đ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:AssumeRole từ 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ạy aws organizations list-policies-for-target --target-id <account-id> --filter SERVICE_CONTROL_POLICY.
  • Các region cần opt-in, như ap-east-1 hoặc me-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.
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ã đó.
Giữ hộp thoại mở cho đến khi bạn nhấn Connect. Đóng hộp thoại sẽ hủy External ID, và hộp thoại mới sẽ sinh một mã khác, nên role tạo từ mã cũ sẽ không khớp.
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ẽ:
  1. Dừng lại nếu đã có role tên CloudThinkerAccessRole.
  2. Tạo CloudThinkerAccessRole với trust policy chỉ cho phép CloudThinker assume, và chỉ khi có External ID của bạn.
  3. Gắn policy AWS managed ReadOnlyAccess.
  4. In ra ARN của role.
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.
Phần cuối kết quả trông như sau:
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.
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 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 managed ReadOnlyAccess. 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ì.
ReadOnlyAccess đọc được cả dữ liệu lẫn cấu hình, chẳng hạn object trong S3. Lựa chọn hẹp hơn là kết hợp AWS managed ViewOnlyAccess với SecurityAudit, cộng thêm quyền đọc ce:Get* cho Optimize. Bộ quyền này đủ để list và describe tài nguyên, nhưng không đọc được dữ liệu như nội dung object S3 hay log event. Thiếu quyền không bao giờ làm ngắt kết nối tài khoản: câu trả lời cần quyền đó sẽ thất bại với AccessDenied, kèm tên action bị thiếu, để bạn chỉ cần thêm đúng action đó vào inline policy.
Để 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:
Trong Terraform, thay attachment 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

Câu trả lời nêu đúng account ID 12 chữ số của bạn.

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ố

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. 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:
Để 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 = 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.
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.
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.
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.
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.
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 theo userIdentity.sessionContext.sessionIssuer.userName = CloudThinkerAccessRole trong 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.