Sdílet prostřednictvím

Migrace ze směrování aplikace HTTP na doplněk směrování aplikace

  • Článek

V tomto článku se dozvíte, jak migrovat cluster Azure Kubernetes Service (AKS) z funkce směrování aplikací HTTP do doplňku pro směrování aplikací. Doplněk pro směrování aplikací HTTP se vyřadil z provozu a v současné době nefunguje na žádné verzi Kubernetes clusteru. Doporučujeme migrovat co nejdříve, abyste zachovali podporovanou konfiguraci.

Požadavky

  • Azure CLI verze 2.54.0 nebo novější je nainstalovaná a nakonfigurovaná. Verzi zjistíte spuštěním příkazu az --version. Pokud potřebujete instalaci nebo upgrade, přečtěte si téma Instalace Azure CLI.
  • aks-preview Nainstalované rozšíření Azure CLI verze 0.5.171 nebo novější

Poznámka:

Tento postup podrobně popisuje migraci z nepodporované konfigurace. Proto AKS nemůže nabídnout podporu problémů, ke kterým dochází během procesu migrace.

Aktualizace doplňků, příchozích přenosů dat a využití IP adres clusteru

  1. Povolte doplněk pro směrování aplikací.

    az aks approuting enable --resource-group <ResourceGroupName> --name <ClusterName>

  2. Aktualizujte příchozí přenos dat a nastavte ingressClassName na webapprouting.kubernetes.azure.com. Odeberte poznámku kubernetes.io/ingress.class . Musíte také aktualizovat hostitele na ten, který vlastníte, protože doplněk pro směrování aplikací nemá zónu DNS spravovaného clusteru. Pokud nemáte zónu DNS, postupujte podle pokynů a vytvořte ji a nakonfigurujte.

    Zpočátku bude vaše konfigurace příchozího přenosu dat vypadat přibližně takto:

    apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: aks-helloworld
  annotations:
    kubernetes.io/ingress.class: addon-http-application-routing  # Remove the ingress class annotation
spec:
  rules:
  - host: aks-helloworld.<CLUSTER_SPECIFIC_DNS_ZONE>
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: aks-helloworld
            port:
              number: 80

    Po správné aktualizaci vypadá stejná konfigurace jako následující:

    apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: aks-helloworld
spec:
  ingressClassName: webapprouting.kubernetes.azure.com # Set the ingress class property to refer to the application routing add-on ingress class
  rules:
  - http:
    host: aks-helloworld.<CLUSTER_SPECIFIC_DNS_ZONE> # Replace with your own hostname
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: aks-helloworld
            port:
              number: 80

  3. Aktualizujte IP adresu kontroleru příchozího přenosu dat (například v záznamech DNS) novou IP adresou. Novou IP adresu najdete pomocí .kubectl get Příklad:

    kubectl get svc nginx --namespace app-routing-system -o jsonpath='{.status.loadBalancer.ingress[0].ip}'

  4. Zakažte doplněk pro směrování aplikací HTTP.

    az aks disable-addons --resource-group <ResourceGroupName> --name <ClusterName> --addons http_application_routing

Odebrání a odstranění všech prostředků směrování aplikací HTTP

  1. Po zakázání doplňku směrování aplikace HTTP můžou některé související prostředky Kubernetes zůstat ve vašem clusteru. Mezi tyto prostředky patří mapy konfigurace a tajné kódy vytvořené v oboru názvů kube-system. Pokud chcete udržovat čistý cluster, můžete tyto prostředky odebrat. Pomocí následujících příkazů vyhledejte prostředky addon-http-application-routing: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

    Následující příklad výstupu ukazuje mapy konfigurace, které by se měly odstranit:

    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

  2. Pomocí příkazu odstraňte zbývající prostředky kubectl delete . Nezapomeňte zadat typ prostředku, název prostředku a obor názvů. Následující příklad odstraní jednu z předchozích map konfigurace:

    kubectl delete configmaps addon-http-application-routing-nginx-configuration --namespace kube-system

  3. Opakujte předchozí kubectl delete krok pro všechny prostředky směrování addon-http-application-routing ve vašem clusteru.

Další kroky

Po migraci na doplněk směrování aplikací se dozvíte, jak monitorovat metriky kontroleru příchozího přenosu dat pomocí nástroje Prometheus a Grafana.