Démarrage rapide : créer une ressource Azure Kubernetes Fleet Manager et joindre des clusters membres en utilisant l’interface Azure CLI

Article
10/15/2024

Prise en main d’Azure Kubernetes Fleet Manager (Fleet) à l’aide d’Azure CLI pour créer une ressource Fleet et connecter ultérieurement des clusters Azure Kubernetes Service (AKS) en tant que clusters membres.

Prérequis

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.

Lisez la vue d’ensemble des concepts de cette fonctionnalité, qui fournit une explication des flottes et des groupes de membres mentionnés dans ce document.
Lisez la vue d’ensemble conceptuelle des types de flotte, qui fournit une comparaison des différentes options de configuration de la flotte.
Compte Azure avec un abonnement actif. Créez un compte gratuitement.
Une identité (utilisateur ou principal de service) qui peut être utilisée pour se connecter à Azure CLI. Cette identité doit disposer des autorisations suivantes sur les types de ressources Fleet et AKS pour effectuer les étapes répertoriées dans ce démarrage rapide :
- Microsoft.ContainerService/fleets/read
- Microsoft.ContainerService/fleets/write
- Microsoft.ContainerService/fleets/members/read
- Microsoft.ContainerService/fleets/members/write
- Microsoft.ContainerService/fleetMemberships/read
- Microsoft.ContainerService/fleetMemberships/write
- Microsoft.ContainerService/managedClusters/read
- Microsoft.ContainerService/managedClusters/write
Installez ou mettez à niveau l’interface Azure CLI vers une version 2.53.1 ou ultérieure.
Installez l’extension Azure CLI de flotte en utilisant la commande az extension add et vérifiez que votre version est au moins 1.0.0.
```
az extension add --name fleet
```

Définissez les variables d’environnement suivantes :

export SUBSCRIPTION_ID=<subscription_id>
export GROUP=<your_resource_group_name>
export FLEET=<your_fleet_name>

Installez kubectl et kubelogin en utilisant la commande az aks install-cli.
```
az aks install-cli
```
Les clusters AKS que vous souhaitez joindre en tant que clusters membres à la ressource Flotte doivent se trouver dans les versions prises en charge d’AKS. En savoir plus sur la stratégie de prise en charge des versions AKS ici.

Créer un groupe de ressources

Un groupe de ressources Azure est un groupe logique dans lequel des ressources Azure sont déployées et gérées. Lorsque vous créez un groupe de ressources, vous êtes invité à spécifier un emplacement. Cet emplacement est l'emplacement de stockage des métadonnées de votre groupe de ressources et l'endroit où vos ressources s'exécutent dans Azure si vous ne spécifiez pas un autre emplacement lors de la création de la ressource.

Définissez l’abonnement Azure et créez un groupe de ressources en tirant parti de la commande az group create.

az account set -s ${SUBSCRIPTION_ID}
az group create --name ${GROUP} --location eastus

L’exemple de sortie suivant montre la création réussie du groupe de ressources :

{
  "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/fleet-demo",
  "location": "eastus",
  "managedBy": null,
  "name": "fleet-demo",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Créer une ressource Fleet

Vous pouvez créer une ressource Flotte pour regrouper ultérieurement vos clusters AKS en tant que clusters membres. Lors de la création via Azure CLI, par défaut, cette ressource active le regroupement de clusters membres et met à jour l’orchestration. Si le hub Flotte est activé, d’autres fonctionnalités d’évaluation sont activées, telles que la propagation d'objets Kubernetes vers les clusters membres et l'équilibrage de la charge des services L4 sur plusieurs clusters membres. Pour plus d’informations, consultez la vue d’ensemble conceptuelle des types de flotte, qui fournit une comparaison des différentes configurations de flotte.

Important

Une fois qu’une ressource Kubernetes Fleet a été créée, il est possible de mettre à niveau une ressource Kubernetes Fleet sans cluster hub vers un avec un cluster hub. Pour les ressources Kubernetes Fleet avec un cluster hub, une fois que le cluster privé ou public a été sélectionné, il ne peut pas être modifié.

Ressource Kubernetes Fleet sans cluster hub
Ressource Kubernetes Fleet avec cluster hub

Si vous voulez utiliser Fleet uniquement pour l’orchestration des mises à jour qui est l’expérience par défaut lors d’une création de ressource Fleet via Azure CLI, vous pouvez créer une ressource Fleet sans cluster hub en utilisant la commande az fleet create.

az fleet create --resource-group ${GROUP} --name ${FLEET} --location eastus

Vous devez obtenir un résultat semblable à l’exemple de sortie qui suit :

{
  "etag": "...",
  "hubProfile": null,
  "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/fleet-demo/providers/Microsoft.ContainerService/fleets/fleet-demo",
  "identity": {
    "principalId": null,
    "tenantId": null,
    "type": "None",
    "userAssignedIdentities": null
  },
  "location": "eastus",
  "name": "fleet-demo",
  "provisioningState": "Succeeded",
  "resourceGroup": "fleet-demo",
  "systemData": {
    "createdAt": "2023-11-03T17:15:19.610149+00:00",
    "createdBy": "<user>",
    "createdByType": "User",
    "lastModifiedAt": "2023-11-03T17:15:19.610149+00:00",
    "lastModifiedBy": "<user>",
    "lastModifiedByType": "User"
  },
  "tags": null,
  "type": "Microsoft.ContainerService/fleets"
}

Si vous souhaitez utiliser Flotte pour la propagation d’objets Kubernetes et l’équilibrage de charge multi-cluster en plus de l’orchestration des mises à jour, vous devez créer la ressource Flotte avec le cluster hub activé en spécifiant le paramètre --enable-hub avec la commande az fleet create.

Les clusters Kubernetes Fleet avec un cluster hub prennent en charge les modes public et privé pour l’accès réseau. Pour plus d’informations, consultez [Choisir une option Azure Kubernetes Fleet Manager](./concepts-choose-fleet.md#network-access-modes-for-hub-cluster.

Remarque

Par défaut, les ressources Kubernetes Fleet avec des clusters hub sont publiques et Fleet choisit la référence SKU de machine virtuelle utilisée pour le nœud hub (à ce stade, il essaie « Standard_D4s_v4 », « Standard_D4s_v3 », « Standard_D4s_v5 », « Standard_Ds3_v2 », « Standard_E4as_v4 » dans l’ordre). Si aucune de ces options n’est acceptable ou disponible, vous pouvez sélectionner une référence SKU de machine virtuelle en définissant --vm-size <SKU>.

Cluster hub public

Pour créer une ressource Kubernetes Fleet publique avec un cluster hub, utilisez la commande az fleet create avec l’indicateur --enable-hub défini.

az fleet create --resource-group ${GROUP} --name ${FLEET} --location eastus --enable-hub

Vous devez obtenir un résultat semblable à l’exemple de sortie qui suit :

{
  "etag": "...",
  "hubProfile": null,
  "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/fleet-demo/providers/Microsoft.ContainerService/fleets/fleet-demo",
  "identity": {
    "principalId": null,
    "tenantId": null,
    "type": "None",
    "userAssignedIdentities": null
  },
  "location": "eastus",
  "name": "fleet-demo",
  "provisioningState": "Succeeded",
  "resourceGroup": "fleet-demo",
  "systemData": {
    "createdAt": "2023-11-03T17:15:19.610149+00:00",
    "createdBy": "<user>",
    "createdByType": "User",
    "lastModifiedAt": "2023-11-03T17:15:19.610149+00:00",
    "lastModifiedBy": "<user>",
    "lastModifiedByType": "User"
  },
  "tags": null,
  "type": "Microsoft.ContainerService/fleets"
}

Cluster hub privé

Lors de la création d’une ressource Kubernetes Fleet en mode d’accès privé avec un cluster hub, certaines considérations supplémentaires s’appliquent :

Fleet vous oblige à fournir le sous-réseau sur lequel les machines virtuelles de nœud du cluster hub Fleet seront placées. Vous pouvez spécifier cela au moment de la création en définissant --agent-subnet-id <subnet>. Cette commande diffère de celle que vous utilisez pour travailler directement avec un cluster AKS privé dans lequel il s’agit d’un argument requis pour Fleet, mais pas pour AKS.
Le préfixe d’adresse du réseau virtuel dont le sous-réseau est transmis via --vnet-subnet-id ne doit pas chevaucher la plage de services par défaut AKS de 10.0.0.0/16.
Lorsque vous utilisez un cluster privé AKS, vous pouvez configurer des noms de domaine complets (FQDN) et des sous-domaines FQDN. Cette fonctionnalité ne s’applique pas au cluster hub de type de mode d’accès privé.

Tout d’abord, créez un réseau virtuel et un sous-réseau pour les machines virtuelles de nœud de votre cluster hub à l’aide des commandes az network vnet create et az network vnet subnet create.

az network vnet create --resource-group ${GROUP} --name vnet --address-prefixes 192.168.0.0/16
az network vnet subnet create --resource-group ${GROUP} --vnet-name vnet --name subnet --address-prefixes 192.168.0.0/24

SUBNET_ID=$(az network vnet subnet show --resource-group ${GROUP} --vnet-name vnet -n subnet -o tsv --query id)

Pour créer une ressource Kubernetes Fleet en mode d’accès privé, utilisez la commande az fleet create avec l’indicateur --enable-private-cluster et fournissez l’ID de sous-réseau obtenu à l’étape précédente à l’argument --agent-subnet-id <subnet>.

az fleet create --resource-group ${GROUP} --name ${FLEET} --enable-hub --enable-private-cluster --agent-subnet-id "${SUBNET_ID}"

Joindre des clusters membres

Fleet prend actuellement en charge la jointure de clusters AKS existants en tant que clusters membres.

Définissez les variables d’environnement suivantes pour les clusters membres :

export MEMBER_NAME_1=aks-member-1
export MEMBER_CLUSTER_ID_1=/subscriptions/${SUBSCRIPTION_ID}/resourceGroups/${GROUP}/providers/Microsoft.ContainerService/managedClusters/${MEMBER_NAME_1}

Joignez vos clusters AKS existants à la ressource Flotte en utilisant la commande az fleet member create.

# Join the first member cluster
az fleet member create --resource-group ${GROUP} --fleet-name ${FLEET} --name ${MEMBER_NAME_1} --member-cluster-id ${MEMBER_CLUSTER_ID_1}

Vous devez obtenir un résultat semblable à l’exemple de sortie qui suit :

{
  "clusterResourceId": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-x",
  "etag": "...",
  "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/fleets/<FLEET>/members/aks-member-x",
  "name": "aks-member-1",
  "provisioningState": "Succeeded",
  "resourceGroup": "<GROUP>",
  "systemData": {
    "createdAt": "2022-10-04T19:04:56.455813+00:00",
    "createdBy": "<user>",
    "createdByType": "User",
    "lastModifiedAt": "2022-10-04T19:04:56.455813+00:00",
    "lastModifiedBy": "<user>",
    "lastModifiedByType": "User"
  },
  "type": "Microsoft.ContainerService/fleets/members"
}

Vérifiez que les clusters membres ont correctement joint la ressource Fleet à l’aide de la commande az fleet member list.

az fleet member list --resource-group ${GROUP} --fleet-name ${FLEET} -o table

Si c’est le cas, vous devez obtenir un résultat semblable à l’exemple de sortie suivant :

ClusterResourceId                                                                                                                                Name          ProvisioningState    ResourceGroup
-----------------------------------------------------------------------------------------------------------------------------------------------  ------------  -------------------  ---------------
/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-1  aks-member-1  Succeeded            <GROUP>
/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-2  aks-member-2  Succeeded            <GROUP>
/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-3  aks-member-3  Succeeded            <GROUP>

Étapes suivantes

Accédez à l’API Kubernetes de la ressource Fleet.

Partager via

Démarrage rapide : créer une ressource Azure Kubernetes Fleet Manager et joindre des clusters membres en utilisant l’interface Azure CLI

Prérequis

Créer un groupe de ressources

Créer une ressource Fleet

Cluster hub public

Cluster hub privé

Joindre des clusters membres

Étapes suivantes

Ressources supplémentaires