Chạy Bộ Kiểm Thử Qua CLI

Lựa Chọn Phương Thức Chạy Phù Hợp

Apidog cung cấp nhiều cách để chạy bộ kiểm thử, phù hợp với các yêu cầu kiểm thử khác nhau.

Thực Thi Trực Quan Cục Bộ:

Phương thức này được khởi chạy từ máy cục bộ và phù hợp cho kiểm thử nhanh, quy mô nhỏ.

Phương thức này đặc biệt hiệu quả khi phát triển và kiểm thử diễn ra đồng thời, cho phép giám sát theo thời gian thực và điều chỉnh ngay lập tức.

Thực Thi Apidog CLI Cục Bộ:

Lý tưởng để xử lý dữ liệu quy mô lớn hoặc các kịch bản lặp, phương thức này mang lại tốc độ thực thi cao hơn.

Phương thức này có khả năng chạy ngoại tuyến, phù hợp với các môi trường có tài nguyên hạn chế hoặc không yêu cầu giao diện người dùng đồ họa.

Thực Thi CI/CD:

Kiểu thực thi này được tích hợp trong pipeline CI/CD, là một lựa chọn rất phù hợp cho các quy trình tích hợp tự động và triển khai liên tục.

Phương thức này đặc biệt hữu ích trong các môi trường nơi kiểm thử được chạy thường xuyên để xác nhận độ ổn định của API sau mỗi lần cập nhật mã.

Thực Thi Bằng Runner Tự Lưu Trữ:

Các nhóm có thể thiết lập Apidog Runner trên máy chủ riêng của họ, tận dụng tài nguyên tính toán mạnh mẽ hơn cho kiểm thử.

Phương thức này bao gồm hỗ trợ cho các tác vụ theo lịch, rất lý tưởng cho các kịch bản cần kiểm thử định kỳ hoặc có nhu cầu kiểm thử đáng kể.

TIP

Trong các bộ kiểm thử, nếu sử dụng biến môi trường/biến toàn cục, giá trị thực tế của các biến này có thể khác nhau tùy thuộc vào phương thức thực thi được chọn, điều này có thể dẫn đến kết quả kiểm thử không nhất quán. Tìm hiểu thêm.

Chạy Apidog CLI

Để chạy bộ kiểm thử bằng Apidog CLI, trước tiên bạn cần tạo và điều phối một bộ kiểm thử. Sau đó, bạn có thể chạy bộ kiểm thử từ dòng lệnh bằng Apidog CLI và nhận kết quả kiểm thử cũng như báo cáo kiểm thử.

Trong một bộ kiểm thử, chuyển sang tab CI/CD.

Cấu hình các tham số như môi trường chạy và phương thức thông báo. Mỗi cấu hình trong giao diện sẽ được phản ánh theo thời gian thực trong lệnh CLI được tạo bên dưới.

Trong phần nhà cung cấp CI/CD, chọn dòng lệnh CLI hoặc các nền tảng khác.

Nhấp vào nút "Add access token" rồi nhấp "Generate token" để xác thực lệnh gọi CLI. Tìm hiểu thêm.

Nhấp để sao chép lệnh, dán vào dòng lệnh và thực thi để xem quá trình thực thi kiểm thử và báo cáo kiểm thử.

CleanShot 2026-01-13 lúc 15.48.13@2x.png

Lưu ý: Để lệnh chạy thành công, trước tiên bạn cần cài đặt Apidog CLI. Nếu đã cài đặt, bạn cần cập nhật lên phiên bản mới nhất.

Về Biến và Tệp Cấu Hình Cục Bộ (Tùy Chọn)

Trong một số kịch bản, thực thi CLI yêu cầu các tệp cấu hình cục bộ:

Biến Môi Trường / Biến Toàn Cục

Nếu bạn chọn "Export current values for use", bạn cần đặt tệp biến đã xuất trên máy thực thi CLI và chỉ định đường dẫn tệp thông qua --variables <path>.

Để biết sự khác biệt giữa "Use initial Values" và "Export current values for use", hãy tham khảo: Quy tắc sử dụng biến môi trường/biến toàn cục trên các phương thức chạy khác nhau.

Kết Nối Cơ Sở Dữ Liệu

Nếu kiểm thử sử dụng "database connections" được lưu cục bộ, giao diện sẽ hướng dẫn bạn xuất tệp cấu hình và sử dụng tệp đó trong CLI thông qua --database-connection <path>.

Nên lưu chi tiết "database connection" dưới dạng biến, để không cần thêm --database-connection <path> khi chạy CLI, đồng thời cũng thuận tiện hơn cho việc cộng tác và bảo trì. Tìm hiểu thêm.

Báo Cáo Kiểm Thử CLI

Sau khi chạy CLI, bạn sẽ nhận được báo cáo kiểm thử trên dòng lệnh chứa thống kê thực thi của bộ kiểm thử, cũng như thông tin xác thực và khẳng định cho các yêu cầu thất bại.

CleanShot 2026-01-13 lúc 15.52.03@2x.png

Trong thư mục nơi CLI được chạy, bạn cũng có thể tìm thấy thư mục /apidog-reports/, thư mục này chứa các báo cáo kiểm thử CLI ở định dạng HTML.

Tùy Chọn Lệnh

Apidog CLI cung cấp nhiều tùy chọn cấu hình phong phú để tùy chỉnh việc thực thi các bộ kiểm thử. Để biết chi tiết, xem Tùy Chọn Lệnh CLI.

Sử Dụng Apidog CLI trong CI/CD

Apidog CLI hỗ trợ tích hợp với nhiều công cụ pipeline khác nhau như Jenkins, GitLab, GitHub Actions, v.v. Để tìm hiểu thêm, xem Tích Hợp CI/CD.

Chạy Bộ Kiểm Thử Qua CLI

Lựa Chọn Phương Thức Chạy Phù Hợp#

Chạy Apidog CLI#

Về Biến và Tệp Cấu Hình Cục Bộ (Tùy Chọn)#

Báo Cáo Kiểm Thử CLI#

Tùy Chọn Lệnh#

Sử Dụng Apidog CLI trong CI/CD#

Lựa Chọn Phương Thức Chạy Phù Hợp

Chạy Apidog CLI

Về Biến và Tệp Cấu Hình Cục Bộ (Tùy Chọn)

Báo Cáo Kiểm Thử CLI

Tùy Chọn Lệnh

Sử Dụng Apidog CLI trong CI/CD