DEV Community

Cover image for Alat CLI Gratis Open Source untuk Manajemen API
Walse
Walse

Posted on • Originally published at apidog.com

Alat CLI Gratis Open Source untuk Manajemen API

Manajemen API dahulu identik dengan konsol GUI dan tagihan vendor. Sekarang, banyak pekerjaan operasional dilakukan dari terminal: definisikan rute, plugin, dan rate limit dalam file konfigurasi, simpan di Git, lalu dorong perubahan ke gateway melalui CLI. Hasilnya, konfigurasi yang ditinjau di pull request sama dengan konfigurasi yang diterapkan.

Coba Apidog hari ini

Aspek sumber terbuka juga penting. Jika Anda menjalankan gateway sendiri, lisensi menentukan apa yang dapat di-host sendiri, di-fork, dimodifikasi, dan dikirim tanpa biaya per pengguna. Sebagian besar alat di bawah menggunakan Apache 2.0 atau MPL 2.0, sehingga sumber tersedia, dapat dijalankan di infrastruktur sendiri, dan tidak memiliki biaya per pengguna bawaan.

Artikel ini membahas gateway sumber terbuka dengan alur kerja CLI yang nyata: Kong Gateway OSS dengan decK, Tyk, KrakenD Community Edition, Apache APISIX, dan Gravitee. Untuk setiap alat, Anda akan melihat lisensi, fungsi CLI, serta perintah yang dapat langsung dicoba. Jika Anda membutuhkan cakupan yang lebih luas, rangkuman alat manajemen API sumber terbuka juga membahas platform manajemen API. Anda juga dapat meninjau teks lisensi Apache 2.0 resmi.

Satu catatan penting: Apidog dibahas di bagian akhir, tetapi bukan sebagai entri sumber terbuka. Apidog adalah produk komersial dengan tier gratis, sehingga posisinya berbeda dari gateway OSS yang dapat Anda host sendiri.

Apa yang membuat alat CLI “sumber terbuka” untuk manajemen API

Gunakan tiga kriteria berikut saat mengevaluasi alat.

1. Lisensi

Periksa lisensi gateway inti, bukan hanya SDK atau kliennya. Lisensi Apache 2.0, MIT, dan MPL 2.0 adalah indikator umum untuk proyek sumber terbuka.

  • Apache 2.0 memungkinkan hosting mandiri dan modifikasi.
  • MPL 2.0 adalah copyleft tingkat file. Perubahan pada file MPL harus tetap terbuka, tetapi kode proprietary dapat digabungkan selama berada di file terpisah.
  • Label seperti source-available atau BSL tidak setara dengan lisensi sumber terbuka tersebut.

Selalu baca file LICENSE di repositori sebelum menjadikan alat sebagai bagian dari platform Anda.

2. Hosting mandiri

Gateway harus dapat berjalan di infrastruktur Anda tanpa ketergantungan pada server lisensi vendor. Anda perlu mengontrol data plane, konfigurasi, dan proses deployment.

3. Repositori aktif dan CLI yang dapat digunakan

Jangan hanya melihat jumlah bintang GitHub. Periksa riwayat commit, rilis, isu, dan dokumentasi. Untuk alur kerja berbasis Git, gateway idealnya dapat dikonfigurasi secara deklaratif, divalidasi dari CLI, dan dijalankan dalam CI.

Untuk konteks yang lebih umum, lihat cakupan manajemen API.

Kong Gateway OSS dengan decK

Kong Gateway OSS adalah build Kong berlisensi Apache 2.0. Gateway dikonfigurasi melalui Admin API, sementara decK menyediakan alur kerja konfigurasi deklaratif yang cocok untuk GitOps.

Dengan decK, Anda dapat mengekspor status gateway ke YAML, meninjaunya dalam pull request, lalu menyinkronkan perubahan kembali ke Kong.

# Ekspor konfigurasi Kong saat ini ke file YAML
deck gateway dump -o kong.yaml

# Tinjau perubahan terlebih dahulu
deck gateway diff kong.yaml

# Dorong konfigurasi deklaratif ke gateway
deck gateway sync kong.yaml
Enter fullscreen mode Exit fullscreen mode

Alur kerja CI yang umum:

# Contoh langkah CI
deck gateway validate kong.yaml
deck gateway diff kong.yaml
deck gateway sync kong.yaml
Enter fullscreen mode Exit fullscreen mode

Terbaik untuk: konfigurasi Kong sebagai infrastruktur-sebagai-kode (IaC), dengan rute dan plugin yang disimpan di Git.

Batasan: decK spesifik untuk Kong dan berfokus pada konfigurasi gateway, bukan desain API, dokumentasi, atau pengujian endpoint. Tumpukan Kong juga lebih berat daripada gateway satu-biner.

Tyk

Tyk Gateway adalah proyek sumber terbuka berlisensi Mozilla Public License 2.0. Gateway intinya ditulis dalam Go dan mendukung REST, GraphQL, TCP, serta gRPC.

CLI yang sering digunakan adalah bundler untuk mengemas plugin middleware kustom menjadi bundle yang dapat dimuat gateway.

# Bangun bundle plugin dari manifest dan file middleware
tyk bundle build -o bundle.zip
Enter fullscreen mode Exit fullscreen mode

Gunakan proses ini saat plugin Anda perlu dibangun dan dirilis secara konsisten dari CI:

# Contoh artefak yang dapat diunggah atau dipasang saat deployment
tyk bundle build -o dist/auth-plugin.zip
Enter fullscreen mode Exit fullscreen mode

Terbaik untuk: tim yang perlu menambahkan autentikasi, transformasi, atau middleware kustom melalui plugin yang dapat dibundel secara berulang.

Batasan: CLI Tyk tidak menyediakan konfigurasi deklaratif lengkap untuk seluruh gateway. Banyak operasi manajemen dilakukan melalui Dashboard Tyk yang berbayar atau langsung melalui Gateway API.

KrakenD Community Edition

KrakenD Community Edition adalah gateway tanpa status berlisensi Apache 2.0. Tidak ada basis data bawaan; perilaku gateway ditentukan oleh file konfigurasi. Ini membuatnya cocok untuk Git, code review, dan CI.

CLI krakend menyediakan perintah untuk memvalidasi konfigurasi dan menjalankan gateway.

# Validasi dan lint konfigurasi sebelum deployment
krakend check -c krakend.json --lint

# Jalankan gateway
krakend run -c krakend.json
Enter fullscreen mode Exit fullscreen mode

Masukkan validasi ke pipeline sebelum image atau konfigurasi diterapkan:

#!/usr/bin/env bash
set -euo pipefail

krakend check -c krakend.json --lint
krakend run -c krakend.json
Enter fullscreen mode Exit fullscreen mode

Gunakan Flexible Configuration dengan FC_ENABLE=1 jika konfigurasi perlu dipecah menjadi template dan variabel lingkungan.

FC_ENABLE=1 krakend check -c krakend.json --lint
Enter fullscreen mode Exit fullscreen mode

Terbaik untuk: gateway deklaratif tanpa status, ketika file konfigurasi menjadi satu-satunya sumber kebenaran.

Batasan: Community Edition tidak memiliki persistensi bawaan atau UI admin. Semua perilaku dibangun melalui konfigurasi, yang ideal untuk IaC tetapi membutuhkan disiplin konfigurasi.

Apache APISIX

Apache APISIX adalah proyek tingkat atas Apache Software Foundation dengan lisensi Apache 2.0. APISIX menyediakan CLI untuk operasi siklus hidup gateway dan Admin API untuk mengelola rute serta plugin.

CLI digunakan untuk memulai, menghentikan, dan memuat ulang APISIX. Reload memungkinkan perubahan konfigurasi diterapkan tanpa menjatuhkan koneksi aktif.

# Lihat perintah kontrol yang tersedia
apisix help

# Mulai gateway
apisix start

# Terapkan perubahan konfigurasi tanpa restart penuh
apisix reload
Enter fullscreen mode Exit fullscreen mode

Untuk perubahan rute dinamis, biasanya Anda mengotomatisasikan Admin API dari pipeline deployment.

# Contoh pola: gunakan skrip untuk memanggil Admin API
curl http://127.0.0.1:9180/apisix/admin/routes/1 \
  -H 'X-API-KEY: <ADMIN_API_KEY>' \
  -X PUT \
  -d '{
    "uri": "/api/users",
    "upstream": {
      "type": "roundrobin",
      "nodes": {
        "users-service:8080": 1
      }
    }
  }'
Enter fullscreen mode Exit fullscreen mode

Terbaik untuk: perutean dinamis dan throughput tinggi, terutama saat rute atau plugin perlu diperbarui saat runtime.

Batasan: konfigurasi perutean biasanya dikelola melalui Admin API, bukan satu file deklaratif yang didorong langsung dari CLI. Untuk GitOps, Anda perlu membuat skrip Admin API atau menambahkan alat seperti APISIX ADC.

Gravitee

Platform inti Gravitee berlisensi Apache 2.0. Community Edition mencakup APIM Gateway sebagai runtime, APIM API sebagai antarmuka REST manajemen, dan APIM Console.

Operasi harian Gravitee umumnya dilakukan melalui REST Management API dan Console. Instalasi mandiri sering dijalankan melalui Docker CLI.

# Jalankan container gateway Gravitee APIM
docker run --name gravitee-gateway \
  -p 8082:8082 \
  graviteeio/apim-gateway:latest
Enter fullscreen mode Exit fullscreen mode

Untuk deployment yang dapat diulang, gunakan Docker Compose atau manifest orkestrator Anda sendiri:

docker compose up -d
docker compose logs -f gravitee-gateway
Enter fullscreen mode Exit fullscreen mode

Ada graviteeio-cli yang dikelola komunitas dan membungkus Management API untuk otomatisasi lintas modul. Namun, ini bukan CLI resmi pihak pertama, jadi periksa aktivitas pemeliharaan proyek sebelum menjadikannya dependensi utama.

Terbaik untuk: tim yang memerlukan lapisan manajemen API OSS lengkap, termasuk gateway, konsol, dan API manajemen untuk scripting.

Batasan: otomatisasi pihak pertama berpusat pada REST Management API, bukan satu CLI terpadu. CLI komunitas dapat membantu, tetapi membawa risiko pemeliharaan tambahan.

Di mana Apidog cocok dan mengapa tidak ada di daftar sumber terbuka

Apidog bukan perangkat lunak sumber terbuka, sehingga tidak dimasukkan ke daftar gateway OSS di atas. Apidog adalah produk komersial dengan tier gratis.

Gateway menangani lalu lintas, rute, autentikasi, dan plugin. Namun, gateway tidak secara otomatis menangani desain skema API, pengujian endpoint, dokumentasi, atau mocking sebelum backend tersedia.

Tanpa platform terintegrasi, pekerjaan tersebut sering membutuhkan beberapa alat terpisah: Spectral, openapi-generator, mock server, dan Newman, masing-masing dengan konfigurasi sendiri. Apidog menggabungkan desain, pengujian, mocking, dan dokumentasi dalam satu workspace, dengan apidog-cli untuk otomatisasi terminal.

# Instal Apidog CLI
npm install -g apidog-cli

# Autentikasi menggunakan token
apidog login --with-token <TOKEN>

# Jalankan skenario pengujian di CI
# Perintah keluar dengan status non-nol jika pengujian gagal
apidog run
Enter fullscreen mode Exit fullscreen mode

Contoh langkah CI:

set -euo pipefail

apidog login --with-token "$APIDOG_TOKEN"
apidog run
Enter fullscreen mode Exit fullscreen mode

CLI menghasilkan JSON terstruktur dengan agentHints.nextSteps, sehingga dapat digunakan dalam CI dan alur kerja agen AI. Jika Anda menjalankan pekerjaan API melalui Claude Code atau alat serupa, baca panduan mengelola API tanpa meninggalkan agen AI.

Apidog CLI juga mendukung impor dan ekspor OpenAPI, menjalankan skenario, serta mendorong mock dari terminal. Lihat panduan lengkap Apidog CLI untuk daftar grup perintah.

Anggap Apidog sebagai opsi terintegrasi di samping gateway OSS yang di-host sendiri, bukan sebagai pengganti gateway.

Cara memilih

Alat Terbaik untuk Lisensi Sumber terbuka? CLI/perintah
Kong Gateway OSS + decK Konfigurasi IaC untuk Kong di Git Apache 2.0 Ya deck gateway sync
Tyk Bundling plugin kustom dan multi-protokol MPL 2.0 Ya tyk bundle build
KrakenD CE Gateway tanpa status dan konfigurasi-sebagai-kode Apache 2.0 Ya krakend run
Apache APISIX Perutean dinamis dengan throughput tinggi Apache 2.0 Ya, proyek ASF apisix start / apisix reload
Gravitee Lapisan manajemen OSS lengkap dengan konsol Apache 2.0 Ya, untuk inti Docker CLI / REST API
Apidog CLI Desain, pengujian, mock, dan dokumentasi terpadu Freemium Tidak apidog run

Pilih berdasarkan alur kerja deployment, bukan hanya jumlah bintang GitHub.

  • Sudah menggunakan Kong? Mulai dengan decK.
  • Membutuhkan gateway tanpa status yang seluruhnya didefinisikan oleh file? Gunakan KrakenD.
  • Memerlukan pembaruan rute saat runtime? Pertimbangkan APISIX.
  • Memerlukan gateway sekaligus konsol manajemen OSS? Gunakan Gravitee.
  • Memerlukan desain, pengujian, mocking, dan dokumentasi di luar fungsi gateway? Tambahkan Apidog ke alur kerja Anda.

Untuk perbandingan yang lebih luas, lihat alat manajemen API terbaik untuk tahun 2026 dan pembahasan tentang manajemen API tanpa kepala.

Kesimpulan

Manajemen API sumber terbuka berbasis CLI sudah matang. Kong Gateway OSS dengan decK, Tyk, KrakenD CE, Apache APISIX, dan Gravitee dapat di-host sendiri serta dikendalikan dari terminal. Dengan demikian, konfigurasi dapat masuk ke Git, ditinjau melalui pull request, dan diterapkan melalui CI.

Pilih gateway berdasarkan model operasional Anda:

  1. Gunakan konfigurasi deklaratif jika Git adalah sumber kebenaran.
  2. Validasi konfigurasi sebelum deployment.
  3. Otomatiskan deployment gateway melalui CI.
  4. Gunakan Admin API secara terkontrol jika gateway mendukung perubahan runtime.
  5. Tambahkan alat desain dan pengujian API jika kebutuhan Anda melampaui routing dan plugin.

Untuk desain, pengujian, mocking, dan dokumentasi, unduh Apidog lalu jalankan apidog run dalam pipeline Anda di samping gateway OSS yang digunakan.

Top comments (0)