Menjalankan Suite Pengujian Melalui CLI

Memilih Metode Eksekusi yang Sesuai

Apidog menyediakan berbagai cara untuk menjalankan suite pengujian, yang sesuai untuk kebutuhan pengujian yang berbeda.

Eksekusi Visual Lokal:

Metode ini dimulai dari mesin lokal dan sesuai untuk pengujian cepat berskala kecil.

Metode ini sangat efektif ketika pengembangan dan pengujian berlangsung secara bersamaan, sehingga memungkinkan pemantauan secara real-time dan penyesuaian segera.

Eksekusi Apidog CLI Lokal:

Ideal untuk menangani data berskala besar atau skenario iteratif, metode ini menawarkan kecepatan eksekusi yang lebih tinggi.

Metode ini mampu berjalan secara offline, sehingga sesuai untuk lingkungan dengan sumber daya terbatas atau yang tidak memerlukan antarmuka pengguna grafis.

Eksekusi CI/CD:

Gaya eksekusi ini terintegrasi dalam pipeline CI/CD, sehingga menjadi opsi yang sangat baik untuk proses integrasi otomatis dan deployment berkelanjutan.

Metode ini sangat berguna dalam lingkungan tempat pengujian sering dijalankan untuk memastikan stabilitas API setelah setiap pembaruan kode.

Eksekusi Self-Hosting Runner:

Tim dapat menyiapkan Apidog Runner di server mereka sendiri, dengan memanfaatkan sumber daya komputasi yang lebih kuat untuk pengujian.

Metode ini mencakup dukungan untuk tugas terjadwal, sehingga ideal untuk skenario yang memerlukan pengujian rutin atau yang memiliki tuntutan pengujian signifikan.

TIP

Dalam suite pengujian, jika variabel lingkungan/global digunakan, nilai aktual variabel tersebut dapat berbeda bergantung pada metode eksekusi yang dipilih, yang dapat menyebabkan hasil pengujian tidak konsisten. Pelajari lebih lanjut.

Menjalankan Apidog CLI

Untuk menjalankan suite pengujian menggunakan Apidog CLI, Anda terlebih dahulu perlu membuat dan mengorkestrasi suite pengujian. Kemudian, Anda dapat menjalankan suite pengujian dari command line menggunakan Apidog CLI dan memperoleh hasil pengujian serta laporan pengujian.

Dalam suite pengujian, beralihlah ke tab CI/CD.

Konfigurasikan parameter seperti lingkungan eksekusi dan metode notifikasi. Setiap konfigurasi pada antarmuka akan tercermin secara real-time dalam perintah CLI yang dihasilkan di bawah ini.

Di bagian penyedia CI/CD, pilih baris perintah CLI atau platform lain.

Klik tombol "Add access token", lalu "Generate token" untuk autentikasi panggilan CLI. Pelajari lebih lanjut.

Klik untuk menyalin perintah, tempelkan ke command line, lalu jalankan untuk melihat proses eksekusi pengujian dan laporan pengujian.

Catatan: Agar perintah berhasil dijalankan, Anda perlu terlebih dahulu menginstal Apidog CLI. Jika sudah terinstal, Anda perlu memperbaruinya ke versi terbaru.

Tentang Variabel dan File Konfigurasi Lokal (Opsional)

Dalam beberapa skenario, eksekusi CLI memerlukan file konfigurasi lokal:

Variabel Lingkungan / Global

Jika Anda memilih "Export current values for use", Anda perlu menempatkan file variabel yang diekspor pada mesin eksekusi CLI dan menentukan jalur file melalui --variables <path>.

Untuk perbedaan antara "Use initial Values" dan "Export current values for use", lihat: Aturan penggunaan variabel lingkungan/global di berbagai metode eksekusi.

Koneksi Database

Jika pengujian menggunakan "database connections" yang disimpan secara lokal, antarmuka akan memandu Anda untuk mengekspor file konfigurasi dan menggunakannya di CLI melalui --database-connection <path>.

Disarankan untuk menyimpan detail "database connection" dalam bentuk variabel, sehingga tidak diperlukan tambahan --database-connection <path> saat menjalankan CLI, dan hal ini juga lebih praktis untuk kolaborasi serta pemeliharaan. Pelajari lebih lanjut.

Laporan Pengujian CLI

Setelah menjalankan CLI, Anda akan memperoleh laporan pengujian command-line yang berisi statistik eksekusi suite pengujian, serta informasi validasi dan aservi untuk permintaan yang gagal.

Di folder tempat CLI dijalankan, Anda juga dapat menemukan folder /apidog-reports/, yang berisi laporan pengujian CLI dalam format HTML.

Opsi Perintah

Apidog CLI menyediakan opsi konfigurasi yang kaya untuk menyesuaikan eksekusi suite pengujian. Untuk detailnya, lihat Opsi Perintah CLI.

Menggunakan Apidog CLI dalam CI/CD

Apidog CLI mendukung integrasi dengan berbagai alat pipeline seperti Jenkins, GitLab, GitHub Actions, dll. Untuk mempelajari lebih lanjut, lihat Integrasi CI/CD.

Menjalankan Suite Pengujian Melalui CLI

Memilih Metode Eksekusi yang Sesuai#

Menjalankan Apidog CLI#

Tentang Variabel dan File Konfigurasi Lokal (Opsional)#

Laporan Pengujian CLI#

Opsi Perintah#

Menggunakan Apidog CLI dalam CI/CD#

Memilih Metode Eksekusi yang Sesuai

Menjalankan Apidog CLI

Tentang Variabel dan File Konfigurasi Lokal (Opsional)

Laporan Pengujian CLI

Opsi Perintah

Menggunakan Apidog CLI dalam CI/CD