Repo ini menyediakan implementasi Ingress Controller untuk NGINX dan NGINX Plus dari orang-orang di belakang NGINX.
Kami menghargai masukan komunitas dan ingin bertemu Anda di panggilan komunitas berikutnya. Pada panggilan ini, kami mendiskusikan PR dari anggota komunitas serta isu, diskusi, dan permintaan fitur.
Tautan Tim Microsoft : KIC - Triase Masalah GitHub
Nomor Rapat: 298 140 979 789
Kode sandi: jpx5TM
Slack : Bergabunglah dengan saluran kami #nginx-ingress-controller
di Komunitas NGINX Slack untuk pembaruan dan diskusi.
Kapan : 15:00 GMT / Konversikan ke zona waktu Anda, setiap hari Senin.
Tanggal Panggilan Komunitas |
---|
07-10-2024 |
21-10-2024 |
05-11-2024 |
18-11-2024 |
02-12-2024 |
16-12-2024 |
NGINX Ingress Controller bekerja dengan NGINX dan NGINX Plus dan mendukung fitur Ingress standar - perutean berbasis konten dan penghentian TLS/SSL.
Selain itu, beberapa fitur NGINX dan NGINX Plus tersedia sebagai ekstensi pada sumber daya Ingress melalui anotasi dan sumber daya ConfigMap. Selain HTTP, NGINX Ingress Controller mendukung penyeimbangan beban aplikasi Websocket, gRPC, TCP dan UDP. Lihat dokumen ConfigMap dan Anotasi untuk mempelajari lebih lanjut tentang fitur yang didukung dan opsi penyesuaian.
Sebagai alternatif dari Ingress, NGINX Ingress Controller mendukung sumber daya VirtualServer dan VirtualServerRoute. Mereka mengaktifkan kasus penggunaan yang tidak didukung dengan sumber daya Ingress, seperti pemisahan lalu lintas dan perutean berbasis konten tingkat lanjut. Lihat dokumen sumber daya VirtualServer dan VirtualServerRoute.
Penyeimbangan beban TCP, UDP dan TLS Passthrough juga didukung. Lihat dokumen sumber daya TransportServer.
Baca dokumen ini untuk mempelajari lebih lanjut tentang NGINX Ingress Controller dengan NGINX Plus.
Catatan
Proyek ini berbeda dengan NGINX Ingress Controller di repo kubernetes/ingress-nginx. Lihat dokumen ini untuk mengetahui perbedaan utamanya.
Ingress adalah sumber daya Kubernetes yang memungkinkan Anda mengonfigurasi penyeimbang beban HTTP untuk aplikasi yang berjalan di Kubernetes, yang diwakili oleh satu atau lebih Layanan. Penyeimbang beban seperti itu diperlukan untuk mengirimkan aplikasi tersebut ke klien di luar cluster Kubernetes.
Sumber daya Ingress mendukung fitur berikut:
Perutean berbasis konten :
Perutean berbasis host . Misalnya, merutekan permintaan dengan header host foo.example.com
ke satu grup layanan dan header host bar.example.com
ke grup lain.
Perutean berbasis jalur . Misalnya, merutekan permintaan dengan URI yang dimulai dengan /serviceA
ke layanan A dan permintaan dengan URI yang dimulai dengan /serviceB
ke layanan B.
Penghentian TLS/SSL untuk setiap nama host, seperti foo.example.com
.
Lihat Panduan Pengguna Ingress untuk mempelajari lebih lanjut tentang sumber daya Ingress.
Pengontrol Ingress adalah aplikasi yang berjalan dalam cluster dan mengonfigurasi penyeimbang beban HTTP berdasarkan sumber daya Ingress. Penyeimbang beban dapat berupa penyeimbang beban perangkat lunak yang berjalan di kluster atau penyeimbang beban perangkat keras atau cloud yang berjalan secara eksternal. Penyeimbang beban yang berbeda memerlukan implementasi Pengontrol Ingress yang berbeda.
Dalam kasus NGINX, Pengontrol Ingress diterapkan dalam pod bersama dengan penyeimbang beban.
Catatan
Semua dokumentasi hanya boleh digunakan dengan rilis stabil terbaru, yang ditunjukkan pada halaman rilis repositori GitHub.
Instal NGINX Ingress Controller menggunakan diagram Helm atau manifes Kubernetes.
Konfigurasikan penyeimbangan beban untuk aplikasi web sederhana:
Gunakan sumber daya Ingress. Lihat contoh Kafe.
Atau sumber daya VirtualServer. Lihat contoh konfigurasi dasar.
Lihat contoh konfigurasi tambahan.
Pelajari lebih lanjut tentang semua konfigurasi dan penyesuaian yang tersedia di dokumen.
Kami menerbitkan rilis NGINX Ingress Controller di GitHub. Lihat halaman rilis kami.
Rilis stabil terbaru adalah 3.7.2. Untuk penggunaan produksi, kami menyarankan Anda memilih rilis stabil terbaru.
Versi edge berguna untuk bereksperimen dengan fitur-fitur baru yang belum dipublikasikan dalam rilis stabil. Untuk menggunakannya, pilih versi edge yang dibuat dari komit terbaru dari cabang utama.
Untuk menggunakan NGINX Ingress Controller, Anda harus memiliki akses ke:
Gambar Pengontrol Ingress NGINX.
Manifes instalasi atau bagan Helm.
Dokumentasi dan contoh.
Penting agar versi hal-hal di atas cocok.
Tabel di bawah merangkum opsi mengenai gambar, bagan Helm, manifes, dokumentasi, dan contoh serta memberikan tautan Anda ke versi yang benar:
Versi | Keterangan | Gambar untuk NGINX | Gambar untuk NGINX Plus | Manifes Instalasi dan Bagan Helm | Dokumentasi dan Contoh |
---|---|---|---|---|---|
Rilis stabil terbaru | Untuk penggunaan produksi | Gunakan image 3.7.2 dari DockerHub, GitHub Container, Amazon ECR Public Gallery, atau Quay.io atau buat image Anda sendiri. | Gunakan image 3.7.2 dari F5 Container Registry atau Buat image Anda sendiri. | Mewujud. Bagan helm. | Dokumentasi. Contoh. |
Tepi/Malam | Untuk pengujian dan percobaan | Gunakan image edge atau nightly dari DockerHub, GitHub Container, Amazon ECR Public Gallery, atau Quay.io atau buat image Anda sendiri. | Bangun citra Anda sendiri. | Mewujud. Bagan helm. | Dokumentasi. Contoh. |
Kami membuat SBOM untuk binari dan image Docker.
SBOM untuk binari tersedia di halaman rilis. SBOM dibuat menggunakan syft dan tersedia dalam format SPDX.
SBOM untuk image Docker tersedia di DockerHub, GitHub Container, Amazon ECR Public Gallery, atau repositori Quay.io. SBOM dibuat menggunakan syft dan disimpan sebagai pengesahan dalam manifes gambar.
Misalnya untuk mengambil SBOM untuk linux/amd64
dari Docker Hub dan menganalisisnya menggunakan grype Anda dapat menjalankan perintah berikut:
docker buildx imagetools memeriksa nginx/nginx-ingress:edge --format '{{ json (index .SBOM "linux/amd64").SPDX }}' | mengeluh
Kami ingin mendengar tanggapan Anda! Jika Anda memiliki saran atau mengalami masalah dengan Pengontrol Ingress kami, silakan buat masalah atau kirim permintaan penarikan di GitHub. Anda dapat menghubungi kami langsung melalui NGINX Community Slack.
Jika Anda ingin berkontribusi pada proyek ini, silakan baca panduan Berkontribusi kami.
Untuk pelanggan NGINX Plus NGINX Ingress Controller (bila digunakan dengan NGINX Plus) tercakup dalam kontrak dukungan.