Review Và Tự động hóa

Môi trường tồn tại lâu dài và CI Review

Tạo các môi trường tồn tại lâu dài dùng chung bằng wizard bốn bước, thiết lập hồ sơ workspace CI, xem lại các sự kiện merge trên năm tab CI, và thăng cấp các ứng viên đã được xác thực từ Console.

Quản trị viên khách hàngNhà vận hành nền tảng

Cập nhật lần cuối 19 tháng 6, 2026

Môi trường tồn tại lâu dài và CI Review là các quy trình do Console sở hữu để xác thực dùng chung. Hãy dùng chúng khi khách hàng cần một runtime QA, UAT, demo, staging hoặc client-review kéo dài và muốn các thay đổi phải qua code review và QA trước khi được thăng cấp.

Các quy trình này khác với workspace phát triển cá nhân. Một môi trường tồn tại lâu dài là runtime dùng chung của khách hàng với chính sách, tính phí, hỗ trợ và lịch sử sự kiện. Một hồ sơ workspace CI là hồ sơ runtime review hoặc QA do route sở hữu mà Console dùng khi một sự kiện merge cần các kiểm tra trình duyệt, cơ sở dữ liệu, code intelligence, hoặc môi trường đích.

Cả hai khu vực đều nằm trong thanh bên trái của Console. Environments quản lý các runtime dùng chung và các candidate của chúng; CI & Review quản lý các route, sự kiện merge, các lần chạy, và bàn giao cho provider. Hai phần này liên kết với nhau, nên bạn có thể chuyển qua lại giữa một môi trường và lịch sử review của nó mà không mất ngữ cảnh.

Trước khi bắt đầu

• Bạn cần vai trò customer admin hoặc platform operator để tạo môi trường và hồ sơ CI.
• Repository và nhánh bạn dự định xác thực phải có thể truy cập qua một Git provider đã kết nối. Xem Customer admin setup để biết cách kết nối provider và Backups and restore sources để biết về database seed.
• Quyết định route là source-branch-only hay nhắm tới một môi trường tồn tại lâu dài, vì lựa chọn đó sẽ thay đổi các kiểm tra nào được chạy.

Tạo một môi trường tồn tại lâu dài

Mở Environments và chọn Create environment. Console mở một wizard bốn bước với thanh bước ở phía trên: Source, Runtime, Policy, và Review. Một bảng khởi chạy trực tiếp ở bên phải hiển thị các lựa chọn hiện tại và liệt kê mọi mục bắt buộc còn đang chặn.

1. Source. Chọn phạm vi khách hàng, đặt tên môi trường, và xác nhận URL repository cùng source branch. Console xác minh quyền truy cập provider ở đây. Khi một thay đổi phụ thuộc vào nhiều hơn một repository, hãy bật repository stack để một runtime repository và một product repository được checkout theo thứ tự.
2. Runtime. Chọn profile persistent-environment, family template, workspace target, và kích thước runtime. Profile này đặt các giả định về phiên bản WebCentral, bao gồm Java, Gradle, Tomcat, và license bundle dự kiến cho workspace nền.
3. Policy. Thiết lập nguồn seed (database backup), mức độ hiển thị, và database migration engine. Chọn migration engine phù hợp với đích: Flyway, ARCHIBUS DUW, hoặc tắt migrations.
4. Review. Xác nhận kế hoạch khởi chạy. Lưới review tóm tắt profile, chế độ repository, kích thước, và database backup. Khi mọi thứ cần thiết đều có mặt, chọn Create environment.

Khi quá trình tạo bắt đầu, Console tạo bản ghi môi trường và khởi động workspace nền khi mục tiêu được chọn hỗ trợ điều đó. Sau đó thẻ môi trường hiển thị persistent workspace, phiên bản candidate và current, trạng thái cập nhật môi trường, lối tắt runtime, và lịch sử sự kiện.

Môi trường tồn tại lâu dài được thiết kế để duy trì lâu hơn các workspace phát triển cá nhân. Hãy chọn kích thước runtime và kỳ hạn giá một cách cẩn thận, và dùng lịch sử sự kiện để xác nhận khi nào workspace nền, route Tomcat, database seed, và trạng thái promotion đã sẵn sàng.

Bất kỳ ai có thể xem môi trường đều có thể đổi tên nó. Hãy dùng điều khiển chỉnh sửa tên dạng bút chì trên thẻ môi trường để thay đổi tên hiển thị. Đổi tên chỉ ảnh hưởng tên hiển thị: nó không thay đổi khóa môi trường, khách hàng, repository, provisioner, hay bất kỳ cấu hình nào khác. Các thay đổi cấu trúc vẫn cần quyền admin hoặc manage.

Hãy dùng profile phiên bản WebCentral khớp với repository nguồn hoặc WAR, đặc biệt đối với các phiên bản WebCentral cũ cần Tomcat 8.5 hoặc Tomcat 9 thay vì mặc định hiện tại. Xem Workspace presets để biết các profile đó ánh xạ vào các thiết lập runtime như thế nào.

Mở lối tắt runtime của môi trường

Sau khi workspace tồn tại lâu dài đã tồn tại, hãy dùng các hành động trên thẻ môi trường:

Đừng dán log thô vào ticket hỗ trợ. Thay vào đó, hãy chia sẻ trạng thái hiển thị, run ID, tên workspace, dấu thời gian, và văn bản lỗi đã được làm sạch.

Cập nhật runtime của môi trường theo hai giai đoạn

Khi một phiên bản candidate sẵn sàng được đưa vào runtime tồn tại lâu dài, Console dùng một quy trình cập nhật hai giai đoạn có chủ đích để môi trường dùng chung không bao giờ bị khởi động lại do nhầm lẫn.

1. Request environment update. Thao tác này phê duyệt bản cập nhật cho workspace tồn tại lâu dài và đánh dấu nó là đã yêu cầu. Console cho biết bản cập nhật đã sẵn sàng để bắt đầu nhưng vẫn chưa tác động đến môi trường đang chạy.
2. Start environment update. Thao tác này bắt đầu cập nhật workspace tồn tại lâu dài và chờ kết quả runtime. Console chuyển trạng thái sang running, rồi sang applied khi runtime tồn tại lâu dài đã ở phiên bản được thăng cấp.

Thẻ môi trường hiển thị trạng thái cập nhật hiện tại và mô tả ngắn cho từng giai đoạn, cùng các dòng bằng chứng runtime để bạn xác nhận những gì đã thay đổi.

Tạo hồ sơ workspace CI

Mở CI & Review và chọn Create CI profile (nó là Create CI/profile trong thanh hành động phía trên). Console mở một wizard bốn bước với cùng hình dạng thanh bước: Source, Runtime, Policy, và Review, được hiển thị trong vùng làm việc là Source route, Workspace runtime, Run policy, và Review and create.

1. Source route. Chọn khách hàng, provider, repository, branch, và một target environment tùy chọn. Việc chọn target environment sẽ bật kiểm tra đích ở bước sau. Áp dụng hồ sơ repository stack khi thay đổi cần một runtime repository cộng với một product hoặc dependency repository.
2. Workspace runtime. Chọn hình dạng workspace: review, QA, review plus QA, hoặc destination QA. Chọn CI template, workspace target, và kích thước.
3. Run policy. Thiết lập thời gian lưu giữ, artifacts, các giai đoạn nào được chạy, phạm vi QA, và database migration engine. Chọn profile phiên bản WebCentral và database backup. Review thường dùng high reasoning; QA thường dùng low reasoning sau khi các kiểm tra xác định đã thu thập đủ bằng chứng.
4. Review and create. Xác nhận hồ sơ route trong lưới review, rồi chọn Create CI profile.

Lưu một hồ sơ workspace CI không tạo ra một workspace phát triển cá nhân. Nó tạo metadata route mà Console dùng khi một sự kiện merge hoặc lần chạy kiểm thử cần một workspace review hoặc QA. Các lần chạy nhẹ vẫn có thể dùng Console runner mà không cần workspace khi không yêu cầu công cụ trình duyệt, cơ sở dữ liệu, và code intelligence.

Nếu route không có target environment đích, Console vẫn có thể chạy QA theo source branch. Code review bắt đầu từ một sự kiện merge của Console, pull request của provider, hoặc một diff tường minh để người review thấy đúng bộ thay đổi và cổng merge. Kiểm tra môi trường đích được bỏ qua vì không có cấu hình môi trường nào để xác thực.

Năm tab CI & Review

Khu vực làm việc CI & Review được tổ chức thành năm tab phía trên bảng chính, mỗi tab có số lượng trực tiếp:

Phía trên các tab, một dải quy trình hiển thị pipeline giai đoạn cho sự kiện merge đã chọn: Intake, Review, QA, Target QA, và Merge. Mỗi giai đoạn hiển thị trạng thái riêng, như open, waiting, skipped, hoặc waiting on checks.

Source-branch-only so với target environment

Các route source-branch-only chạy code review và runner QA mà không có một môi trường tồn tại lâu dài được chọn. Ở chế độ đó, Console cố ý bỏ qua kiểm tra môi trường đích, và giai đoạn Target QA được hiển thị là skipped.

Các route có chọn một môi trường tồn tại lâu dài sẽ thêm kiểm tra môi trường đích. Sau khi code review và runner QA đều đạt, Console xác thực candidate theo các giá trị mặc định của môi trường đã chọn trước khi merge hoặc promotion có thể tiếp tục.

Kiểm tra môi trường đích sử dụng các giá trị mặc định của môi trường quan trọng sau khi promotion, bao gồm loại cơ sở dữ liệu, database backup, migration engine, workspace target, template, toolchain, tham số workspace, và license override khi được cấu hình.

Khi route dùng một phiên bản WebCentral cũ, hãy giữ cùng profile phiên bản trên persistent environment, source QA profile, và destination QA profile. Điều đó giúp bằng chứng review, kiểm tra smoke trình duyệt, và bước kiểm tra promotion cuối cùng chạy trên cùng giả định runtime.

Thiết lập provider handoff

Mở tab Provider handoff và nạp một route để đăng ký hoặc kiểm tra kết nối provider được quản lý. Console sở hữu lớp review; kết nối provider cho phép nó đăng nhận xét review và QA, gửi phản hồi trạng thái, và nhận các sự kiện merge.

Từ tab này bạn có thể:

• Save a managed connection. Đăng ký app provider, service hook, hoặc một tham chiếu credential đã được phê duyệt như token://..., k8s://secret/key, hoặc tham chiếu OpenBao/Vault. Console cũng có thể chấp nhận token provider dùng một lần hoặc app password và lưu nó vào Console token storage, một Kubernetes Secret, hoặc OpenBao/Vault. Sau khi lưu, Console chỉ hiển thị credential preview.
• Rotate the credential. Dùng Rotate credential khi token hết hạn hoặc bị thay thế. Chạy kiểm tra kết nối sau đó.
• Revoke the credential. Dùng Revoke credential để giữ bản ghi kết nối nhưng dừng việc đăng cho đến khi một tham chiếu credential mới được thêm vào.
• Install or reconcile a webhook. Dùng Install webhook để các cập nhật merge-event đến được Console, Reconcile webhook để sửa một hook bị lệch, và Remove webhook để dừng sự kiện. Lưu hoặc chọn một route trước khi cài webhook.
• Check the connection. Dùng Check connection để xác nhận tình trạng trước khi dựa vào route cho review, trạng thái, hoặc việc đăng nhận xét.

Một bảng readiness sẽ dẫn qua metadata của route, service provider, đích cài đặt, nguồn credential, các hành động được phép, bản ghi Console, và tình trạng provider, để bạn thấy bước nào vẫn còn thiếu.

Không đặt provider token, payload credential thô, hoặc bí mật triển khai riêng tư vào tên route, mô tả, ghi chú QA, hoặc hướng dẫn route.

Review một sự kiện merge

Sự kiện merge là đơn vị review thông thường trong Console. Một sự kiện merge có thể đến từ webhook của provider, bàn giao workspace, hoặc đăng ký thủ công trong Console.

1. Mở CI & Review.
2. Chọn sự kiện merge từ tab Merge events.
3. Mở Review in Console để xem source branch, target branch, liên kết provider, các mục tính năng, danh sách reviewer, và các thay đổi xếp chồng.
4. Gán reviewer hoặc thêm reviewer tùy chỉnh, và cập nhật ghi chú reviewer.
5. Chọn Start review & QA khi route đã sẵn sàng.
6. Theo dõi dải quy trình: Intake, Review, QA, Target QA, và Merge.

Khi phát hiện các thay đổi xếp chồng, Console hiển thị bản xem trước của stack có giới hạn và ngữ cảnh theo từng file mà nó có thể an toàn hiển thị. Chỉ dùng liên kết provider để tham khảo ngữ cảnh thứ cấp.

Review và runner QA của ArchiBot có thể chạy riêng hoặc cùng nhau. Review tập trung vào code, ngữ cảnh diff xếp chồng, test còn thiếu, các đường đi rủi ro, và tác động đến tài liệu. QA tập trung vào bằng chứng thực thi như smoke trình duyệt, kiểm tra cơ sở dữ liệu, các lệnh kiểm thử đã chọn, xác thực toolchain, và log workspace. Xem Console Bots để biết cách các bot review và QA của ArchiBot được cấu hình.

Nếu một lần chạy cần dừng lại, hãy dùng Cancel run trên lần chạy trong tab Evidence and logs. Console đánh dấu lần chạy là canceled.

Merge và promotion

Console mặc định giữ merge do con người thực hiện.

Trước khi Merge in Console khả dụng:

• Phải có ghi nhận chấp thuận của reviewer.
• Giai đoạn code review được yêu cầu phải đạt.
• Giai đoạn runner QA được yêu cầu phải đạt.
• Nếu có chọn target environment, kiểm tra môi trường đích phải đạt.

Sau khi merge hoàn tất, candidate đã được xác thực có thể trở thành promotion candidate cho môi trường tồn tại lâu dài đã chọn. Chỉ dùng Promote candidate từ Environments khi lần chạy CI mới nhất và kiểm tra môi trường đích khớp với phiên bản candidate. Sau khi được thăng cấp, hãy dùng cập nhật môi trường hai giai đoạn được mô tả ở trên để đưa nó vào runtime đang chạy.

Log, bằng chứng, và Shared Drive

CI & Review và Environments lưu lịch sử sự kiện trong Console. Hãy dùng dòng thời gian của lần chạy trong tab Evidence and logs để xem các thay đổi giai đoạn, tên job, trạng thái môi trường đích, và các dòng log đã được làm sạch.

Dùng Save to Shared Drive khi bộ phận hỗ trợ cần bằng chứng để tồn tại lâu hơn cửa sổ lưu giữ log chuẩn của lần chạy. Tài khoản cần có một drive có thể ghi để làm việc này. Hãy giữ bằng chứng lưu lâu ở trạng thái đã được làm sạch và được khách hàng phê duyệt. Xem Workspace ArchiBot and Shared Drive để biết cách quyền truy cập drive theo phạm vi hoạt động.

Reviewer nên có thể trả lời ba câu hỏi từ Console trước khi merge:

• Điều gì đã thay đổi, bao gồm mọi diff xếp chồng?
• Những kiểm tra review, QA, và đích nào đã chạy?
• Bằng chứng đã được làm sạch nằm ở đâu nếu lần chạy cần bộ phận hỗ trợ xem lại sau này?

Không chia sẻ:

• API keys, provider tokens, webhook secrets, cookies, hoặc invite links.
• Kubernetes Secrets, biến môi trường của pod, kubeconfigs, hoặc Coder tokens.
• URL cơ sở dữ liệu thô, nội dung bản sao lưu thô, hoặc file license.
• Bản ghi chép riêng tư hoặc các bản xuất dữ liệu khách hàng.

Các khối chặn thường gặp

Bàn giao cho hỗ trợ

Khi làm việc với hỗ trợ, hãy bao gồm:

• Tài khoản khách hàng và tên môi trường.
• Merge event ID hoặc CI run ID.
• Source branch, target branch, và số merge request của provider khi hiển thị.
• Giai đoạn đang bị chặn.
• Lỗi hoặc tóm tắt log đã được làm sạch từ Console.

Không bao gồm credential thô, log đầy đủ có bí mật, dữ liệu cơ sở dữ liệu riêng tư, hoặc liên kết dùng một lần. Xem Support handoff để biết danh sách bằng chứng đầy đủ.