Apidog Runner là một công cụ dòng lệnh thực thi các kiểm thử API được lập lịch và các tác vụ tự động hóa trong môi trường máy chủ. Hướng dẫn tham khảo này trình bày các yêu cầu về phần cứng, runtime và mạng để triển khai Runner trong môi trường production hoặc CI/CD.Việc hiểu rõ các yêu cầu này giúp đảm bảo hiệu năng và độ tin cậy tối ưu khi chạy kiểm thử API tự động ở quy mô lớn.Yêu cầu phần cứng#
Cấu hình máy chủ được khuyến nghị#
| Thành phần | Yêu cầu tối thiểu | Khuyến nghị | Mục đích |
|---|
| CPU | 2 lõi | 4+ lõi | Runner thực thi đồng thời các tác vụ được lập lịch, do đó cần đủ năng lực xử lý |
| Memory | 4GB RAM | 8GB+ RAM | Runner tải và tạo ra lượng dữ liệu lớn trong quá trình thực thi các tác vụ được lập lịch; các nhóm lớn hơn cần nhiều bộ nhớ hơn |
| Disk Space | 30GB | 50GB+ | Đáp ứng nhu cầu lưu trữ nhật ký và các hiện vật kiểm thử |
Đối với các nhóm lớn hơn hoặc tần suất thực thi kiểm thử cao, hãy tăng bộ nhớ lên 8GB trở lên để tránh suy giảm hiệu năng.
Tham số runtime#
Cấu hình các biến môi trường sau khi triển khai Runner:| Tên tham số | Mô tả | Giá trị ví dụ |
|---|
TZ | Cấu hình múi giờ cho việc thực thi Runner. Các tác vụ được lập lịch sẽ chạy theo múi giờ và thời gian đã đặt. Tham khảo TZ identifier để cấu hình. | America/Los_Angeles |
Người dùng runtime của container và runAsNonRoot#
Bắt đầu từ phiên bản Runner 2.2.5, image bao gồm người dùng không phải root runner với UID/GID cố định là 10001:10001 để hỗ trợ chế độ runtime không phải root an toàn hơn.Với phương thức khởi động mặc định, trước tiên container chạy tập lệnh entrypoint với quyền root, chuẩn bị quyền cho thư mục /opt/runner, sau đó hạ đặc quyền để chạy tiến trình chính với người dùng runner. Cách này tương thích với các quyền volume trước đây và ngăn dữ liệu runtime như nhật ký và tệp biến gặp lỗi khi ghi.Nếu nền tảng triển khai bắt buộc runAsNonRoot, hãy cấu hình security context của container như sau:Sau khi tùy chọn này được bật, tập lệnh entrypoint không còn có thể thực thi mkdir hoặc chown. Do đó, mọi hostPath, PVC hoặc volume khác được mount vào /opt/runner phải được cấp quyền ghi trước cho UID/GID 10001. Runner ghi dữ liệu runtime vào các thư mục như /opt/runner/logs và /opt/runner/variables. Nếu quyền không đủ, việc thực thi tác vụ có thể thất bại hoặc nhật ký có thể không được ghi.Khi sử dụng hostPath, bạn có thể chạy lệnh sau trên máy chủ trước:Nếu không có yêu cầu bắt buộc phải bật runAsNonRoot, chúng tôi khuyến nghị giữ phương thức khởi động mặc định.Môi trường mạng#
Yêu cầu giao tiếp với máy chủ#
Runner cần giao tiếp với máy chủ Apidog. Hãy đảm bảo rằng môi trường mạng của máy chủ thực thi Runner có thể truy cập máy chủ Apidog và hỗ trợ giao thức WebSocket.Đảm bảo tường lửa của bạn cho phép các kết nối đi đến máy chủ Apidog trên cổng 443 (HTTPS) và các kết nối WebSocket để giao tiếp theo thời gian thực.
Yêu cầu kiểm thử tự động#
Đối với các tác vụ được lập lịch cho kiểm thử tự động, môi trường mạng của máy chủ phải có khả năng truy cập tất cả các URL được yêu cầu để khởi tạo yêu cầu bình thường. Sau khi chạy kiểm thử tự động, báo cáo kiểm thử sẽ được tải lên—vui lòng đảm bảo rằng môi trường mạng của máy chủ có thể truy cập các tên miền AWS.Yêu cầu nhập dữ liệu#
Đối với các tác vụ được lập lịch để nhập dữ liệu, hãy đảm bảo rằng môi trường mạng của máy chủ có thể truy cập URL của nguồn dữ liệu cần nhập. 