Déployer un hôte Azure Kubernetes Service avec des objets de service de cluster pré-intermédiaires et des enregistrements DNS à l’aide de PowerShell

  • Article

S’applique à : AKS sur Azure Stack HCI 22H2, AKS sur Windows Server

Ce guide pratique explique comment utiliser PowerShell pour configurer votre déploiement d’hôte AKS si vous avez pré-intermédiaire des objets de service de cluster et des enregistrements DNS dans AKS activés par Azure Arc.

Avant de commencer

Étape 1 : Préparer votre instance d'Active Directory et votre serveur DNS pour le déploiement

Si vous ne pouvez pas activer les mises à jour DNS dynamiques dans votre environnement DNS pour autoriser AKS activé par Arc à inscrire le nom de cluster générique de l’agent cloud dans Active Directory et le système DNS pour la découverte, vous devez précréer les enregistrements respectifs dans Active Directory et DNS.

Créez un service de cluster générique dans Active Directory avec le nom ca-cloudagent (ou un nom de votre choix qui ne dépasse pas 32 caractères). Créez également un enregistrement DNS associé qui pointe vers le nom de domaine complet du service de cluster générique avec l’adresse fournie cloudservicecidr . Pour plus d’informations sur les étapes décrites dans ce processus, consultez la documentation sur le clustering de basculement.

Le déploiement AKS tente de localiser le fichier spécifié clusterRoleName dans Active Directory avant de poursuivre le déploiement.

Remarque

Une fois AKS déployé, ces informations ne peuvent pas être modifiées.

Étape 2 : Préparer vos machines pour le déploiement

Exécutez des vérifications sur chaque nœud physique pour voir si toutes les exigences sont satisfaites pour installer AKS Arc. Ouvrez PowerShell en tant qu’administrateur et exécutez la commande Initialize-AksHciNode suivante :

Initialize-AksHciNode

Étape 3 : Créer un réseau virtuel

Pour créer un réseau virtuel pour les nœuds de votre déploiement à utiliser, créez une variable d’environnement avec la New-AksHciNetworkSetting commande PowerShell. Cette variable est utilisée ultérieurement pour configurer un déploiement qui utilise une adresse IP statique. Si vous souhaitez configurer votre déploiement AKS avec DHCP, consultez New-AksHciNetworkSetting pour obtenir des exemples. Vous pouvez également passer en revue certains concepts liés au nœud Mise en réseau.

# static IP
$vnet = New-AksHciNetworkSetting -name mgmt-vnet -vSwitchName "extSwitch" -k8sNodeIpPoolStart "172.16.10.1" -k8sNodeIpPoolEnd "172.16.10.255" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -ipAddressPrefix "172.16.0.0/16" -gateway "172.16.0.1" -dnsServers "172.16.0.1"

Remarque

Vous devez personnaliser les valeurs affichées dans cet exemple de commande pour votre environnement.

Étape 4 : Configurer votre déploiement avec les objets de service de cluster pré-intermédiaires et les enregistrements DNS

Définissez les paramètres de configuration de l’hôte AKS à l’aide de la commande Set-AksHciConfig . Vous devez spécifier les paramètres workingDir, cloudServiceCidr, cloudConfigLocation et clusterRoleName. Si vous souhaitez redéfinir des détails de votre configuration, réexécutez la commande avec de nouveaux paramètres.

Configurez votre déploiement avec la commande suivante.

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16" -clusterRoleName "ca-cloudagent"

Remarque

Personnalisez les valeurs indiquées dans cet exemple de commande pour votre environnement.

Étape 5 : Se connecter à Azure et configurer les paramètres d’inscription

Exécutez la commande PowerShell Set-AksHciRegistration suivante avec votre abonnement et le nom du groupe de ressources pour vous connecter à Azure. Vous devez disposer d’un abonnement Azure et d’un groupe de ressources Azure existant dans les régions Azure USA Est, Asie Sud-Est ou Europe Ouest pour continuer :

Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"

Étape 6 : Démarrer un nouveau déploiement

Après avoir configuré votre déploiement, vous devez le démarrer. Le démarrage du déploiement installe les agents/services AKS et l’hôte AKS. Pour commencer le déploiement, exécutez la commande suivante :

Install-AksHci

Avertissement

Pendant l’installation de votre hôte AKS, un type de ressource Kubernetes - Azure Arc est créé dans le groupe de ressources défini lors de l’inscription. Ne supprimez pas cette ressource, car elle représente votre hôte Azure Kubernetes Service. Vous pouvez identifier la ressource en vérifiant son champ de distribution pour la aks_management valeur. La suppression de cette ressource entraîne un déploiement hors stratégie.

Étapes suivantes