Tích hợp với Github Actions
Apidog hỗ trợ chạy kiểm thử tự động trong bất kỳ pipeline CI/CD nào thông qua một lệnh CLI đơn giản. Dù bạn đang sử dụng GitHub Actions, GitLab CI, Jenkins hay một trình xử lý webhook tùy chỉnh, bạn đều có thể tự động kích hoạt các kiểm thử Apidog bất cứ khi nào kho lưu trữ Git của bạn được cập nhật.Điều kiện tiên quyết#
Tài khoản GitHub và kho lưu trữ
Tài khoản Apidog đã tạo các kịch bản kiểm thử
Quyền truy cập để tạo Apidog access token
Cách hoạt động#
Việc tích hợp dựa trên một nguyên tắc đơn giản: Git Webhook + Thực thi CLI.Khi một sự kiện Git (chẳng hạn như push hoặc pull request) xảy ra, công cụ CI/CD của bạn sẽ nhận sự kiện và chạy lệnh apidog run để thực thi các kịch bản kiểm thử của bạn.Hướng dẫn này sử dụng GitHub Actions làm ví dụ—vì công cụ này được sử dụng rộng rãi và không yêu cầu hạ tầng bổ sung. Tuy nhiên, cùng một phương pháp cũng áp dụng cho các nền tảng khác.Thiết lập này lý tưởng để:Tự động chạy kiểm thử API trên mỗi lần push hoặc pull request
Giám sát các nhánh cụ thể (ví dụ: main, develop)
Hỗ trợ kiểm tra trước khi triển khai và kiểm thử hồi quy
Đảm bảo việc thực thi kiểm thử nhất quán trong các quy trình CI của bạn
Bước 1: Khởi tạo GitHub Workflow#
1.
Truy cập GitHub và đăng nhập vào tài khoản của bạn. 2.
Điều hướng đến kho lưu trữ mục tiêu của bạn.
3.
Nhấp vào tab "Actions" trên thanh điều hướng phía trên.
4.
Nếu đây là lần đầu tiên bạn thiết lập Actions trong repo, hãy nhấp vào "New workflow" để tạo một workflow.
Bước 2: Tạo cấu hình GitHub Actions trong Apidog#
1.
Trong Apidog, mở dự án của bạn và đi tới trang "Tests".
3.
Cấu hình môi trường kiểm thử, quyết định có bật dữ liệu kiểm thử hay không, đồng thời thiết lập số vòng lặp và khoảng thời gian trễ.
4.
Chọn "GitHub Actions", sau đó nhấp vào "Copy".
Bước 3: Dán và commit workflow trong GitHub#
1.
Quay lại kho lưu trữ GitHub của bạn và mở trang Actions.
2.
Tạo một workflow mới và dán mã cấu hình đã sao chép từ Apidog.
3.
Nếu bạn đã có một pipeline CI hiện có, bạn có thể hợp nhất cấu hình kiểm thử Apidog vào đó.
4.
Nhấp vào "Commit changes" để lưu và bật workflow.
Vui lòng đảm bảo thay thế biến $APIDOG_ACCESS_TOKEN trong mã bằng Access Token thực tế của bạn. .github/workflows/.
Tệp này là một phần của mã nguồn và sẽ được bao gồm khi bạn clone hoặc pull dự án về máy cục bộ. Bạn có thể chỉnh sửa tệp trong môi trường phát triển cục bộ và commit các thay đổi thông qua Git giống như bất kỳ tệp nào khác.Phần đầu của tệp workflow chứa một dòng như sau:Dòng này cho GitHub biết rằng cần tự động kích hoạt workflow bất cứ khi nào có người push mã hoặc mở/cập nhật một pull request. Đây là cú pháp rút gọn tương đương với một phiên bản dài dòng hơn và hoạt động tốt cho hầu hết các tình huống CI.Bước 4: Chạy workflow và xem kết quả#
Sau khi được cấu hình, GitHub Actions workflow sẽ tự động chạy bất cứ khi nào có một commit mã mới. Bạn có thể theo dõi trạng thái của workflow và kết quả kiểm thử trên trang Actions. Modified at 2026-06-11 10:23:06
