Chuyển đến nội dung chính
Kết nối Git provider một lần, chọn các kho cần theo dõi, và mọi pull request (PR) hoặc merge request (MR) mới trong các kho đó đều được review mà không cần kích hoạt thủ công. Mới dùng Review? Hãy đọc tổng quan trước.

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

  • Một workspace CloudThinker mà bạn là Admin của workspace. Developer và Viewer xem được review nhưng không chạy được thiết lập. Xem vai trò.
  • Tài khoản GitHub, GitLab, Bitbucket Cloud, Azure DevOps hoặc AWS CodeCommit có quyền cài app, tạo access token hoặc tạo IAM role cho các kho bạn muốn review.
  • Khoảng mười phút. GitLab, Azure DevOps và CodeCommit cần thêm một bước cấu hình webhook.
  • Chỉ với GitLab tự host: CloudThinker phải truy cập được URL GitLab của bạn qua HTTPS, và instance GitLab phải truy cập được URL webhook mà trình hướng dẫn hiển thị.
Mỗi workspace kết nối một Git provider. Nếu nhóm bạn dùng hai provider, hãy thiết lập Review trong một workspace riêng cho từng provider.

Kết nối provider và kho

1

Mở Review

Nhấn Review trong thanh điều hướng bên trái. Trước khi thiết lập, trang hiển thị Review smarter. Ship faster.
2

Bắt đầu trình hướng dẫn thiết lập

Nhấn Get Started with Review. Hộp thoại Review Setup mở ra với các bước: Provider, Connect, Events, Repositories và Learnings. GitHub và Bitbucket bỏ qua bước Events vì webhook của hai provider này tự đăng ký.
3

Chọn provider

Trong Review Provider, chọn GitLab, GitHub, Bitbucket, Azure DevOps hoặc AWS CodeCommit, rồi nhấn Next.
4

Kết nối tài khoản

Xác thực theo cách provider của bạn hỗ trợ:Chưa biết chọn cách nào? Khi thiết lập cho cả nhóm, hãy dùng access token cấp project, group, workspace hoặc repository để bình luận đến từ một bot user. Dùng OAuth khi muốn thử nhanh trên GitLab.com hoặc Bitbucket. Xác thực provider có đầy đủ scope và các bước cho từng cách.
Access token và PAT có hạn dùng. Hãy ghi lại ngày hết hạn khi tạo, và thay token trước ngày đó bằng Update token.
Trạng thái thành công: hộp thoại hiển thị Connected và chuyển sang bước tiếp theo.
5

Thêm webhook (GitLab, Azure DevOps, CodeCommit)

Bước Events cho biết cần thiết lập gì, sau đó bạn nhấn Mark as Configured:
  • GitLab và Azure DevOps: thêm URL và Secret token của webhook vào provider, kèm các trigger mà bước này liệt kê.
  • AWS CodeCommit: sao chép script mà bước này hiển thị và chạy nó. Script đã chứa sẵn URL và secret.
Cấu hình webhook có các bước cho từng provider.
Không có webhook này, CloudThinker không nhận được thông tin về MR hoặc PR mới và không có lượt review nào chạy.
Để xem lại URL và secret token sau này, mở Review → Settings, rồi trong phần Connection nhấn Webhook.
6

Chọn kho

Trong Select Repositories, đánh dấu từng kho cần review, rồi nhấn Next. Dùng Search repositories… để tìm kho trong danh sách dài. Danh sách chỉ gồm các kho mà kết nối của bạn nhìn thấy. Trên GitHub, kho còn phải được cấp trong phần quyền truy cập kho của app trước (xem GitHub).Các kho bạn tạo sau này trên provider không tự xuất hiện: hãy thêm chúng bằng Add repository trong Review → Settings → Repositories.
7

Learnings

Hai công tắc quyết định review học từ đâu. Cả hai đều bật sẵn.Nhấn Complete.Trạng thái thành công: trang Overview của Review tải xong, và các kho của bạn xuất hiện trong Review → Settings → Repositories. Trong lúc CloudThinker clone một kho, hàng của kho đó hiển thị Cloning và công tắc Review hiển thị Setting up. Nếu clone thất bại, hàng hiển thị Setup failed; xem sự cố với kho. Workspace bắt đầu với chế độ review Fast.

Nhận lượt review đầu tiên

1

Mở pull request hoặc merge request

Đẩy một nhánh lên kho đã chọn và mở PR hoặc MR vào kho đó. Đừng mở ở dạng draft: draft bị bỏ qua cho đến khi bạn đánh dấu sẵn sàng để review.PR đến trong lúc kho vẫn đang clone sẽ nhận một ghi chú “setting up” và được review khi clone xong.
2

Đọc phát hiện trên PR

CloudThinker đăng một bình luận tiến độ trước, rồi thay bằng bản tóm tắt. Bình luận inline nằm đúng các dòng liên quan, mỗi bình luận có mức độ nghiêm trọng (Critical, High, Medium hoặc Low), phần giải thích và bản sửa đề xuất.Trạng thái thành công: bình luận tóm tắt xuất hiện trên PR, kèm liên kết quay lại thay đổi đó trong CloudThinker.Bình luận đến từ danh tính bạn dùng để kết nối:
3

Trao đổi tiếp ngay trên PR

Trả lời trong thread của một phát hiện để phản biện, hoặc mention bot trong một bình luận PR:
Trên AWS CodeCommit, chỉ câu hỏi và @cloudthinker-ai help hoạt động. CodeCommit bỏ qua review, autofix và các câu trả lời trong thread của phát hiện. Để review lại một PR CodeCommit, hãy đẩy commit mới lên nhánh nguồn của PR.Để bỏ qua review cho một PR, đặt @cloudthinker:ignore ở bất kỳ đâu trong mô tả PR. Xem mention commands để có danh sách đầy đủ.
Bạn cũng có thể mở mọi thay đổi đã review, cùng phát hiện và trạng thái, trong Review → Reviews. Xem review workspace.

Chọn chế độ review

Chế độ review áp dụng cho mọi kho trong workspace. Thay đổi trong Review → Settings → General → Review mode. Workspace mới bắt đầu ở Fast.
Trang Review Settings hiển thị Git provider đã kết nối, cài đặt Review mode và nút Add repository

Review Settings: provider đã kết nối, chế độ review và Add repository

Các cài đặt workspace khác

Các cài đặt này nằm trong cùng phần General của Review → Settings và tắt cho đến khi bạn bật.

Lọc những PR được review

Mỗi kho có thể có bộ lọc để CloudThinker bỏ qua những PR bạn không muốn review, chẳng hạn PR nâng phiên bản dependency do bot tạo.
1

Mở bộ lọc của kho

Vào Review → Settings → Repositories, mở menu thao tác (⋯) của kho, rồi nhấn Configure filters.
2

Thêm quy tắc

Nhấn Add Filter Rule, chọn loại bộ lọc, Include hoặc Exclude, và các giá trị. Sau đó nhấn Save Filters.
Cách các quy tắc kết hợp:
  • Quy tắc Exclude được kiểm tra trước. PR khớp bất kỳ quy tắc exclude nào sẽ bị bỏ qua.
  • Sau đó mọi quy tắc include đều phải đạt. Trong một quy tắc, chỉ cần khớp một trong các giá trị là đủ.
Hãy đặt nhiều nhánh trong một quy tắc Branches. Hai quy tắc include Branches riêng biệt phải cùng khớp một nhánh đích, nên gần như mọi PR đều bị bỏ qua.
Bộ lọc được kiểm tra ở mọi sự kiện mới, nên cũng áp dụng cho các MR/PR mà CloudThinker đang theo dõi, kể từ lần push tiếp theo. Để vẫn review một MR/PR đã bị lọc, hãy bình luận @cloudthinker-ai review trên đó. CodeCommit không có lệnh review, nên PR CodeCommit bị lọc sẽ không được review cho đến khi bạn đổi bộ lọc và đẩy commit mới. Ví dụ, Exclude Authors dependabot[bot] cùng Include Branches main sẽ review mọi PR vào main trừ PR của Dependabot. PR bị bỏ qua vẫn được theo dõi nhưng không được review: PR đó hiển thị trong Review → Reviews ở tab All với verdict Ignored. Xem verdict.

Khắc phục sự cố

Nguyên nhân: PR đang là draft, kho chưa được chọn hoặc vẫn đang clone, một bộ lọc đã loại PR, hoặc thiếu webhook.Kiểm tra: mở Review → Settings → Repositories và xác nhận kho đang On. Sau đó kiểm tra provider:
  • GitHub: trong cài đặt tổ chức hoặc tài khoản, mở GitHub Apps, nhấn Configure cạnh app CloudThinker, và xác nhận kho đã được cấp quyền truy cập.
  • Bitbucket: trong Repository settings → Webhooks, xác nhận webhook CloudThinker tồn tại và các request gần đây đều thành công.
  • GitLab: trong Settings → Webhooks, sửa webhook CloudThinker và xem Recent events để tìm request thất bại.
  • Azure DevOps: trong Project Settings → Service hooks, mở từng subscription của CloudThinker và xem History.
  • CodeCommit: không có log webhook. Trong Amazon EventBridge, ở region của kho, xác nhận các rule CloudThinker-CodeCommit-* tồn tại. Nếu không có, hãy chạy lại script ở bước Events.
Cách sửa: đánh dấu PR sẵn sàng để review, bật kho, hoặc thêm lại webhook. Sau đó bình luận @cloudthinker-ai review trên PR để bắt đầu review mà không cần push. Trên CodeCommit, hãy đẩy commit mới lên nhánh nguồn của PR.
Nguyên nhân: token đã hết hạn hoặc bị thu hồi, hoặc quyền OAuth đã bị gỡ.Cách sửa: trang Review hiển thị cảnh báo Authentication Error. Nếu bạn kết nối bằng OAuth, nhấn Reconnect with GitLab (hoặc Bitbucket) và cấp quyền lại. Nếu bạn dùng token, nhấn Update Token (trên CodeCommit là Update Credentials), dán token mới và xác thực. Các kho và cài đặt của bạn được giữ nguyên.PR được mở trong lúc kết nối bị hỏng có thể chưa được review. Bình luận @cloudthinker-ai review trên PR đó để bắt đầu, hoặc trên CodeCommit, đẩy commit mới lên nhánh nguồn.Để thay token trước khi hết hạn, mở Review → Settings, rồi trong phần Connection mở menu thao tác (⋯) và nhấn Update token.
Kiểm tra: bình luận tiến độ trên PR giờ hiển thị CloudThinker Review Did Not Finish, có thể kèm lý do, ví dụ CloudThinker không mở được kho. Trong CloudThinker, mở lượt review và dùng More actions (⋯) → View review conversation để xem lượt chạy.Cách sửa: nếu không mở được kho, hãy kết nối lại trong Review → Settings. Sau đó bình luận @cloudthinker-ai review trên PR để tiếp tục từ commit được review gần nhất. Trên CodeCommit, hãy đẩy commit mới lên nhánh nguồn của PR.
Nguyên nhân: workspace đã dùng hết hạn mức sử dụng, nên lượt review không thể hoàn tất.Kiểm tra: Admin Settings → Usage hiển thị số credit còn lại của tổ chức (Owner và Admin mở được trang này). Workspace cũng có thể chạm giới hạn credit riêng.Cách sửa: nâng cấp gói hoặc chờ hạn mức được làm mới (xem mức sử dụng và credit để biết khi nào từng loại credit được đặt lại), rồi bình luận @cloudthinker-ai review trên PR. Trên CodeCommit, hãy đẩy commit mới lên nhánh nguồn của PR.
Kiểm tra: trong Review → Settings → Repositories, di chuột lên Setup failed để xem lỗi clone. Lỗi thường do token hết hạn hoặc thiếu quyền truy cập kho đó.Cách sửa: khắc phục quyền truy cập, rồi nhấn Retry trên hàng. Nếu clone mãi ở Cloning, nhấn Cancel và xác nhận Cancel clone. Hàng hiển thị Setup cancelled; nhấn Retry.

Bước tiếp theo

Hướng dẫn thực tế: xem Review chặn một thay đổi có thể làm hỏng production trong Bắt pull request rủi ro với Review.

Xác thực provider

Scope token và các bước cấu hình webhook cho từng Git provider.

Mention commands

Đặt câu hỏi, review lại và sửa phát hiện từ một bình luận PR.

Review workspace

Theo dõi mọi thay đổi đã review và các phát hiện của chúng trong CloudThinker.

Learnings

Dạy review những mẫu lỗi mà nhóm bạn cứ phải sửa đi sửa lại.