Review và promotion

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

Tạo môi trường dùng chung tồn tại lâu dài, thiết lập các tuyến CI review, xem xét sự kiện merge cùng bằng chứng QA, merge trong Console và promotion candidate đã được xác thực.

Quản trị viên khách hàngThành viên khách hàngNgười vận hành nền tảng

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

Environments (/environments) và CI & Review (/ci-review) là các quy trình xác thực dùng chung của Console. Hãy dùng chúng khi nhóm cần một runtime QA, UAT, demo, staging hoặc review khách hàng tồn tại lâu dài, đồng thời muốn các thay đổi phải qua code review và QA trước khi promotion.

Môi trường tồn tại lâu dài không phải workspace cá nhân. Đây là runtime dùng chung của nhóm, có chính sách, tính phí và lịch sử sự kiện riêng. Hồ sơ workspace CI cho Console biết cần dùng runtime review hoặc QA nào khi một sự kiện merge cần kiểm tra trình duyệt, cơ sở dữ liệu hoặc code intelligence.

Ai có thể xem

Cả hai trang đều nằm trong mục Phát hành trên thanh điều hướng, dành cho mọi người trong nhóm: thành viên nhóm, quản trị viên nhóm, người vận hành và quản trị viên nền tảng. Chính sách nhóm quyết định ai được tạo môi trường và hồ sơ CI. Nếu nút tạo không xuất hiện hoặc yêu cầu bị từ chối, hãy hỏi quản trị viên nhóm.

Trước khi bắt đầu

• Kết nối Git provider cho repository (Cài đặt → Quyền truy cập Git).
• Chuẩn bị một bản sao lưu cơ sở dữ liệu đã được phê duyệt để làm dữ liệu seed (Sao lưu).
• Quyết định tuyến chỉ kiểm tra source branch hay còn nhắm đến một môi trường tồn tại lâu dài. Lựa chọn này quyết định các bước kiểm tra sẽ chạy.

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

Persistent Environments (“Tạo và vận hành workspace bền vững cho môi trường nhóm”) liệt kê các môi trường của nhóm cùng hàng đợi, chi tiết và bảng kiểm tra. Biểu tượng (i) cạnh tiêu đề giải thích trang này và liên kết đến hướng dẫn.

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

Chọn Create environment (/environments/new). Wizard có bốn bước Nguồn, Runtime, Policy và Review, cùng bảng khởi chạy liệt kê mọi yếu tố còn đang chặn.

1. Nguồn: nhóm, tên môi trường, URL repository và source branch. Console kiểm tra quyền truy cập provider. Bật repository stack khi cần checkout lần lượt một repository runtime rồi đến một repository sản phẩm.
2. Runtime: hồ sơ môi trường tồn tại lâu dài, họ template, workspace target và kích thước. Hồ sơ này đặt phiên bản WebCentral (Java, Gradle, Tomcat và gói license).
3. Policy: bản sao lưu seed, mức độ hiển thị và công cụ migration cơ sở dữ liệu (Flyway, ARCHIBUS DUW hoặc không dùng).
4. Review: kiểm tra kế hoạch rồi chọn Create environment. Giá uptime cho kỳ hạn đã chọn được hiển thị tại đây.

Console tạo bản ghi và khởi động workspace nền. Sau đó, môi trường hiển thị workspace tồn tại lâu dài, phiên bản candidate và current, trạng thái cập nhật, lối tắt runtime và lịch sử sự kiện. Bất kỳ ai xem được môi trường đều có thể đổi tên bằng nút hình bút chì. Việc đổi tên chỉ thay đổi tên hiển thị.

Lối tắt runtime

Cập nhật môi trường qua hai giai đoạn

Môi trường dùng chung sẽ không bị khởi động lại do nhầm lẫn:

1. Yêu cầu cập nhật môi trường phê duyệt bản cập nhật nhưng chưa tác động đến môi trường đang chạy.
2. Bắt đầu cập nhật môi trường bắt đầu cập nhật và chờ. Trạng thái chuyển sang running rồi applied.

CI & Review

CI & Review (“Xử lý sự kiện merge từ lúc tiếp nhận đến khi phê duyệt, QA workspace, xác thực môi trường đích và merge do con người thực hiện”) là nơi xem xét và merge các thay đổi. Biểu tượng (i) cạnh tiêu đề giải thích trang và liên kết đến hướng dẫn.

Dải quy trình cho biết các giai đoạn của sự kiện merge đã chọn: Tiếp nhận, Review, QA, QA mục tiêu và Merge. Bên dưới là năm tab, mỗi tab có số lượng:

Tạo hồ sơ workspace CI

Chọn Tạo profile CI (/ci-review/workspaces/new). Các bước là Route nguồn, Thời gian chạy workspace, Chính sách chạy và Rà soát và tạo.

1. Route nguồn: nhóm, provider, repository, branch và tùy chọn môi trường đích. Môi trường đích sẽ bật bước kiểm tra đích.
2. Thời gian chạy workspace: review, QA, review cùng QA hoặc QA đích, cùng CI template, target và kích thước.
3. Chính sách chạy: thời hạn lưu giữ, artifact, các giai đoạn chạy, phạm vi QA, công cụ migration, hồ sơ phiên bản WebCentral và bản sao lưu cơ sở dữ liệu.
4. Rà soát và tạo: kiểm tra lưới rồi chọn Tạo profile CI.

Hồ sơ là metadata của tuyến, không phải workspace cá nhân. Console dùng hồ sơ khi sự kiện merge cần workspace review hoặc QA.

Thiết lập bàn giao cho provider

Trong Bàn giao cho nhà cung cấp, tải một tuyến rồi:

• Lưu kết nối được quản lý bằng tham chiếu thông tin xác thực đã được phê duyệt. Sau khi lưu, Console chỉ hiển thị bản xem trước.
• Chọn Xoay vòng thông tin xác thực hoặc Thu hồi thông tin xác thực.
• Chọn Cài đặt webhook, Đối soát webhook hoặc Gỡ webhook.
• Chọn Kiểm tra kết nối trước khi dựa vào tuyến.

Không bao giờ đưa provider token vào tên tuyến, mô tả hoặc ghi chú QA.

Review triển khai

Review triển khai là cách một thay đổi đã được lên kế hoạch, thường là vấn đề được phê duyệt trong Thiết kế, trở thành mã đã merge:

1. Lập trình viên triển khai vấn đề trong workspace và push một nhánh.
2. Thay đổi xuất hiện trong Sự kiện gộp từ webhook provider, bàn giao workspace hoặc đăng ký thủ công.
3. Trong Review, kiểm tra source branch, target branch, liên kết provider, reviewer và các thay đổi xếp chồng. Gán reviewer và thêm ghi chú.
4. Chọn Bắt đầu review & QA. Review của ArchiBot xem xét mã, diff xếp chồng, kiểm thử còn thiếu và các đường dẫn rủi ro. Runner QA thu thập bằng chứng thực thi: kiểm thử smoke trình duyệt, kiểm tra cơ sở dữ liệu, lệnh kiểm thử và log workspace. Xem Các bot của Console.
5. Theo dõi dải quy trình và Bằng chứng và log. Dùng Hủy run để dừng lần chạy.

Merge trong Console chỉ khả dụng khi:

• đã ghi nhận chấp thuận của reviewer,
• code review được yêu cầu đã đạt,
• runner QA được yêu cầu đã đạt, và
• nếu đã chọn môi trường đích thì kiểm tra môi trường đích đã đạt.

Mặc định, việc merge do con người thực hiện. Sau khi merge, candidate có thể được promotion: dùng Nâng cấp ứng viên trong Environments khi lần chạy mới nhất khớp với candidate, rồi áp dụng quy trình cập nhật hai giai đoạn ở trên.

Chỉ source branch hay có môi trường đích

Khi không có môi trường đích, Console chạy code review và runner QA, còn QA mục tiêu hiển thị là skipped. Khi có môi trường đích, Console cũng xác thực candidate theo cơ sở dữ liệu, bản sao lưu, công cụ migration, target, template, toolchain và tham số của môi trường đó trước khi merge hoặc promotion. Giữ cùng hồ sơ phiên bản WebCentral trên môi trường và cả hai hồ sơ QA.

Log và bằng chứng

Lưu vào Shared Drive giúp lưu bằng chứng lâu hơn thời hạn lưu log thông thường. Cần có ổ đĩa cho phép ghi. Trước khi merge, reviewer cần trả lời được từ Console: đã thay đổi những gì, những bước kiểm tra nào đã chạy và bằng chứng đã được làm sạch nằm ở đâu. Không bao giờ chia sẻ key, provider token, cookie, bí mật cluster, URL cơ sở dữ liệu, nội dung bản sao lưu hoặc tệp license.

Trên điện thoại

• Environments xếp hàng đợi, chi tiết và bảng kiểm tra thành một cột. Khi chọn môi trường, trang cuộn đến phần chi tiết.
• Create environment và Tạo profile CI được ghim ở cuối màn hình trong suốt các wizard. Nút trùng lặp trong bảng khởi chạy và thẻ review được ẩn, để chỉ còn một nút chính.
• Bảng provider CI trong wizard hồ sơ trở thành các thẻ có nhãn.
• Các tab CI & Review cuộn ngang, còn liên kết reviewer, lần chạy và yêu cầu merge có vùng chạm đủ lớn.
• Nhật ký build và các hộp thoại khác mở thành sheet rộng toàn màn hình. Popover (i) cạnh mỗi tiêu đề vừa với màn hình.

Khắc phục sự cố

Khi cần hỗ trợ, hãy nêu nhóm, tên môi trường, sự kiện merge hoặc ID lần chạy, các nhánh, giai đoạn bị chặn và lỗi đã được làm sạch. Xem Bàn giao cho bộ phận hỗ trợ.

Hướng dẫn liên quan

• Thiết kế
• Các bot của Console
• Trung tâm Operations
• Shared Drive