Prise en main d’Azure Kubernetes Application Network pour AKS (préversion)

Important

Les fonctionnalités d’évaluation AKS sont disponibles en libre-service et font l’objet d’un abonnement. Les versions d'essai sont fournies « en l’état » et « selon disponibilité », et elles sont exclues des contrats de niveau de service et de la garantie limitée. Les versions préliminaires AKS sont, dans la mesure du possible, partiellement couvertes par le service clientèle. Par conséquent, ces fonctionnalités ne sont pas destinées à une utilisation en production. Pour plus d’informations, consultez les articles de support suivants :

Cet article vous aide à bien démarrer avec Azure Kubernetes Application Network pour AKS. Il fournit des instructions pas à pas pour créer une ressource Réseau d’applications et connecter un cluster AKS en tant que cluster membre.

Prerequisites

Définir des variables d’environnement

  • Définissez les variables d’environnement suivantes pour votre ressource et votre cluster Azure Kubernetes Application Network. Vous pouvez utiliser un cluster existant ou en créer un dans une étape ultérieure avant de l’ajouter à votre réseau d’applications 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>

Inscrire la fonctionnalité pour une aperçu publique

  1. Inscrivez la fonctionnalité pour Azure Kubernetes Application Network à l’aide de la az feature register commande.

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

  2. Attendez que la fonctionnalité soit enregistrée. Vous pouvez vérifier l’état à l’aide de la az feature show commande.

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

    Le properties.state champ de la sortie affichera Registered une fois l’inscription terminée.

  3. Une fois la fonctionnalité inscrite, actualisez l’inscription du fournisseur de ressources Microsoft.AppLink à l’aide de la az provider register commande.

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

Installer l’extension APPNet CLI

  • Installez l’extension CLI AppNet à l’aide de la az extension add commande.

    az extension add --name appnet-preview

Définir un abonnement actif

  • Définissez l’abonnement actif sur celui que vous souhaitez utiliser pour le Réseau d'application Azure Kubernetes à l’aide de la commande az account set.

    az account set --subscription $SUBSCRIPTION

Créer un cluster AKS

Note

Les clusters membres n’ont pas besoin d’être dans des groupes de ressources distincts. Ils peuvent se trouver dans le même groupe de ressources que la ressource Azure Kubernetes Application Network. Cependant, tous les clusters membres doivent être dans le même locataire.

Si vous n’avez pas de cluster AKS existant pour vous connecter au réseau d’applications Azure Kubernetes, vous devez en créer un. Azure Réseau d’applications Kubernetes nécessite des clusters AKS répondant aux exigences suivantes :

Si vous disposez d’un cluster existant qui répond déjà à ces exigences, vous pouvez ignorer cette étape.

  1. Créez un groupe de ressources pour votre cluster AKS à l’aide de la az group create commande.

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

  2. Créez un cluster AKS avec l’intégration Microsoft Entra gérée par AKS, l’émetteur OIDC et le module complémentaire d’API Kubernetes Gateway managé activé à l’aide de la commande az aks create avec les indicateurs --enable-oidc-issuer, --enable-aad et --enable-gateway-api. N’activez pas le module complémentaire Istio Service Mesh (--enable-azure-service-mesh) sur ce cluster.

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

Créer une ressource Azure Kubernetes Application Network

  1. Créez un groupe de ressources pour votre ressource Azure Kubernetes Application Network à l’aide de la az group create commande.

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

  2. Créez une ressource Azure Kubernetes Application Network à l’aide de la az appnet create commande.

    Note

    Vous ne pouvez pas modifier l’emplacement, l’abonnement ou le groupe de ressources d’une ressource Réseau d’applications après sa création.

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

    Le processus de création peut prendre quelques minutes. Le properties.provisioningState champ de la sortie s’affiche Succeeded pour un réseau d’applications Azure Kubernetes créé avec succès.

  3. Affichez votre ressource Réseau d’applications Azure Kubernetes à l’aide de la az appnet show commande.

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

Rejoindre un cluster AKS en tant que membre d’Azure Kubernetes Application Network

Lorsque vous joignez un cluster membre à Azure Kubernetes Application Network, vous pouvez spécifier l’un des modes de mise à niveau suivants pour ce cluster : complètement géré ou autogéré. Le mode de mise à niveau détermine la façon dont les mises à niveau de version mineures du réseau d’applications Azure Kubernetes sont appliquées au cluster membre. Si vous ne spécifiez pas de mode de mise à niveau pendant la jointure de membre, la valeur par défaut SelfManagedest . Pour plus d’informations sur les modes de mise à niveau, consultez Configurer les mises à niveau pour les membres azure Kubernetes Application Network.

Note

Vous ne pouvez pas modifier le réseau d’applications parent, l’emplacement, l’abonnement ou le groupe de ressources d’un membre après l’avoir rejoint. Pour modifier l’un de ces éléments, supprimez le membre et rejoignez-le avec les nouvelles valeurs.

  • Rejoignez un cluster AKS en tant que membre d’Azure Kubernetes Application Network à l’aide de la commande az appnet member join avec le paramètre défini sur soit l’une ou l’autre --upgrade-mode ou FullyManaged ou SelfManaged. L’exemple suivant montre comment joindre un cluster membre en SelfManaged mode :

    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

Vérifier la connectivité du cluster membre

  • Après avoir rejoint le cluster, vous pouvez vérifier la connectivité et afficher les détails des membres à l’aide de la az appnet member show commande.

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

    Par exemple, si elle est inscrite en mode entièrement géré avec Stable le canal de diffusion, la sortie ressemble à ceci :

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

Répertorier les membres du réseau d’applications Azure Kubernetes

Plusieurs clusters peuvent rejoindre un réseau d’applications Azure Kubernetes.

  • Répertoriez tous les membres d’un réseau d’applications Azure Kubernetes à l’aide de la az appnet member list commande.

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

Supprimer les ressources Azure Kubernetes Application Network

La suppression d'une ressource de réseau d'applications Kubernetes Azure supprime automatiquement tous ses membres. Vous n'avez donc pas besoin de supprimer d'abord les membres. La suppression d’un membre, individuellement ou via cette cascade, ne supprime pas le cluster AKS correspondant.

Supprimer un membre Azure Kubernetes Application Network

Note

Avant de supprimer un membre, vous devez supprimer vos charges de travail du plan de données ambiant en supprimant les étiquettes Istio que vous avez précédemment appliquées, telles que istio.io/use-waypoint, istio.io/use-waypoint-namespaceet istio.io/dataplane-mode, des ressources.

  1. Supprimez un membre d’Azure Kubernetes Application Network à l’aide de la az appnet member remove commande.

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

  2. Vérifiez que le membre a été supprimé à l’aide de la az appnet member list commande.

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

Supprimer une ressource Réseau d’applications Azure Kubernetes

  • Supprimez la ressource Réseau d’applications Azure Kubernetes à l’aide de la az appnet delete commande.

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

Contenu connexe

Pour en savoir plus sur Azure Kubernetes Application Network, consultez les articles suivants :

  • Dernière mise à jour :