Apidog Runner adalah alat baris perintah yang menjalankan pengujian API terjadwal dan tugas otomatisasi di lingkungan server. Panduan referensi ini menguraikan persyaratan perangkat keras, runtime, dan jaringan untuk men-deploy Runner di lingkungan produksi atau CI/CD.Memahami persyaratan ini memastikan kinerja dan keandalan yang optimal saat menjalankan pengujian API otomatis dalam skala besar.Persyaratan Perangkat Keras#
Konfigurasi Server yang Direkomendasikan#
| Komponen | Persyaratan Minimum | Direkomendasikan | Tujuan |
|---|
| CPU | 2 core | 4+ core | Runner menjalankan tugas terjadwal secara bersamaan, sehingga memerlukan daya pemrosesan yang memadai |
| Memori | RAM 4GB | RAM 8GB+ | Runner memuat dan menghasilkan data dalam jumlah besar selama tugas terjadwal; tim yang lebih besar memerlukan lebih banyak memori |
| Ruang Disk | 30GB | 50GB+ | Mengakomodasi penyimpanan log dan artefak pengujian |
Untuk tim yang lebih besar atau eksekusi pengujian berfrekuensi tinggi, tingkatkan memori menjadi 8GB atau lebih untuk mencegah penurunan kinerja.
Parameter Runtime#
Konfigurasikan variabel lingkungan berikut saat men-deploy Runner:| Nama Parameter | Deskripsi | Nilai Contoh |
|---|
TZ | Konfigurasikan zona waktu untuk eksekusi Runner. Tugas terjadwal akan berjalan sesuai dengan zona waktu dan waktu yang ditetapkan. Lihat TZ identifier untuk konfigurasi. | America/Los_Angeles |
Pengguna Runtime Kontainer dan runAsNonRoot#
Mulai dari Runner versi 2.2.5, image menyertakan pengguna non-root runner dengan UID/GID tetap 10001:10001 untuk mendukung mode runtime non-root yang lebih aman.Dengan metode startup default, kontainer terlebih dahulu menjalankan skrip entrypoint sebagai root, menyiapkan izin untuk direktori /opt/runner, lalu menurunkan hak istimewa untuk menjalankan proses utama sebagai pengguna runner. Ini kompatibel dengan izin volume historis dan mencegah data runtime seperti log dan file variabel gagal ditulis.Jika platform deployment memberlakukan runAsNonRoot, konfigurasikan konteks keamanan kontainer sebagai berikut:Setelah ini diaktifkan, skrip entrypoint tidak lagi dapat menjalankan mkdir atau chown. Oleh karena itu, setiap hostPath, PVC, atau volume lain yang dipasang ke /opt/runner harus diberi izin tulis untuk UID/GID 10001 terlebih dahulu. Runner menulis data runtime ke direktori seperti /opt/runner/logs dan /opt/runner/variables. Jika izin tidak memadai, eksekusi tugas dapat gagal atau log mungkin tidak ditulis.Saat menggunakan hostPath, Anda dapat menjalankan perintah berikut pada host terlebih dahulu:Jika tidak ada persyaratan wajib untuk mengaktifkan runAsNonRoot, kami merekomendasikan untuk tetap menggunakan metode startup default.Lingkungan Jaringan#
Persyaratan Komunikasi Server#
Runner perlu berkomunikasi dengan server Apidog. Pastikan bahwa lingkungan jaringan server yang menjalankan Runner dapat mengakses server Apidog dan mendukung protokol WebSocket.Protokol yang Diperlukan:Pastikan firewall Anda mengizinkan koneksi keluar ke server Apidog pada port 443 (HTTPS) dan koneksi WebSocket untuk komunikasi real-time.
Persyaratan Pengujian Otomatis#
Untuk tugas terjadwal bagi pengujian otomatis, lingkungan jaringan server harus dapat mengakses semua URL yang diminta untuk memulai permintaan secara normal. Setelah menjalankan pengujian otomatis, laporan pengujian akan diunggah—pastikan lingkungan jaringan server dapat mengakses nama domain AWS.Persyaratan Impor Data#
Untuk tugas terjadwal yang mengimpor data, pastikan lingkungan jaringan server dapat mengakses URL sumber data yang akan diimpor. 