All Products
Search
Document Center

API Gateway:Manajemen APIG Ingress

Last Updated:May 08, 2026

APIG Ingress adalah produk enterprise-grade berbasis gateway open source Higress yang kompatibel dengan Nginx Ingress dan dirancang untuk skenario manajemen API serta microservice.

Konsep Ingress

Dalam kluster Kubernetes, Ingress berfungsi sebagai titik akses untuk mengekspos layanan internal. Ingress menyediakan load balancing lapisan 7 dan menangani sebagian besar lalu lintas yang diarahkan ke layanan dalam kluster. Ingress merupakan objek resource Kubernetes yang mengatur cara klien eksternal mengakses layanan di dalam kluster. Anda dapat mengonfigurasi resource Ingress dengan aturan pengalihan untuk mengarahkan permintaan ke Pod backend dari berbagai Service berdasarkan konten permintaan. Resource Ingress standar hanya mendukung aturan lalu lintas HTTP dan tidak mencakup fitur lanjutan seperti algoritma penyeimbangan beban atau afinitas sesi. Kemampuan tersebut memerlukan implementasi Ingress tertentu, seperti Nginx Ingress atau APIG Ingress.

Fitur APIG Ingress

Cara menggunakan APIG Ingress

APIG Ingress menyediakan kemampuan manajemen lalu lintas yang kuat berbasis gateway API cloud-native. Sebagai peningkatan dari MSE Cloud Native Gateway, APIG Ingress kompatibel dengan Nginx Ingress dan lebih dari 50 anotasinya, mencakup lebih dari 90% kasus penggunaan Nginx Ingress. APIG Ingress mendukung rilis canary lintas beberapa versi layanan, tata kelola lalu lintas yang fleksibel, serta perlindungan keamanan komprehensif untuk memenuhi kebutuhan aplikasi terdistribusi cloud-native berskala besar. Selain kompatibilitas dengan Nginx Ingress, APIG Ingress juga memperkenalkan anotasi tambahan untuk meningkatkan tata kelola lalu lintas dan keamanan. Untuk informasi selengkapnya, lihat Penggunaan lanjutan APIG Ingress.

Setelah Anda men-deploy APIG Controller di kluster, komponen tersebut akan mendengarkan resource ApigConfig. Komponen ini secara dinamis mengelola siklus hidup instans gateway API cloud-native, konfigurasi parameter global, serta opsi listener untuk resource Ingress. Gateway API cloud-native mendengarkan dan mengonversi resource Ingress dari kluster Kubernetes menjadi konfigurasi tata kelola lalu lintas yang diperlukan untuk mengekspos layanan internal. Untuk langkah-langkah detailnya, lihat Buat dan gunakan APIG Ingress untuk mengekspos layanan.

Penting

APIG Ingress merupakan versi peningkatan dari MSE Ingress. Di wilayah yang mendukung baik APIG Ingress maupun MSE Ingress, Konsol ACK hanya menampilkan opsi APIG Ingress. Perubahan ini tidak memengaruhi pengguna MSE Ingress yang sudah ada, yang tetap dapat membuat dan mengelola MSE Ingress mereka. Untuk menggunakan MSE Ingress, submit a ticket untuk menghubungi tim APIG.

Cara kerja APIG Ingress

Komponen

  • APIG Controller:

    • APIG Controller merupakan lapisan kontrol, bukan bidang data jaringan. Komponen ini mengelola instans gateway API cloud-native beserta konfigurasinya. APIG Controller tidak memproses lalu lintas layanan apa pun. Komponen ini beroperasi dalam mode bypass dan mengelola instans gateway API cloud-native yang menangani lalu lintas layanan sesungguhnya.

    • Di dalam kluster, instal komponen APIG Controller. Gunakan Custom Resource Definition (CRD) ApigConfig yang disediakan oleh komponen tersebut untuk mengelola instans gateway API cloud-native secara deklaratif dan mengatur opsi listener gateway untuk resource Ingress.

  • Cloud-native API gateway:

    APIG Controller membuat gateway API cloud-native berdasarkan resource ApigConfig yang dikonfigurasi. Gateway ini terdiri atas lapisan kontrol dan bidang data.

    • Lapisan kontrol: Lapisan kontrol mendengarkan resource seperti Ingress, IngressClass, dan Service di kluster layanan kontainer terkait. Komponen ini mengurai resource tersebut dan mengirimkan konfigurasi hasilnya ke bidang data secara real time.

    • Bidang data: Bidang data menerapkan konfigurasi tata kelola lalu lintas. Komponen ini memproses permintaan eksternal berdasarkan aturan dari lapisan kontrol dan meneruskan permintaan tersebut ke layanan target backend.

Cara kerjanya

APIG Controller mendengarkan resource ApigConfig yang dibuat di kluster. Komponen ini secara dinamis memelihara siklus hidup instans gateway API cloud-native yang sesuai serta asosiasi antara gateway dan kluster layanan kontainer secara real time.

Lapisan kontrol gateway API cloud-native mengambil perubahan resource Ingress dari server API kluster layanan kontainer terkait. Komponen tersebut kemudian memperbarui aturan routing gateway secara dinamis. Saat gateway API cloud-native menerima permintaan, permintaan tersebut dicocokkan dengan aturan pengalihan Ingress dan diteruskan ke Pod Service backend yang sesuai.

Dalam Kubernetes, hubungan antara Service, Ingress, IngressClass, ApigConfig, dan APIG Controller adalah sebagai berikut:

  • Service: Abstraksi dari layanan backend sesungguhnya. Service dapat merepresentasikan beberapa layanan backend identik.

  • Ingress: Sekumpulan aturan reverse proxy yang menentukan layanan mana yang harus dituju oleh permintaan HTTP atau HTTPS. Misalnya, permintaan dapat diteruskan ke layanan berbeda berdasarkan host dan path URL dalam permintaan.

  • IngressClass: Mendeskripsikan implementasi prosesor Ingress dalam kluster Kubernetes. Resource Ingress yang terkait dengan IngressClass ini diurai oleh prosesor tersebut. Anda juga harus menggunakan bidang Parameter dari IngressClass untuk mengasosiasikan ApigConfig (gateway API cloud-native). Gateway ini kemudian menerapkan aturan manajemen lalu lintas yang dijelaskan dalam resource Ingress yang telah diurai.

  • ApigConfig: CRD yang disediakan oleh APIG Controller. Resource ini mendeskripsikan informasi dasar instans gateway API cloud-native.

  • APIG Controller: Bukan bidang data jaringan, melainkan lapisan kontrol yang mengelola instans dan konfigurasi gateway API cloud-native. APIG Controller mendengarkan resource ApigConfig di kluster dan mengkoordinasikan instans gateway API cloud-native untuk menerapkan aturan manajemen lalu lintas yang dijelaskan dalam resource Ingress.

Gambar berikut menunjukkan cara kerja APIG Controller.

image

Referensi