Share via

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 des objets de service de cluster pré-intermédiaires 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 permettre à AKS activé par Arc d’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). Vous devez également créer un enregistrement DNS associé pointant 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 de ce processus, consultez la documentation consacrée au clustering de basculement.

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

Notes

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

Étape 2 : Préparer votre ou vos machines en vue du déploiement

Exécutez des vérifications sur chaque nœud physique pour voir si toutes les conditions requises sont remplies 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 que les nœuds de votre déploiement doivent 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 fournies 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 fournies 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 le nom de votre abonnement et de votre 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

Lors de 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 que son champ de distribution possède la valeur aks_management. La suppression de cette ressource entraîne un déploiement hors stratégie.

Dans ce guide pratique, vous avez appris à configurer un hôte AKS à l’aide de PowerShell si vous disposez d’objets de service de cluster pré-intermédiaires et d’enregistrements DNS.

Étapes suivantes