Add-on perutean aplikasi HTTP untuk Azure Kubernetes Service (AKS) (dihentikan)

Artikel
10/04/2023

Perhatian

Add-on perutean aplikasi HTTP (pratinjau) untuk Azure Kubernetes Service (AKS) akan dihentikan pada 03 Maret 2025. Sebaiknya migrasi ke add-on Perutean Aplikasi pada tanggal tersebut.

Add-on perutean aplikasi HTTP memudahkan akses aplikasi yang disebarkan ke kluster Azure Kubernetes Service (AKS) Anda dengan:

Mengonfigurasi pengontrol ingress di kluster AKS Anda.
Membuat nama DNS yang dapat diakses publik untuk titik akhir aplikasi
Membuat zona DNS di langganan Anda. Untuk mengetahui informasi selengkapnya tentang biaya DNS, lihat Harga DNS.

Sebelum Anda mulai

Add-on perutean aplikasi HTTP tidak berfungsi dengan AKS versi 1.22.6+.
Jika Anda menjalankan perintah secara lokal, instal kubectl menggunakan az aks install-cli perintah .

Gambaran umum add-on perutean aplikasi HTTP

Add-on menyebarkan dua komponen: pengontrol ingress Kube dan pengontrol External-DNS .

Pengontrol Ingress: Pengontrol ingress diekspos ke internet menggunakan layanan Kubernetes LoadBalancer . Pengontrol ingress mengawasi dan mengimplementasikan sumber daya ingress Kubernetes dan membuat rute ke titik akhir aplikasi.
Pengontrol EXTERNAL-DNS: Pengontrol External-DNS mengawasi sumber daya ingress Kubernetes dan membuat rekaman DNS A di zona DNS khusus kluster.

Mengaktifkan perutean aplikasi HTTP

Buat kluster AKS baru dan aktifkan add-on perutean aplikasi HTTP menggunakan az aks create perintah dengan --enable-addons parameter .
```
az aks create --resource-group myResourceGroup --name myAKSCluster --enable-addons http_application_routing
```
Anda juga dapat mengaktifkan perutean HTTP pada kluster AKS yang ada menggunakan az aks enable-addons perintah dengan --addons parameter .
```
az aks enable-addons --resource-group myResourceGroup --name myAKSCluster --addons http_application_routing
```

Ambil nama zona DNS menggunakan az aks show perintah . Anda memerlukan nama zona DNS untuk menyebarkan aplikasi ke kluster.

az aks show --resource-group myResourceGroup --name myAKSCluster --query addonProfiles.httpApplicationRouting.config.HTTPApplicationRoutingZoneName -o table

Output Anda akan terlihat seperti contoh output berikut:

9f9c1fe7-21a1-416d-99cd-3543bb92e4c3.eastus.aksapp.io

Menyambungkan ke kluster AKS Anda

Konfigurasikan kubectl untuk terhubung ke kluster Kubernetes menggunakan perintah az aks get-credentials. Contoh perintah berikut mendapatkan mandat untuk kluster AKS yang bernama myAKSCluster di myResourceGroup:
```
az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
```

Gunakan Perutean Aplikasi HTTP

Penting

Add-on perutean aplikasi HTTP hanya dapat dipicu pada sumber daya ingress dengan anotasi berikut:

annotations:
 kubernetes.io/ingress.class: addon-http-application-routing

Buat file bernama samples-http-application-routing.yaml dan salin dalam YAML berikut. Pada baris 43, perbarui <CLUSTER_SPECIFIC_DNS_ZONE> dengan nama zona DNS yang Anda kumpulkan di langkah sebelumnya.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: aks-helloworld
spec:
  replicas: 1
  selector:
    matchLabels:
      app: aks-helloworld
  template:
    metadata:
      labels:
        app: aks-helloworld
    spec:
      containers:
      - name: aks-helloworld
        image: mcr.microsoft.com/azuredocs/aks-helloworld:v1
        ports:
        - containerPort: 80
        env:
        - name: TITLE
          value: "Welcome to Azure Kubernetes Service (AKS)"
---
apiVersion: v1
kind: Service
metadata:
  name: aks-helloworld
spec:
  type: ClusterIP
  ports:
 - port: 80
  selector:
    app: aks-helloworld
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: aks-helloworld
  annotations:
    kubernetes.io/ingress.class: addon-http-application-routing
spec:
  rules:
 - host: aks-helloworld.<CLUSTER_SPECIFIC_DNS_ZONE>
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: aks-helloworld
            port:
              number: 80

Buat sumber daya menggunakan kubectl apply perintah .

kubectl apply -f samples-http-application-routing.yaml

Contoh berikut menunjukkan sumber daya yang dibuat:

deployment.apps/aks-helloworld created
service/aks-helloworld created
ingress.networking.k8s.io/aks-helloworld created

Buka browser web ke aks-helloworld.<CLUSTER_SPECIFIC_DNS_ZONE>, misalnya aks-helloworld.9f9c1fe7-21a1-416d-99cd-3543bb92e4c3.eastus.aksapp.io dan verifikasi bahwa Anda melihat aplikasi demo. Aplikasi mungkin perlu waktu beberapa menit untuk muncul.

Menghapus perutean aplikasi HTTP

Hapus add-on perutean aplikasi HTTP menggunakan parameter [az aks disable-addons][az-aks-disable-addons] command with the addons'.
```
az aks disable-addons --addons http_application_routing --name myAKSCluster --resource-group myResourceGroup --no-wait
```

Ketika add-on perutean aplikasi HTTP dinonaktifkan, beberapa sumber daya Kube mungkin tetap berada di dalam kluster. Sumber daya ini termasuk peta konfigurasi dan rahasia dan dibuat di namespace layanan kube-system . Untuk membuat kluster tetap bersih, sebaiknya hapus sumber daya ini. Cari sumber daya addon-http-application-routing menggunakan perintah berikut kubectl get :

kubectl get deployments --namespace kube-system
kubectl get services --namespace kube-system
kubectl get configmaps --namespace kube-system
kubectl get secrets --namespace kube-system

Contoh output berikut menunjukkan peta konfigurasi yang harus dihapus:

NAMESPACE     NAME                                                       DATA   AGE
kube-system   addon-http-application-routing-nginx-configuration         0      9m7s
kube-system   addon-http-application-routing-tcp-services                0      9m7s
kube-system   addon-http-application-routing-udp-services                0      9m7s

Hapus sumber daya yang tersisa menggunakan kubectl delete perintah . Pastikan untuk menentukan jenis sumber daya, nama sumber daya, dan namespace layanan. Contoh berikut menghapus salah satu configmaps sebelumnya:
```
kubectl delete configmaps addon-http-application-routing-nginx-configuration --namespace kube-system
```
Ulangi langkah sebelumnya kubectl delete untuk semua sumber daya addon-http-application-routing yang tersisa di kluster Anda.

Pecahkan masalah

Lihat log aplikasi untuk aplikasi External-DNS menggunakan kubectl logs perintah .

kubectl logs -f deploy/addon-http-application-routing-external-dns -n kube-system

Log harus mengonfirmasi bahwa A catatan DNS dan TXT berhasil dibuat, seperti yang diperlihatkan dalam contoh output berikut:

time="2018-04-26T20:36:19Z" level=info msg="Updating A record named 'aks-helloworld' to '52.242.28.189' for Azure DNS zone '471756a6-e744-4aa0-aa01-89c4d162a7a7.canadaeast.aksapp.io'."
time="2018-04-26T20:36:21Z" level=info msg="Updating TXT record named 'aks-helloworld' to '"heritage=external-dns,external-dns/owner=default"' for Azure DNS zone '471756a6-e744-4aa0-aa01-89c4d162a7a7.canadaeast.aksapp.io'."

Lihat log aplikasi untuk pengontrol ingress NGINX menggunakan kubectl logs perintah .

kubectl logs -f deploy/addon-http-application-routing-nginx-ingress-controller -n kube-system

Log harus mengonfirmasi CREATE sumber daya ingress dan isi ulang pengontrol, seperti yang ditunjukkan dalam contoh output berikut:

-------------------------------------------------------------------------------
NGINX Ingress controller
  Release:    0.13.0
  Build:      git-4bc943a
  Repository: https://github.com/kubernetes/ingress-nginx
-------------------------------------------------------------------------------

I0426 20:30:12.212936       9 flags.go:162] Watching for ingress class: addon-http-application-routing
W0426 20:30:12.213041       9 flags.go:165] only Ingress with class "addon-http-application-routing" will be processed by this ingress controller
W0426 20:30:12.213505       9 client_config.go:533] Neither --kubeconfig nor --master was specified.  Using the inClusterConfig.  This might not work.
I0426 20:30:12.213752       9 main.go:181] Creating API client for https://10.0.0.1:443
I0426 20:30:12.287928       9 main.go:225] Running in Kubernetes Cluster version v1.8 (v1.8.11) - git (clean) commit 1df6a8381669a6c753f79cb31ca2e3d57ee7c8a3 - platform linux/amd64
I0426 20:30:12.290988       9 main.go:84] validated kube-system/addon-http-application-routing-default-http-backend as the default backend
I0426 20:30:12.294314       9 main.go:105] service kube-system/addon-http-application-routing-nginx-ingress validated as source of Ingress status
I0426 20:30:12.426443       9 stat_collector.go:77] starting new nginx stats collector for Ingress controller running in namespace  (class addon-http-application-routing)
I0426 20:30:12.426509       9 stat_collector.go:78] collector extracting information from port 18080
I0426 20:30:12.448779       9 nginx.go:281] starting Ingress controller
I0426 20:30:12.463585       9 event.go:218] Event(v1.ObjectReference{Kind:"ConfigMap", Namespace:"kube-system", Name:"addon-http-application-routing-nginx-configuration", UID:"2588536c-4990-11e8-a5e1-0a58ac1f0ef2", APIVersion:"v1", ResourceVersion:"559", FieldPath:""}): type: 'Normal' reason: 'CREATE' ConfigMap kube-system/addon-http-application-routing-nginx-configuration
I0426 20:30:12.466945       9 event.go:218] Event(v1.ObjectReference{Kind:"ConfigMap", Namespace:"kube-system", Name:"addon-http-application-routing-tcp-services", UID:"258ca065-4990-11e8-a5e1-0a58ac1f0ef2", APIVersion:"v1", ResourceVersion:"561", FieldPath:""}): type: 'Normal' reason: 'CREATE' ConfigMap kube-system/addon-http-application-routing-tcp-services
I0426 20:30:12.467053       9 event.go:218] Event(v1.ObjectReference{Kind:"ConfigMap", Namespace:"kube-system", Name:"addon-http-application-routing-udp-services", UID:"259023bc-4990-11e8-a5e1-0a58ac1f0ef2", APIVersion:"v1", ResourceVersion:"562", FieldPath:""}): type: 'Normal' reason: 'CREATE' ConfigMap kube-system/addon-http-application-routing-udp-services
I0426 20:30:13.649195       9 nginx.go:302] starting NGINX process...
I0426 20:30:13.649347       9 leaderelection.go:175] attempting to acquire leader lease  kube-system/ingress-controller-leader-addon-http-application-routing...
I0426 20:30:13.649776       9 controller.go:170] backend reload required
I0426 20:30:13.649800       9 stat_collector.go:34] changing prometheus collector from  to default
I0426 20:30:13.662191       9 leaderelection.go:184] successfully acquired lease kube-system/ingress-controller-leader-addon-http-application-routing
I0426 20:30:13.662292       9 status.go:196] new leader elected: addon-http-application-routing-nginx-ingress-controller-5cxntd6
I0426 20:30:13.763362       9 controller.go:179] ingress backend successfully reloaded...
I0426 21:51:55.249327       9 event.go:218] Event(v1.ObjectReference{Kind:"Ingress", Namespace:"default", Name:"aks-helloworld", UID:"092c9599-499c-11e8-a5e1-0a58ac1f0ef2", APIVersion:"extensions", ResourceVersion:"7346", FieldPath:""}): type: 'Normal' reason: 'CREATE' Ingress default/aks-helloworld
W0426 21:51:57.908771       9 controller.go:775] service default/aks-helloworld does not have any active endpoints
I0426 21:51:57.908951       9 controller.go:170] backend reload required
I0426 21:51:58.042932       9 controller.go:179] ingress backend successfully reloaded...
167.220.24.46 - [167.220.24.46] - - [26/Apr/2018:21:53:20 +0000] "GET / HTTP/1.1" 200 234 "" "Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0)" 197 0.001 [default-aks-helloworld-80] 10.244.0.13:8080 234 0.004 200

Membersihkan sumber daya

Hapus objek Kubernetes terkait yang dibuat dalam artikel ini menggunakan kubectl delete perintah .
```
kubectl delete -f samples-http-application-routing.yaml
```
Contoh output berikut menunjukkan objek Kubernetes telah dihapus:
```
deployment "aks-helloworld" deleted
service "aks-helloworld" deleted
ingress "aks-helloworld" deleted
```

Langkah berikutnya

Untuk informasi tentang cara menginstal pengontrol ingress yang diamankan HTTPS di AKS, lihat ingress HTTPS di Azure Kubernetes Service (AKS).