Kom igång med Azure Kubernetes Application Network for AKS (förhandsversion)

Viktigt!

AKS-förhandsversionsfunktioner är tillgängliga via självbetjäning och frivillig registrering. Förhandsversioner tillhandahålls "i befintligt skick" och "i mån av tillgång," och de är undantagna från servicenivåavtal och begränsad garanti. AKS-förhandsversioner stöds delvis av kundsupport efter bästa förmåga. Därför är dessa funktioner inte avsedda för produktionsanvändning. Mer information finns i följande supportartiklar:

Den här artikeln hjälper dig att komma igång med Azure Kubernetes Application Network för AKS. Den innehåller stegvisa instruktioner för att skapa en programnätverksresurs och ansluta ett AKS-kluster till den som ett medlemskluster.

Förutsättningar

Ange miljövariabler

  • Ange följande miljövariabler för resursen och klustret i Azure Kubernetes Application Network. Du kan använda ett befintligt kluster eller skapa ett i ett senare steg innan du lägger till det i ditt Azure Kubernetes-programnätverk.

    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>

Registrera funktionen för offentlig förhandsversion

  1. Registrera funktionen för Azure Kubernetes Application Network med hjälp av az feature register kommandot .

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

  2. Vänta tills funktionen har registrerats. Du kan kontrollera statusen az feature show med kommandot .

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

    När registreringen är klar visas fältet properties.state i utdata som Registered.

  3. När funktionen har registrerats uppdaterar du registreringen av resursprovidern Microsoft.AppLink med hjälp av az provider register kommandot .

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

Installera AppNet CLI-tillägget

  • Installera AppNet CLI-tillägget med kommandot az extension add .

    az extension add --name appnet-preview

Ange aktiv prenumeration

  • Ange den aktiva prenumerationen till den som du vill använda för Azure Kubernetes Application Network med kommandot az account set .

    az account set --subscription $SUBSCRIPTION

Skapa ett AKS-kluster

Anmärkning

Medlemskluster behöver inte finnas i separata resursgrupper. De kan finnas i samma resursgrupp som Azure Kubernetes Application Network-resursen. Alla medlemskluster måste dock finnas i samma tenant.

Om du inte har ett befintligt AKS-kluster för att ansluta till Azure Kubernetes Application Network måste du skapa ett. Azure Kubernetes Application Network kräver AKS-kluster som uppfyller följande krav:

Om du har ett befintligt kluster som redan uppfyller dessa krav kan du hoppa över det här steget.

  1. Skapa en resursgrupp för ditt AKS-kluster med hjälp av az group create kommandot .

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

  2. Skapa ett AKS-kluster med AKS-hanterad Microsoft Entra-integrering, OIDC-utfärdare och det hanterade Api-tillägget för Kubernetes Gateway aktiverat med kommandot az aks create med --enable-oidc-issuer, --enable-aad och --enable-gateway-api flaggor. Aktivera inte tillägget Istio Service Mesh (--enable-azure-service-mesh) i det här klustret.

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

Skapa en Azure Kubernetes Application Network-resurs

  1. Skapa en resursgrupp för din Azure Kubernetes Application Network-resurs med hjälp av az group create kommandot .

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

  2. Skapa en Azure Kubernetes Application Network-resurs med kommandot az appnet create .

    Anmärkning

    Du kan inte ändra en programnätverksresurss plats, prenumeration eller resursgrupp när du har skapat den.

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

    Skapelseprocessen kan ta några minuter. Det properties.provisioningState-fältet för utdata visar Succeeded för ett framgångsrikt skapat Azure Kubernetes Application Network.

  3. Visa din Azure Kubernetes Application Network-resurs med hjälp av az appnet show kommandot .

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

Ansluta till ett AKS-kluster som medlem i Azure Kubernetes Application Network

När du ansluter ett medlemskluster till Azure Kubernetes Application Network kan du ange något av följande uppgraderingslägen för klustret: fullständigt hanterat eller självhanterat. Uppgraderingsläget avgör hur delversionsuppgraderingar av Azure Kubernetes Application Network tillämpas på medlemsklustret. Om du inte anger ett uppgraderingsläge under medlemsanslutningen är standardinställningen SelfManaged. Mer information om uppgraderingslägen finns i Konfigurera uppgraderingar för Azure Kubernetes Application Network-medlemmar.

Anmärkning

Du kan inte ändra en medlems överordnade Application Network, plats, prenumeration eller resursgrupp efter att du har anslutit den. Om du vill ändra något av dessa tar du bort medlemmen och återansluter den till de nya värdena.

  • Anslut ett AKS-kluster som medlem i Azure Kubernetes Application Network med kommandot az appnet member join med parametern --upgrade-mode inställd på antingen FullyManaged eller SelfManaged. I följande exempel visas hur du ansluter ett medlemskluster i SelfManaged läge:

    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

Verifiera medlemsklusteranslutning

  • När du har anslutit till klustret kan du verifiera anslutningen och visa medlemsinformation med hjälp av az appnet member show kommandot .

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

    Om du till exempel har registrerats i fullständigt hanterat läge med Stable versionskanalen ser utdata så här ut:

    {
  "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"
}

Lista Medlemmar i Azure Kubernetes Application Network

Flera kluster kan ansluta till ett Azure Kubernetes-programnätverk.

  • Visa en lista över alla medlemmar i ett Azure Kubernetes-programnätverk med kommandot az appnet member list .

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

Ta bort Azure Kubernetes Application Network-resurser

Om du tar bort en Azure Kubernetes Application Network-resurs tas alla medlemmar bort automatiskt, så du behöver inte ta bort medlemmar först. Om du tar bort en medlem, antingen individuellt eller via den här kaskaden, tas inte motsvarande AKS-kluster bort.

Ta bort en Azure Kubernetes-programnätverksmedlem

Anmärkning

Innan du tar bort en medlem måste du ta bort dina arbetsbelastningar från det omgivande dataplanet genom att ta bort Istio-etiketter som du använde tidigare, till exempel istio.io/use-waypoint, istio.io/use-waypoint-namespaceoch istio.io/dataplane-mode, från resurser.

  1. Ta bort en medlem från Azure Kubernetes Application Network med kommandot az appnet member remove .

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

  2. Kontrollera att medlemmen har tagits bort med kommandot az appnet member list .

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

Ta bort en Azure Kubernetes-programnätverksresurs

  • Ta bort Azure Kubernetes Application Network-resursen az appnet delete med kommandot .

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

Relaterat innehåll

Mer information om Azure Kubernetes Application Network finns i följande artiklar:

  • Uppdaterades senast