Erste Schritte mit Dem Azure Kubernetes-Anwendungsnetzwerk für AKS (Vorschau)

Von Bedeutung

AKS-Vorschaufunktionen sind auf Selbstbedienungsbasis und freiwillig verfügbar. Vorschauversionen werden „im Istzustand“ und „wie verfügbar“ bereitgestellt und sind von den Service Level Agreements und der eingeschränkten Garantie ausgeschlossen. AKS-Vorschauversionen werden teilweise vom Kundensupport auf Grundlage der bestmöglichen Leistung abgedeckt. Daher sind diese Funktionen nicht für die Verwendung in der Produktion vorgesehen. Weitere Informationen finden Sie in den folgenden Supportartikeln:

Dieser Artikel hilft Ihnen bei den ersten Schritten mit Dem Azure Kubernetes-Anwendungsnetzwerk für AKS. Hier finden Sie Schritt-für-Schritt-Anleitungen zum Erstellen einer Anwendungsnetzwerk-Ressource und zum Verbinden eines AKS-Clusters als Mitgliedscluster.

Voraussetzungen

Festlegen von Umgebungsvariablen

  • Legen Sie die folgenden Umgebungsvariablen für Ihre Azure Kubernetes-Anwendungsnetzwerkressource und Ihren Cluster fest. Sie können einen vorhandenen Cluster verwenden oder einen in einem späteren Schritt erstellen, bevor Sie ihn zu Ihrem Azure Kubernetes-Anwendungsnetzwerk hinzufügen.

    export SUBSCRIPTION=<subscription-id>
export LOCATION=<location>
export APPNET_RG=<resource-group-for-appnet-resource>
export APPNET_NAME=<appnet-name>
export APPNET_MEMBER_NAME=<appnet-member-name>
export AKS_RG=<aks-cluster-resource-group>
export CLUSTER_NAME=<cluster-name>

Registrieren des Features für die öffentliche Vorschau

  1. Registrieren Sie das Feature für das Azure Kubernetes-Anwendungsnetzwerk mithilfe des az feature register Befehls.

    az feature register --namespace Microsoft.AppLink --name PublicPreview --subscription $SUBSCRIPTION

  2. Warten Sie, bis das Feature registriert wurde. Sie können den Status mithilfe des az feature show Befehls überprüfen.

    az feature show --namespace Microsoft.AppLink --name PublicPreview --subscription $SUBSCRIPTION

    Das properties.state-Feld in der Ausgabe zeigt Registered an, wenn die Registrierung abgeschlossen ist.

  3. Aktualisieren Sie nach der Registrierung des Features die Registrierung des Microsoft.AppLink-Ressourcenanbieters mithilfe des az provider register Befehls.

    az provider register --namespace Microsoft.AppLink --subscription $SUBSCRIPTION

Installieren der AppNet CLI-Erweiterung

  • Installieren Sie die AppNet CLI-Erweiterung mit dem az extension add Befehl.

    az extension add --name appnet-preview

Festlegen des aktiven Abonnements

  • Legen Sie das aktive Abonnement auf das Abonnement fest, das Sie für Das Azure Kubernetes-Anwendungsnetzwerk mit dem az account set Befehl verwenden möchten.

    az account set --subscription $SUBSCRIPTION

Erstellen eines AKS-Clusters

Hinweis

Mitgliedscluster müssen sich nicht in separaten Ressourcengruppen befinden. Sie können sich in derselben Ressourcengruppe wie die Azure Kubernetes-Anwendungsnetzwerkressource befinden. Alle Membercluster müssen sich jedoch im selben Mandanten befinden.

Wenn Sie nicht über einen vorhandenen AKS-Cluster verfügen, um eine Verbindung mit dem Azure Kubernetes-Anwendungsnetzwerk herzustellen, müssen Sie einen erstellen. Azure Kubernetes-Anwendungsnetzwerk erfordert AKS-Cluster, die die folgenden Anforderungen erfüllen:

Wenn Sie über einen vorhandenen Cluster verfügen, der diese Anforderungen bereits erfüllt, können Sie diesen Schritt überspringen.

  1. Erstellen Sie mithilfe des az group create Befehls eine Ressourcengruppe für Ihren AKS-Cluster.

    az group create --name $AKS_RG --location $LOCATION

  2. Erstellen Sie einen AKS-Cluster mit aktivierter AKS-verwalteter Microsoft Entra-Integration, aktiviertem OIDC-Aussteller und aktiviertem Add-on für die verwaltete Kubernetes Gateway-API, indem Sie den Befehl az aks create mit den Flags --enable-oidc-issuer, --enable-aad und --enable-gateway-api verwenden. Aktivieren Sie das Istio-Dienstgitter-Add-On () auf diesem Cluster --enable-azure-service-mesh.

    az aks create --name $CLUSTER_NAME --resource-group $AKS_RG --enable-oidc-issuer --enable-aad --enable-gateway-api

Erstellen einer Azure Kubernetes-Anwendungsnetzwerkressource

  1. Erstellen Sie mithilfe des az group create Befehls eine Ressourcengruppe für Ihre Azure Kubernetes-Anwendungsnetzwerkressource.

    az group create --name $APPNET_RG --location $LOCATION

  2. Erstellen Sie mithilfe des az appnet create Befehls eine Azure Kubernetes-Anwendungsnetzwerkressource.

    Hinweis

    Sie können den Standort, das Abonnement oder die Ressourcengruppe einer Anwendungsnetzwerkressource nach dem Erstellen nicht mehr ändern.

    az appnet create --resource-group $APPNET_RG --name $APPNET_NAME --location $LOCATION  --identity-type SystemAssigned

    Der Erstellungsprozess kann einige Minuten dauern. Das Feld properties.provisioningState der Ausgabe zeigt Succeeded für ein erfolgreich erstelltes Azure Kubernetes-Anwendungsnetzwerk.

  3. Zeigen Sie Ihre Azure Kubernetes-Anwendungsnetzwerkressource mithilfe des az appnet show Befehls an.

    az appnet show --resource-group $APPNET_RG --name $APPNET_NAME

Beitreten zu einem AKS-Cluster als Mitglied des Azure Kubernetes-Anwendungsnetzwerks

Wenn Sie einem Mitgliedscluster zum Azure Kubernetes-Anwendungsnetzwerk beitreten, können Sie einen der folgenden Upgrademodi für diesen Cluster angeben: vollständig verwaltet oder selbstverwaltet. Der Upgrademodus bestimmt, wie Nebenversionsupgrades des Azure Kubernetes-Anwendungsnetzwerks auf den Membercluster angewendet werden. Wenn Sie während des Mitgliedsbeitritts keinen Aktualisierungsmodus angeben, wird er standardmäßig auf SelfManaged gesetzt. Weitere Informationen zu Upgrademodi finden Sie unter Konfigurieren von Upgrades für Azure Kubernetes Application Network-Mitglieder.

Hinweis

Sie können das übergeordnete Anwendungsnetzwerk, den Standort, das Abonnement oder die Ressourcengruppe eines Mitglieds nach dem Beitritt nicht mehr ändern. Um eines dieser Elemente zu ändern, entfernen Sie das Element, und fügen Sie es erneut mit den neuen Werten hinzu.

  • Schließen Sie einen AKS-Cluster als Mitglied des Azure Kubernetes-Anwendungsnetzwerks mithilfe des az appnet member join-Befehls an, wobei der Parameter --upgrade-mode auf entweder FullyManaged oder SelfManaged gesetzt wird. Das folgende Beispiel zeigt, wie Sie einem Mitgliedscluster im SelfManaged Modus beitreten:

    az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode SelfManaged

Überprüfen der Konnektivität des Mitgliedsclusters

  • Nachdem Sie dem Cluster beigetreten sind, können Sie die Konnektivität überprüfen und Mitgliedsdetails mithilfe des az appnet member show Befehls anzeigen.

    az appnet member show --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME

    Wenn Sie beispielsweise im vollverwalteten Modus im Veröffentlichungskanal Stable registriert sind, sieht die Ausgabe wie folgt aus:

    {
  "id": "/subscriptions/$SUBSCRIPTION/resourceGroups/$APPNET_RG/providers/Microsoft.AppLink/appLinks/$APPNET_NAME/appLinkMembers/$APPNET_MEMBER_NAME",
  "location": "myLocation",
  "name": "myMemberName",
  "properties": {
    "clusterType": "AKS",
    "connectivityProfile": {
      "eastWestGateway": {
        "visibility": "Internal"
      }
    },
    "metadata": {
      "resourceId": "/subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME"
    },
    "observabilityProfile": {
      "metrics": {
        "metricsEndpoint": "https://myMember-mcp-fqdn.appnet.net"
      }
    },
    "provisioningState": "Succeeded",
    "upgradeProfile": {
      "mode": "FullyManaged",
      "fullyManagedUpgradeProfile": {
        "releaseChannel": "Stable"
      }
    }
  },
  "resourceGroup": "myAppNetRG",
  "type": "microsoft.applink/applinks/applinkmembers"
}

Azure Kubernetes-Anwendungsnetzwerkmitglieder auflisten

Mehrere Cluster können einem Azure Kubernetes-Anwendungsnetzwerk beitreten.

  • Alle Mitglieder eines Azure Kubernetes-Anwendungsnetzwerks mithilfe des az appnet member list Befehls auflisten.

    az appnet member list --resource-group $APPNET_RG --appnet-name $APPNET_NAME --output table

Löschen von Azure Kubernetes-Anwendungsnetzwerkressourcen

Wenn Sie eine Azure Kubernetes Application Network-Ressource löschen, werden alle Mitglieder automatisch entfernt, sodass Sie zuerst keine Mitglieder entfernen müssen. Das Entfernen eines Mitglieds, entweder einzeln oder über diese Kaskade, löscht den zugehörigen AKS-Cluster nicht.

Entfernen eines Azure Kubernetes-Anwendungsnetzwerkmitglieds

Hinweis

Bevor Sie ein Mitglied entfernen, müssen Sie Ihre Workloads aus der Umweltdatenebene entfernen, indem Sie Istio-Bezeichnungen, die Sie zuvor angewendet haben, wie z. B. istio.io/use-waypoint, istio.io/use-waypoint-namespace und istio.io/dataplane-mode, aus den Ressourcen entfernen.

  1. Entfernen Sie ein Mitglied aus dem Azure Kubernetes-Anwendungsnetzwerk mithilfe des az appnet member remove Befehls.

    az appnet member remove --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME

  2. Vergewissern Sie sich, dass das Mitglied mithilfe des az appnet member list Befehls entfernt wurde.

    az appnet member list --resource-group $APPNET_RG --appnet-name $APPNET_NAME

Löschen einer Azure Kubernetes-Anwendungsnetzwerkressource

  • Löschen Sie die Azure Kubernetes-Anwendungsnetzwerkressource mithilfe des az appnet delete Befehls.

    az appnet delete --resource-group $APPNET_RG --appnet-name $APPNET_NAME

Verwandte Inhalte

Weitere Informationen zum Azure Kubernetes-Anwendungsnetzwerk finden Sie in den folgenden Artikeln:

  • Zuletzt aktualisiert um