Introduzione all'applicazione di rete di Azure Kubernetes per AKS (anteprima)

Importante

Le funzionalità di anteprima di AKS sono disponibili su base self-service, su scelta. Le anteprime vengono fornite "così come sono" e "come disponibili" e sono escluse dai contratti di servizio e dalla garanzia limitata. Le anteprime del servizio Azure Kubernetes sono parzialmente coperte dal supporto clienti con la massima diligenza possibile. Di conseguenza, queste funzionalità non sono destinate all'uso in produzione. Per altre informazioni, vedere gli articoli di supporto seguenti:

Questo articolo aiuta a iniziare con Azure Kubernetes Application Network per AKS. Il documento fornisce istruzioni dettagliate su come creare una risorsa Application Network e connettere un cluster del servizio Azure Kubernetes (AKS) come cluster membro dell'Application Network.

Prerequisiti

Impostare le variabili di ambiente

  • Impostare le variabili di ambiente seguenti per la risorsa e il cluster della rete dell'applicazione Azure Kubernetes. È possibile usare un cluster esistente o crearne uno in un passaggio successivo prima di aggiungerlo alla rete dell'applicazione Azure Kubernetes.

    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>

Registrare la funzionalità per l'anteprima pubblica

  1. Registrare la funzionalità per la rete di applicazioni Azure Kubernetes usando il az feature register comando .

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

  2. Attendere la registrazione della funzionalità. È possibile controllare lo stato usando il az feature show comando .

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

    Il campo properties.state nell'output mostrerà Registered quando la registrazione sarà completata.

  3. Dopo aver registrato la funzionalità, aggiornare la registrazione del provider di risorse Microsoft.AppLink usando il az provider register comando .

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

Installare l'estensione dell'interfaccia della riga di comando di AppNet

  • Installare l'estensione dell'interfaccia della riga di comando di AppNet usando il az extension add comando .

    az extension add --name appnet-preview

Impostare una sottoscrizione attiva

  • Impostare la sottoscrizione attiva su quella che si vuole usare per la rete di applicazioni di Azure Kubernetes usando il az account set comando .

    az account set --subscription $SUBSCRIPTION

Crea un cluster AKS

Annotazioni

I cluster membri non devono trovarsi in gruppi di risorse separati. Possono trovarsi nello stesso gruppo di risorse della risorsa rete dell'applicazione Azure Kubernetes. Tuttavia, tutti i cluster membri devono trovarsi nello stesso tenant.

Se non si dispone di un cluster del servizio Azure Kubernetes esistente per connettersi alla rete di applicazioni di Azure Kubernetes, è necessario crearne uno. Azure Kubernetes Application Network richiede che i cluster AKS soddisfino i seguenti requisiti:

Se si dispone di un cluster esistente che soddisfa già questi requisiti, è possibile ignorare questo passaggio.

  1. Creare un gruppo di risorse per il cluster AKS usando il comando az group create.

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

  2. Crea un cluster AKS con l'integrazione di Microsoft Entra gestita da AKS, un emittente OIDC e il componente aggiuntivo API Kubernetes Gateway gestito abilitato, utilizzando il comando az aks create con i flag --enable-oidc-issuer, --enable-aade --enable-gateway-api . Non abilitare il componente aggiuntivo Istio Service Mesh (--enable-azure-service-mesh) su questo cluster.

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

Creare una risorsa di rete dell'applicazione Azure Kubernetes

  1. Creare un gruppo di risorse per la risorsa di rete dell'applicazione Azure Kubernetes usando il az group create comando .

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

  2. Creare una risorsa di rete dell'applicazione Azure Kubernetes usando il az appnet create comando .

    Annotazioni

    Non è possibile modificare la posizione, la sottoscrizione o il gruppo di risorse di una risorsa di rete dell'applicazione dopo averlo creato.

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

    Il processo di creazione potrebbe richiedere alcuni minuti. Il campo properties.provisioningState dell'output mostra Succeeded per una Application Network di Azure Kubernetes creata correttamente.

  3. Visualizzare la risorsa di rete dell'applicazione Azure Kubernetes usando il az appnet show comando .

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

Unirsi a un cluster AKS come membro della rete delle applicazioni di Azure Kubernetes

Quando si aggiunge un cluster membro alla rete dell'applicazione Azure Kubernetes, è possibile specificare una delle modalità di aggiornamento seguenti per il cluster: completamente gestito o autogestito. La modalità di aggiornamento determina il modo in cui gli aggiornamenti di versione secondaria della rete dell'applicazione Azure Kubernetes vengono applicati al cluster membro. Se non si specifica una modalità di aggiornamento al momento dell'adesione come membro, viene impostata per impostazione predefinita su SelfManaged. Per altre informazioni sulle modalità di aggiornamento, vedere Configurare gli aggiornamenti per i membri della rete dell'applicazione Azure Kubernetes.

Annotazioni

Non è possibile modificare l'Application Network padre, la posizione, la sottoscrizione o il gruppo di risorse di un membro dopo averlo aggiunto. Per modificare uno di questi valori, rimuovere il membro e aggiungerlo di nuovo con i nuovi valori.

  • Unirsi a un cluster AKS come membro della rete delle applicazioni di Azure Kubernetes usando il comando az appnet member join con il parametro --upgrade-mode impostato su FullyManaged o SelfManaged. L'esempio seguente illustra come unire un cluster membro in modalità SelfManaged.

    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

Verificare la connettività del cluster membro

  • Dopo aver aggiunto il cluster, è possibile verificare la connettività e visualizzare i dettagli dei membri usando il az appnet member show comando .

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

    Ad esempio, se registrato in modalità completamente gestita con Stable il canale di rilascio, l'output sarà simile al seguente:

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

Elencare i membri della rete dell'applicazione Azure Kubernetes

Più cluster possono essere aggiunti a una rete di applicazioni Azure Kubernetes.

  • Elencare tutti i membri di una rete di applicazioni Azure Kubernetes usando il az appnet member list comando .

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

Eliminare le risorse di rete dell'applicazione Azure Kubernetes

L'eliminazione di un Azure risorsa di rete dell'applicazione Kubernetes rimuove automaticamente tutti i relativi membri, quindi non è necessario rimuovere prima i membri. La rimozione di un membro, sia singolarmente sia tramite questo effetto a catena, non elimina il cluster AKS corrispondente.

Rimuovere un membro di rete dell'applicazione Azure Kubernetes

Annotazioni

Prima di rimuovere un membro, è necessario rimuovere i carichi di lavoro dal piano dati di ambiente rimuovendo le etichette Istio applicate in precedenza, ad esempio istio.io/use-waypoint, istio.io/use-waypoint-namespacee istio.io/dataplane-mode, dalle risorse.

  1. Rimuovere un membro dalla rete di applicazioni di Azure Kubernetes usando il az appnet member remove comando .

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

  2. Verificare che il membro sia stato rimosso usando il az appnet member list comando .

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

Eliminare una risorsa di rete dell'applicazione Azure Kubernetes

  • Eliminare la risorsa rete dell'applicazione Azure Kubernetes usando il az appnet delete comando .

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

Contenuti correlati

Per altre informazioni sulla rete applicativa di Azure Kubernetes, vedere gli articoli seguenti:

  • Ultimo aggiornamento: