Topik ini menjelaskan komponen Nginx Ingress Controller, termasuk penggunaan dan riwayat perubahannya.
Ikhtisar komponen
Nginx Ingress Controller didasarkan pada proyek Kubernetes open source Ingress NGINX dan menyediakan titik masuk terpadu untuk layanan dalam kluster. Implementasi kodenya identik dengan Ingress NGINX komunitas. Versi baru dirilis secara sinkron dengan komunitas hulu, dan nomor versinya tetap konsisten. Nginx Ingress Controller merupakan komponen non-managed yang dideploy pada node kluster Anda. Anda bertanggung jawab atas operasi dan pemeliharaannya (O&M). Komponen ini tidak dilengkapi Service-Level Agreement (SLA) dan mendukung kustomisasi ekstensif.
Konsep dasar Ingress
Dalam kluster Kubernetes, Ingress berfungsi sebagai titik akses yang mengekspos Services di dalam kluster. Ingress mendistribusikan sebagian besar lalu lintas jaringan yang ditujukan ke Services dalam kluster tersebut. Ingress adalah objek resource Kubernetes yang digunakan untuk mengaktifkan akses eksternal ke Services dalam kluster Kubernetes. Anda dapat mengonfigurasi aturan routing untuk Ingress guna mengarahkan lalu lintas jaringan ke pod backend dari Services yang berbeda. Untuk perbandingan Ingress di ACK, lihat Perbandingan antara Nginx Ingress, ALB Ingress, dan MSE Ingress.
Cara kerja
Ingress hanya dapat berfungsi secara normal jika Anda men-deploy NGINX Ingress controller di dalam kluster untuk mengurai aturan routing Ingress tersebut. Setelah NGINX Ingress controller menerima permintaan yang cocok dengan aturan routing, controller tersebut akan mengarahkan permintaan ke Service backend yang sesuai. Service backend kemudian meneruskan permintaan tersebut ke pod. Dalam kluster Kubernetes, Services, Ingresses, dan NGINX Ingress controller bekerja melalui proses berikut:
Service adalah abstraksi dari aplikasi backend yang berjalan pada sekumpulan pod replikasi.
Ingress berisi aturan reverse proxy. Ingress mengontrol ke pod Service mana permintaan HTTP atau HTTPS diarahkan. Misalnya, permintaan diarahkan ke pod Service yang berbeda berdasarkan host dan path URL dalam permintaan tersebut.
NGINX Ingress controller adalah program reverse proxy yang mengurai aturan Ingress. Jika terjadi perubahan pada aturan Ingress, NGINX Ingress controller memperbarui aturan tersebut secara sesuai. Setelah menerima permintaan, NGINX Ingress controller mengarahkan permintaan ke pod Service berdasarkan aturan Ingress.
Kompatibilitas versi Nginx Ingress Controller dan kluster
Jika versi target komponen tidak kompatibel dengan versi kluster saat ini, Anda harus melakukan upgrade kluster terlebih dahulu. Untuk informasi selengkapnya, lihat Upgrade kluster.
Versi Nginx Ingress Controller | Versi kluster yang kompatibel |
[v1.5.1-aliyun.1, v1.11.5-aliyun.1] | 1.22 dan yang lebih baru |
[v1.1.0-aliyun.1, v1.2.1-aliyun.1] | 1.20 dan yang lebih baru |
Risiko versi lama
Pemeliharaan untuk Nginx Ingress Controller v1.2 dan versi sebelumnya telah dihentikan. Untuk informasi selengkapnya, lihat Pengumuman Produk. Versi komponen yang kedaluwarsa tidak mendukung fitur baru atau perbaikan bug dan tidak memenuhi syarat untuk dukungan teknis. Hal ini membuat Anda terpapar risiko keamanan akibat kerentanan yang belum diperbaiki. Harap segera upgrade komponen.
Catatan penggunaan
Untuk menginstal atau meng-upgrade komponen Nginx Ingress Controller, lihat Kelola komponen Nginx Ingress Controller dan Upgrade komponen Nginx Ingress Controller.
Untuk informasi selengkapnya tentang cara membuat, melihat, memperbarui, dan menghapus Nginx Ingress melalui Konsol atau kubectl, lihat Buat dan gunakan Nginx Ingress untuk mengekspos layanan.
Untuk informasi selengkapnya, lihat Gunakan Nginx Ingress untuk rilis bertahap dan penyebaran biru-hijau, Konfigurasikan akses jaringan publik dan pribadi untuk instans SLB Ingress Controller, dan Gunakan Nginx Ingress untuk mereplikasi traffic aplikasi.
Riwayat perubahan
Desember 2025
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak |
v1.12.6-release.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.12.6-release.1 | 11 Desember 2025 | Diperbarui ke versi komunitas v1.12.6. | Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
September 2025
Versi | Alamat registri | Ubah tanggal | Perubahan | Dampak |
v1.11.5-release.2 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.11.5-release.2 | 11 September 2025 | Optimisasi fitur:
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
Maret 2025
Versi | Alamat registri | Ubah tanggal | Perubahan | Dampak |
v1.11.5-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.11.5-aliyun.1 | 26 Maret 2025 | Diperbarui ke versi komunitas v1.11.5 untuk memperbaiki CVE-2025-1097, CVE-2025-1098, CVE-2025-1974, CVE-2025-24513, dan CVE-2025-24514. Untuk informasi selengkapnya, lihat Pemberitahuan Kerentanan untuk CVE-2025-1097, CVE-2025-1098, CVE-2025-1974, CVE-2025-24513, dan CVE-2025-24514. Penting Untuk memperbaiki kerentanan CVE-2025-1974, Validation Webhook diaktifkan secara default pada versi ini dan versi setelahnya dari komponen Nginx Ingress Controller. Namun, logika validasi konfigurasi NGINX native kini dinonaktifkan secara default. Jika Anda mengaktifkan anotasi snippet (digunakan untuk direktif native NGINX kustom), konfigurasi tersebut tidak lagi divalidasi sebelumnya oleh Validation Webhook. Kesalahan terkait hanya akan memicu peringatan saat NGINX memuat ulang konfigurasi. Kami menyarankan Anda memeriksa log pod Nginx Ingress Controller setelah setiap modifikasi aturan Ingress dan memperbaiki konfigurasi Ingress berdasarkan log kesalahan tersebut. Catatan: Konfigurasi yang salah tidak memengaruhi pod Nginx Ingress yang sedang berjalan. Namun, pod baru yang dibuat selama operasi seperti scale-out atau restart akan gagal memulai karena kesalahan konfigurasi tersebut. Kami menyarankan Anda memvalidasi sepenuhnya direktif snippet di lingkungan staging sebelum mengubah konfigurasi di lingkungan produksi. | Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
v1.11.4-aliyun.2 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.11.4-aliyun.2 | 19 Maret 2025 | Mengoptimalkan konfigurasi afinitas penjadwalan node. Pod tidak dijadwalkan ke Node Lingjun. | Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
Februari 2025
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak |
v1.11.4-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.11.4-aliyun.1 | 12 Februari 2025 | Diperbarui ke versi komunitas v1.11.4. Menambahkan dukungan untuk mengonfigurasi batasan penyebaran topologi kustom untuk komponen di Konsol. | Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
Agustus 2024
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak |
v1.10.4-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.10.4-aliyun.1 | 20 Agustus 2024 | Diperbarui ke versi komunitas v1.10.4 untuk memperbaiki kerentanan CVE-2024-7646. Untuk informasi selengkapnya tentang kerentanan tersebut, lihat Masalah keamanan. | Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
Juli 2024
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak |
v1.10.2-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.10.2-aliyun.1 | 24 Juli 2024 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
Oktober 2023
Versi | Alamat registri | Ubah tanggal | Perubahan | Dampak |
v1.9.3-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.9.3-aliyun.1 | 24 Oktober 2023 | Penting Karena alasan keamanan, semua anotasi snippet (seperti Karena alasan keamanan dan stabilitas, kami tidak menyarankan Anda mengaktifkan anotasi snippet. Jika Anda harus menggunakannya, evaluasi risikonya secara hati-hati dan aktifkan secara manual dengan menambahkan
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
September 2023
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak |
v1.8.2-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.8.2-aliyun.1 | 20 September 2023 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
Juni 2023
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak |
v1.8.0-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.8.0-aliyun.1 | 20 Juni 2023 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
Mei 2023
Versi | Alamat registri | Ubah tanggal | Perubahan | Dampak |
v1.7.0-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.7.0-aliyun.1 | 5 Mei 2023 | Penting Versi ini secara default tidak lagi mendukung metode enkripsi TLS v1.1 dan TLS v1.0. Jika Anda meng-upgrade Nginx Ingress Controller ke versi ini, pertimbangkan dampaknya terhadap layanan Anda. Untuk informasi selengkapnya tentang masalah ini, lihat set ssl-protocols config not working after v1.6.4. Untuk memaksa penggunaan versi TLS lama, lihat konfigurasi di Masalah yang diketahui pada versi Nginx Ingress sebelumnya.
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
Maret 2023
Versi | Alamat registri | Ubah tanggal | Perubahan | Dampak |
v1.6.4-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.6.4-aliyun.1 | 17 Maret 2023 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
February 2023
Versi | Alamat registri | Ubah tanggal | Perubahan | Dampak Perubahan |
v1.5.1-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.5.1-aliyun.1 | 10 Februari 2023 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
June 2022
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak |
v1.2.1-aliyun.1 | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.2.1-aliyun.1 | 28 Juni 2022 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
May 2022
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak Perubahan |
v1.2.0-aliyun.1 | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.2.0-aliyun.1 | 10 Mei 2022 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
April 2022
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak |
v0.44.0.12-27ae67262-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.12-27ae67262-aliyun | 29 April 2022 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
March 2022
Versi | Alamat registri | Tanggal Perubahan | Perubahan | Dampak Perubahan |
v1.1.2-aliyun.2 | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.1.2-aliyun.2 | 21 Maret 2022 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
January 2022
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak |
v1.1.0-aliyun.2 | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.1.0-aliyun.2 | 12 Januari 2022 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
December 2021
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak |
v1.1.0-aliyun.1 | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.1.0-aliyun.1 | 17 Desember 2021 |
Untuk informasi selengkapnya, lihat changelog komunitas. | Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
October 2021
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak Perubahan |
v0.44.0.9-7b9e93e7e-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.9-7b9e93e7e-aliyun | 28 Oktober 2021 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
September 2021
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak Perubahan |
v0.44.0.5-e66e17ee3-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.5-e66e17ee3-aliyun | 6 September 2021 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
June 2021
Versi | Registry Address | Ubah tanggal | Perubahan | Dampak Perubahan |
v0.44.0.3-8e83e7dc6-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.3-8e83e7dc6-aliyun | 1 Juni 2021 | Memperbaiki kerentanan CVE-2021-23017. | Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
April 2021
Versi | Alamat registri | Ubah tanggal | Perubahan | Dampak |
v0.44.0.2-abf1c6fe4-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.2-abf1c6fe4-aliyun | 1 April 2021 | Menambahkan kompatibilitas untuk field | Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
March 2021
Versi | Alamat registri | Ubah tanggal | Perubahan | Dampak |
v0.44.0.1-5e842447b-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.1-5e842447b-aliyun | 8 Maret 2021 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
April 2020
Versi | Alamat registri | Tanggal perubahan | Perubahan | Dampak |
v0.30.0.1-5f89cb606-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.30.0.1-5f89cb606-aliyun | 2 April 2020 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
October 2019
Versi | Alamat registri | Ubah tanggal | Perubahan | Dampak |
v0.22.0.5-552e0db-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.22.0.5-552e0db-aliyun | 24 Oktober 2019 | Menambahkan dukungan untuk nama domain wildcard, daftar putih, dan konfigurasi pengalihan saat pembaruan server dinamis diaktifkan. | Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
July 2019
Versi | Alamat registri | Tanggal Perubahan | Perubahan | Dampak |
v0.22.0.4-5a14d4b-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.22.0.4-5a14d4b-aliyun | 18 Juli 2019 | Mengoptimalkan aturan rilis bertahap untuk mendukung pencocokan ekspresi reguler Perl. | Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
April 2019
Versi | Alamat registri | Tanggal Perubahan | Perubahan | Dampak |
v0.22.0.3-da10b7f-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.22.0.3-da10b7f-aliyun | 25 April 2019 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
January 2019
Versi | Alamat registri | Ubah tanggal | Perubahan | Dampak |
v0.20.0.2-cc39f1b-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.20.0.2-cc39f1b-aliyun | 17 Januari 2019 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |
November 2018
Versi | Alamat registri | Ubah tanggal | Perubahan | Dampak |
v0.20.0.1-4597ce2-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.20.0.1-4597ce2-aliyun | 29 November 2018 |
| Lakukan upgrade pada jam sepi. Koneksi yang telah terbentuk mungkin terputus sebentar selama proses upgrade. |