Set-AksHciConfig
Synopsis
Définit ou met à jour les paramètres de configuration de l’hôte Azure Kubernetes Service.
Syntaxe
Définir la configuration de l’hôte
Set-AksHciConfig -imageDir <String>
-workingDir <String>
-cloudConfigLocation <String>
-vnet <Virtual Network>
[-createAutoConfigContainers {true, false}]
[-offlineDownload]
[-offsiteTransferCompleted]
[-mode {minimum, full}]
[-stagingShare <String>]
[-nodeConfigLocation <String>]
[-controlPlaneVmSize <VmSize>]
[-sshPublicKey <String>]
[-macPoolStart <String>]
[-macPoolEnd <String>]
[-proxySettings <ProxySettings>]
[-cloudServiceCidr <String>]
[-version <String>]
[-nodeAgentPort <int>]
[-nodeAgentAuthorizerPort <int>]
[-cloudAgentPort <int>]
[-cloudAgentAuthorizerPort <int>]
[-clusterRoleName <String>]
[-cloudLocation <String>]
[-concurrentDownloads <int>]
[-skipHostLimitChecks]
[-skipRemotingChecks]
[-skipValidationChecks]
[-insecure]
[-skipUpdates]
[-forceDnsReplication]
Description
Définit les paramètres de configuration de l’hôte Azure Kubernetes Service. Si vous effectuez un déploiement sur un cluster local Azure de 2 à 4 nœuds ou un cluster de basculement Windows Server 2019 Datacenter, vous devez spécifier les paramètres et -cloudConfigLocation les -workingDir paramètres. Pour un Centre de données Windows Server 2019 à nœud unique, tous les paramètres sont facultatifs et définis sur leurs valeurs par défaut. Toutefois, pour des performances optimales, nous vous recommandons d’utiliser un déploiement de cluster local Azure à 2 à 4 nœuds.
Exemples
Pour effectuer un déploiement sur un cluster comprenant entre deux et quatre nœuds avec le réseau DHCP
PS C:\> $vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254"
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Pour déployer avec un réseau IP statique
PS C:\> $vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -k8snodeippoolstart "172.16.10.0" -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"
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Pour effectuer un déploiement avec un serveur proxy
PS C:\> $proxySettings = New-AksHciProxySetting -name "corpProxy" -http http://contosoproxy:8080 -https https://contosoproxy:8443 -noProxy localhost,127.0.0.1,.svc,10.96.0.0/12,10.244.0.0/16 -credential $proxyCredential
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -proxySetting $proxySettings -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Paramètres
-imageDir
Chemin d’accès au répertoire dans lequel AKS hybride stocke ses images de disque dur virtuel. Ce paramètre est obligatoire. Le chemin doit pointer vers un chemin de stockage partagé, tel que C:\ClusterStorage\Volume2\ImageStore, ou un partage SMB, tel que \\FileShare\ImageStore.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: %systemdrive%\AksHciImageStore
Accept pipeline input: False
Accept wildcard characters: False
-workingDir
Répertoire de travail du module à utiliser pour stocker de petits fichiers. Ce paramètre est obligatoire. Le chemin doit pointer vers un chemin de stockage partagé, tel que c:\ClusterStorage\Volume2\ImageStore.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: %systemdrive%\AksHci
Accept pipeline input: False
Accept wildcard characters: False
-cloudConfigLocation
Emplacement dans lequel l’agent cloud stocke sa configuration. Ce paramètre est obligatoire. Le chemin doit pointer vers un chemin de stockage partagé, tel que C:\ClusterStorage\Volume2\ImageStore, ou un partage SMB tel que \\FileShare\ImageStore. L’emplacement doit se trouver sur un partage hautement disponible afin que le stockage soit toujours accessible.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: %systemdrive%\wssdcloudagent
Accept pipeline input: False
Accept wildcard characters: False
-vnet
Nom de l’objet AksHciNetworkSetting créé avec la New-AksHciNetworkSetting commande.
Type: VirtualNetwork
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-createAutoConfigContainers
Vous permet de désactiver la distribution automatique des données de machine virtuelle sur vos volumes partagés de cluster (CSV). Pour désactiver la distribution automatique, utilisez false comme argument pour ce paramètre. Si la distribution automatique est désactivée, seul le csv que vous avez sélectionné est imageDir utilisé. La valeur par défaut est true.
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-offlineDownload
Appelle le téléchargement hors connexion pendant Install-AksHci. Vous devez également exécuter Enable-AksHciOfflineDownload. Cet indicateur est utilisé en tandem avec le -stagingShare paramètre.
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-offsiteTransferCompleted
Définit le déploiement pour utiliser les artefacts téléchargés hors site et transférés vers le serveur de déploiement pendant Install-AksHci. Cet indicateur est utilisé en tandem avec le paramètre et -stagingShare le -offlineDownload paramètre.
-mode
Mode de téléchargement que vous souhaitez utiliser pour le téléchargement hors connexion. Utilisez minimum si vous souhaitez obtenir les images minimales pour le déploiement hybride AKS. Cette option inclut les images Linux requises et uniquement l’image Kubernetes requise. Utilisez full si vous souhaitez que toutes les images pour le déploiement hybride AKS. Cette option inclut toutes les images Linux et Windows et toutes les images Kubernetes prises en charge. Utilisez ce paramètre en tandem avec le -offlineDownload paramètre. Par défaut, il s’agit de full.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: full
Accept pipeline input: False
Accept wildcard characters: False
-stagingShare
Chemin d’accès local à l’emplacement où vous souhaitez que les images soient téléchargées. Utiliser en tandem avec le offlineDownload paramètre.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-nodeConfigLocation
Emplacement dans lequel les agents de nœud stockent leur configuration. Chaque nœud a un agent de nœud. Sa configuration est donc locale à ce nœud. Cet emplacement doit être un chemin d’accès local. Pointe sur %systemdrive%\programdata\wssdagent par défaut pour tous les déploiements.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: %systemdrive%\programdata\wssdagent
Accept pipeline input: False
Accept wildcard characters: False
-controlPlaneVmSize
Taille de la machine virtuelle à créer pour le plan de contrôle. Pour obtenir la liste des tailles de machines virtuelles disponibles, exécutez Get-AksHciVmSize.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Standard_A4_V2
Accept pipeline input: False
Accept wildcard characters: False
-sshPublicKey
Chemin d’accès à un fichier de clé publique SSH. À l’aide de cette clé publique, vous pouvez vous connecter à l’une des machines virtuelles créées par le déploiement hybride AKS. Si vous disposez de votre propre clé publique SSH, passez son emplacement ici. Si aucune clé n’est fournie, nous recherchons une clé sous %systemdrive%\akshci\.ssh\akshci_rsa.pub. Si le fichier n’existe pas, une paire de clés SSH est générée à cet emplacement et utilisée.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolStart
Spécifie le début de l’adresse MAC du pool MAC que vous souhaitez utiliser pour la machine virtuelle hôte Azure Kubernetes Service. La syntaxe de l’adresse MAC nécessite que le bit le moins significatif du premier octet soit toujours 0, et que le premier octet doit toujours être un nombre pair (autrement dit, 00, 02, 04, 06...). Une adresse MAC classique peut ressembler à ceci : 02:1E :2B :78:00:00. Utilisez des pools d’adresses MAC pour les déploiements à long terme afin que les adresses MAC affectées soient cohérentes. Des pools d’adresses MAC sont utiles si les machines virtuelles doivent obligatoirement posséder des adresses MAC spécifiques. Par défaut, il s’agit de None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolEnd
Spécifie la fin de l’adresse MAC du pool MAC que vous souhaitez utiliser pour la machine virtuelle hôte Azure Kubernetes Service. La syntaxe de l’adresse MAC nécessite que le bit le moins significatif du premier octet soit toujours 0, et que le premier octet doit toujours être un nombre pair (autrement dit, 00, 02, 04, 06...). Le premier octet de l’adresse passée comme doit -macPoolEnd être le même que le premier octet de l’adresse passée en tant que -macPoolStart. Utilisez des pools d’adresses MAC pour les déploiements à long terme afin que les adresses MAC affectées soient cohérentes. Des pools d’adresses MAC sont utiles si les machines virtuelles doivent obligatoirement posséder des adresses MAC spécifiques. Par défaut, il s’agit de None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-proxySettings
Objet proxy créé à l’aide de New-AksHciProxySetting.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-cloudServiceCidr
Fournit un préfixe ip/réseau statique à affecter au service CloudAgent MOC. Cette valeur doit être fournie à l’aide du format CIDR ; par exemple, 192.168.1.2/16. Vous pouvez spécifier ce paramètre pour vous assurer que tout élément important sur le réseau est toujours accessible, car l’adresse IP ne change pas. Par défaut, il s’agit de None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-version
Version d’AKS hybride que vous souhaitez déployer. La version la plus récente est utilisée par défaut. Nous vous déconseillons de modifier la valeur par défaut.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Latest version
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentPort
Numéro de port TCP/IP sur lequel les agents de nœud doivent écouter, dont la valeur par défaut est 45000. Nous vous déconseillons de modifier la valeur par défaut.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45000
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentAuthorizerPort
Numéro de port TCP/IP que les agents de nœud doit utiliser pour son port d’autorisation. La valeur par défaut est 45001. Nous vous déconseillons de modifier la valeur par défaut.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45001
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentPort
Numéro de port TCP/IP sur lequel l’agent cloud doit écouter. La valeur par défaut est 55000. Nous vous déconseillons de modifier la valeur par défaut.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 55000
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentAuthorizerPort
Numéro de port TCP/IP que l’agent cloud doit utiliser pour son port d’autorisation. La valeur par défaut est 65000. Nous vous déconseillons de modifier la valeur par défaut.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 65000
Accept pipeline input: False
Accept wildcard characters: False
-clusterRoleName
Spécifie le nom à utiliser lors de la création de l’agent cloud en tant que service générique au sein du cluster. Ce paramètre est défini par défaut sur un nom unique avec un préfixe de ca- et un suffixe GUID. Nous vous déconseillons de modifier la valeur par défaut.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: A unique name with a prefix of ca- and a guid suffix
Accept pipeline input: False
Accept wildcard characters: False
-cloudLocation
Fournit un nom d’emplacement cloud personnalisé géré par Microsoft. Le nom par défaut est MocLocation. Nous vous déconseillons de modifier la valeur par défaut.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: MocLocation
Accept pipeline input: False
Accept wildcard characters: False
-skipHostLimitChecks
Demande au script d’ignorer toutes les vérifications pour vérifier que la mémoire et l’espace disque sont disponibles avant d’autoriser le déploiement à continuer. Ce paramètre n'est pas recommandé.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipRemotingChecks
Demande que le script ignore toutes les vérifications pour confirmer les fonctionnalités de communication à distance aux nœuds locaux et distants. Ce paramètre n'est pas recommandé.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-insecure
Déploie des composants hybrides AKS, tels que des agents cloud et des agents de nœud, en mode non sécurisé (aucune connexion sécurisée TLS). Nous déconseillons d’utiliser le mode non sécurisé dans les environnements de production.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipUpdates
Utilisez cet indicateur si vous souhaitez ignorer les mises à jour disponibles. Ce paramètre n'est pas recommandé.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-forceDnsReplication
La réplication DNS peut prendre jusqu’à une heure sur certains systèmes. Cela entraîne le ralentissement du déploiement. Si vous rencontrez ce problème, vous verrez qu’il Install-AksHci est bloqué dans une boucle. Pour ignorer ce problème, essayez d’utiliser cet indicateur. L’indicateur -forceDnsReplication n’est pas un correctif garanti. Si la logique derrière l’indicateur échoue, l’erreur est masquée et la commande se poursuit comme si l’indicateur n’a pas été fourni.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipValidationChecks
Utilisez cet indicateur si vous souhaitez ignorer les vérifications de validation de l’infrastructure d’environnement et de l’entrée de configuration utilisateur. Ces vérifications mettent en évidence les problèmes potentiels à résoudre avant de poursuivre l’installation. Ce paramètre n'est pas recommandé.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False