Aan de slag met Azure Kubernetes Application Network voor AKS (preview)

Belangrijk

AKS preview-functies zijn beschikbaar op selfservice, opt-in basis. Previews worden geleverd 'zoals het is' en 'voor zover beschikbaar' en zijn uitgesloten van de serviceovereenkomsten en beperkte garantie. AKS-previews worden gedeeltelijk gedekt door klantondersteuning naar best vermogen. Zodoende zijn deze functies niet bedoeld voor productiegebruik. Zie de volgende ondersteuningsartikelen voor meer informatie:

Dit artikel helpt u aan de slag te gaan met Azure Kubernetes Application Network voor AKS. Het biedt stapsgewijze instructies voor het creëren van een Applicatienetwerkresource en het aansluiten van een AKS-cluster als lidcluster.

Vereiste voorwaarden

Omgevingsvariabelen instellen

  • Stel de volgende omgevingsvariabelen in voor uw Azure Kubernetes Application Network-resource en -cluster. U kunt een bestaand cluster gebruiken of er in een latere stap een maken voordat u dit toevoegt aan uw Azure Kubernetes-toepassingsnetwerk.

    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>

De functie registreren voor openbare preview

  1. Registreer de functie voor Azure Kubernetes Application Network met behulp van de az feature register opdracht.

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

  2. Wacht totdat de functie is geregistreerd. U kunt de status controleren met behulp van de az feature show opdracht.

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

    Het properties.state veld in de uitvoer wordt weergegeven Registered wanneer de registratie is voltooid.

  3. Nadat de functie is geregistreerd, vernieuwt u de registratie van de Microsoft.AppLink-resourceprovider met behulp van de az provider register opdracht.

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

De AppNet CLI-extensie installeren

  • Installeer de AppNet CLI-extensie met behulp van de az extension add opdracht.

    az extension add --name appnet-preview

Actief abonnement instellen

  • Stel het actieve abonnement in op het abonnement dat u wilt gebruiken voor Azure Kubernetes Application Network met behulp van de az account set opdracht.

    az account set --subscription $SUBSCRIPTION

Een AKS-cluster maken

Opmerking

Lidclusters hoeven zich niet in afzonderlijke resourcegroepen te bevinden. Ze kunnen zich in dezelfde resourcegroep bevinden als de Azure Kubernetes Application Network-resource. Alle lidclusters moeten zich echter in dezelfde tenant bevinden.

Als u geen bestaand AKS-cluster hebt om verbinding te maken met Azure Kubernetes Application Network, moet u er een maken. Azure Kubernetes Application Network vereist AKS-clusters die voldoen aan de volgende vereisten:

Als u een bestaand cluster hebt dat al aan deze vereisten voldoet, kunt u deze stap overslaan.

  1. Maak een resourcegroep voor uw AKS-cluster met behulp van de az group create opdracht.

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

  2. Maak een AKS-cluster met door AKS beheerde Microsoft Entra-integratie, OIDC-verlener en de beheerde Kubernetes Gateway-API-invoegtoepassing ingeschakeld met behulp van de opdracht az aks create met de --enable-oidc-issuer, --enable-aad en --enable-gateway-api vlaggen. Schakel de invoegtoepassing Istio-service mesh () --enable-azure-service-mesh in op dit cluster.

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

Een Azure Kubernetes-toepassingsnetwerkresource maken

  1. Maak een resourcegroep voor uw Azure Kubernetes Application Network-resource met behulp van de az group create opdracht.

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

  2. Maak een Azure Kubernetes Application Network-resource met behulp van de az appnet create opdracht.

    Opmerking

    U kunt de locatie, het abonnement of de resourcegroep van een toepassingsnetwerk niet wijzigen nadat u deze hebt gemaakt.

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

    Het maken kan enkele minuten duren. Het veld properties.provisioningState van de uitvoer toont Succeeded voor een succesvol gecreëerd Azure Kubernetes-toepassingsnetwerk.

  3. Bekijk uw Azure Kubernetes Application Network-resource met behulp van de az appnet show opdracht.

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

Een AKS-cluster toevoegen als lid van Azure Kubernetes Application Network

Wanneer u een lidcluster aan Azure Kubernetes Application Network koppelt, kunt u een van de volgende upgrademodi voor dat cluster opgeven: volledig beheerd of zelfbeheerd. De upgrademodus bepaalt hoe secundaire versie-upgrades van Azure Kubernetes Application Network worden toegepast op het lidcluster. Als u geen upgrademodus opgeeft tijdens liddeelname, wordt deze standaard ingesteld op SelfManaged. Zie Upgrades configureren voor leden van Azure Kubernetes Application Network voor meer informatie over upgrademodi.

Opmerking

U kunt het bovenliggende toepassingsnetwerk, de locatie, het abonnement of de resourcegroep van een lid niet meer wijzigen nadat u eraan hebt toegevoegd. Als u een van deze items wilt wijzigen, verwijdert u het lid en voert u deze opnieuw in met de nieuwe waarden.

  • Voeg een AKS-cluster toe als lid van het Azure Kubernetes Application Network met behulp van de az appnet member join opdracht met de --upgrade-mode parameter ingesteld op FullyManaged of SelfManaged. In het volgende voorbeeld ziet u hoe u lid wordt van een lidcluster in SelfManaged de modus:

    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

Connectiviteit van lidcluster controleren

  • Nadat u lid bent van het cluster, kunt u de connectiviteit controleren en de details van leden bekijken met behulp van de az appnet member show opdracht.

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

    Als u bijvoorbeeld bent ingeschreven in de volledig beheerde modus met het Stable releasekanaal, ziet de uitvoer er als volgt uit:

    {
  "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 Application Network-leden vermelden

Meerdere clusters kunnen lid worden van een Azure Kubernetes-toepassingsnetwerk.

  • Geef alle leden van een Azure Kubernetes-toepassingsnetwerk weer met behulp van de az appnet member list opdracht.

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

Azure Kubernetes Application Network-resources verwijderen

Als u een Azure Kubernetes Application Network-resource verwijdert, worden alle leden automatisch verwijderd, zodat u niet eerst leden hoeft te verwijderen. Het verwijderen van een lid, afzonderlijk of via deze cascade, verwijdert het bijbehorende AKS-cluster niet.

Een Lid van een Azure Kubernetes-toepassingsnetwerk verwijderen

Opmerking

Voordat u een lid verwijdert, moet u uw workloads verwijderen uit het omgevingsgegevensvlak door Istio-labels te verwijderen die u eerder hebt toegepast, zoals istio.io/use-waypoint, istio.io/use-waypoint-namespaceen istio.io/dataplane-mode, uit resources.

  1. Verwijder een lid uit Azure Kubernetes Application Network met behulp van de az appnet member remove opdracht.

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

  2. Controleer of het lid is verwijderd met behulp van de az appnet member list opdracht.

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

Een Azure Kubernetes Application Network-resource verwijderen

  • Verwijder de Azure Kubernetes Application Network-resource met behulp van de az appnet delete opdracht.

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

Verwante inhoud

Zie de volgende artikelen voor meer informatie over Azure Kubernetes Application Network:

  • Laatst bijgewerkt om