Container Service for Kubernetes:Konfigurasikan jenis jaringan untuk Nginx Ingress Controller

Cara kerja

Di dalam kluster, instans SLB menerima permintaan klien dan meneruskannya ke workload Nginx Ingress Controller, yang kemudian meneruskan permintaan tersebut ke layanan lainnya.

Konfigurasikan Nginx Ingress untuk akses jaringan publik dan pribadi sekaligus

Deploy dua Service untuk pod backend Nginx Ingress Controller—satu dikaitkan dengan instans SLB publik dan yang lainnya dengan instans SLB pribadi—untuk mendukung akses jaringan publik maupun pribadi.

1. Periksa jenis jaringan SLB saat ini.

   kubectl describe service -n kube-system nginx-ingress-lb | grep "service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type"

   Jika output berisi intranet, jenis saat ini adalah pribadi. Jika tidak, jenisnya publik.

2. Buat Service baru untuk memastikan kedua jenis jaringan (publik dan pribadi) tersedia.

   Buat dan simpan file bernama nginx-ingress-lb-new.yaml. Jalankan kubectl apply -f nginx-ingress-lb-new.yaml untuk membuat Service tersebut.

   Tambahkan Service jaringan pribadi

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-ingress-lb-intranet
     namespace: kube-system
     labels:
       app: nginx-ingress-lb
     annotations:
       service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type: intranet # Menentukan bahwa instans SLB menggunakan alamat jaringan pribadi.
   spec:
     type: LoadBalancer
     externalTrafficPolicy: "Cluster"
     ports:
     - port: 80
       name: http
       targetPort: 80
     - port: 443
       name: https
       targetPort: 443
     selector:
       app: ingress-nginx

   Tambahkan Service jaringan publik

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-ingress-lb-internet
     namespace: kube-system
     labels:
       app: nginx-ingress-lb
   spec:
     type: LoadBalancer
     externalTrafficPolicy: "Cluster"
     ports:
     - port: 80
       name: http
       targetPort: 80
     - port: 443
       name: https
       targetPort: 443
     selector:
       app: ingress-nginx

3. Ganti <service-name> dalam perintah berikut dengan nama Service baru Anda, lalu jalankan perintah tersebut. Jika mengembalikan 200, Service baru tersebut berfungsi dengan benar.

   curl -s -o /dev/null -w "%{http_code}\n" http://$(kubectl get service -n kube-system <service-name> -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

4. Ganti <service-name> dengan nama Service baru Anda, lalu jalankan kubectl get service <service-name>. Catat External IP Service tersebut dan konfigurasikan DNS berdasarkan jenis Service:

   Service jaringan pribadi baru

   1. Masuk ke Alibaba Cloud DNS – Private DNS. Pada tab Authoritative Zone > User Defined Zones, klik Add Zone. Jika domain sudah ditambahkan sebelumnya, lanjutkan ke langkah c.

   2. Pada Authoritative Zone, masukkan nama domain Anda. Biarkan opsi lain tetap pada nilai default, lalu klik OK.

   3. Klik domain target. Pada tab Settings, klik Add Record. Isi formulir menggunakan nilai-nilai pada tabel di bawah. Biarkan pengaturan lain tetap pada nilai default, lalu klik OK.

      Item konfigurasi	Nilai
      Record Type	A
      Hostname	Masukkan awalan subdomain sesuai kebutuhan.
      Record Value	Alamat IP dari Service baru.

   4. Kembali ke daftar User Defined Zones. Pada kolom Actions untuk domain target Anda, pilih Effective Scope. Di bawah Effective in VPCs, pilih VPC tempat kluster ACK Anda berada. Lalu klik OK.

   Service jaringan publik baru

   1. Masuk ke Alibaba Cloud DNS – Public Authoritative DNS. Klik domain target Anda untuk membuka halaman Settings. Klik tombol Add Record.

   2. Isi formulir menggunakan nilai-nilai pada tabel di bawah. Biarkan pengaturan lain tetap pada nilai default, lalu klik OK.

      Item konfigurasi	Nilai
      Record Type	A.
      Hostname	Masukkan awalan subdomain sesuai kebutuhan.
      Record Value	Alamat IP dari Service baru.

Ubah jenis jaringan

1. Pastikan instans SLB yang ada tidak memiliki traffic:

   1. Masuk ke Container Service Management Console. Klik kluster target Anda. Di panel navigasi sebelah kiri, buka Network > Services. Temukan nginx-ingress-lb di namespace kube-system. Catat External IP-nya.

   2. Masuk ke Classic Load Balancer console. Pilih wilayah yang sama dengan kluster Anda. Temukan instans CLB yang IP Address-nya sesuai dengan alamat IP yang dicatat pada langkah sebelumnya. Klik instans tersebut. Pada tab Monitoring, pastikan jumlah koneksi adalah 0 sebelum melanjutkan.

2. Hapus Service saat ini yang digunakan oleh Nginx Ingress Controller.

   kubectl delete svc -n kube-system nginx-ingress-lb

3. Buat dan simpan file bernama nginx-ingress-lb.yaml. Lalu jalankan kubectl apply -f nginx-ingress-lb.yaml untuk membuat Service tersebut.

   Penting

   Nama Service baru harus nginx-ingress-lb.

   Service jaringan pribadi

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-ingress-lb
     namespace: kube-system
     labels:
       app: nginx-ingress-lb
     annotations:
       service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type: intranet # Menentukan bahwa instans SLB menggunakan alamat jaringan pribadi.
   spec:
     type: LoadBalancer
     externalTrafficPolicy: "Cluster"
     ports:
     - port: 80
       name: http
       targetPort: 80
     - port: 443
       name: https
       targetPort: 443
     selector:
       app: ingress-nginx

   Service jaringan publik

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-ingress-lb
     namespace: kube-system
     labels:
       app: nginx-ingress-lb
   spec:
     type: LoadBalancer
     externalTrafficPolicy: "Cluster"
     ports:
     - port: 80
       name: http
       targetPort: 80
     - port: 443
       name: https
       targetPort: 443
     selector:
       app: ingress-nginx

4. Uji Service baru. Jika mengembalikan 200, Service tersebut berfungsi dengan benar.

   curl -s -o /dev/null -w "%{http_code}\n" http://$(kubectl get service -n kube-system nginx-ingress-lb -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

5. Jalankan kubectl get service nginx-ingress-lb. Catat External IP Service tersebut dan konfigurasikan DNS berdasarkan jenis Service:

   Service jaringan pribadi baru

   1. Masuk ke Alibaba Cloud DNS – Private DNS. Pada tab Authoritative Zone > User Defined Zones, klik Add Zone. Jika domain sudah ditambahkan sebelumnya, lanjutkan ke langkah c.

   2. Pada Authoritative Zone, masukkan nama domain Anda. Biarkan opsi lain tetap pada nilai default, lalu klik OK.

   3. Klik domain target. Pada tab Settings, klik Add Record. Isi formulir menggunakan nilai-nilai pada tabel di bawah. Biarkan pengaturan lain tetap pada nilai default, lalu klik OK.

      Item konfigurasi	Nilai
      Record Type	A
      Hostname	Masukkan awalan subdomain sesuai kebutuhan.
      Record Value	Alamat IP dari Service baru.

   4. Kembali ke daftar User Defined Zones. Pada kolom Actions untuk domain target Anda, pilih Effective Scope. Di bawah Effective in VPCs, pilih VPC tempat kluster ACK Anda berada. Lalu klik OK.

   Service jaringan publik baru

   1. Masuk ke Alibaba Cloud DNS – Public Authoritative DNS. Klik domain target Anda untuk membuka halaman Settings. Klik tombol Add Record.

   2. Isi formulir menggunakan nilai-nilai pada tabel di bawah. Biarkan pengaturan lain tetap pada nilai default, lalu klik OK.

      Item konfigurasi	Nilai
      Record Type	A.
      Hostname	Masukkan awalan subdomain sesuai kebutuhan.
      Record Value	Alamat IP dari Service baru.

FAQ

Referensi

Untuk detail tentang konfigurasi anotasi untuk instans SLB yang sudah ada, lihat Use an existing SLB instance.