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 Azure Stack HCI comprenant entre deux et quatre nœuds ou un cluster de basculement Windows Server 2019 Datacenter, vous devez spécifier les paramètres -workingDir et -cloudConfigLocation. Pour un windows Server 2019 Datacenter à 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 de préférer un déploiement de cluster Azure Stack HCI comptant de 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 hybrid 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 que le module doit utiliser pour stocker les 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 -offlineDownload paramètre et -stagingShare .
-Mode
Mode de téléchargement que vous souhaitez utiliser pour le téléchargement hors connexion. Utilisez minimum si vous souhaitez obtenir le minimum d’images pour le déploiement hybride AKS. Cette option inclut les images Linux requises et uniquement l’image Kubernetes requise. Utilisez full si vous souhaitez toutes les images pour le déploiement hybride AKS. Cette option inclut toutes les images Linux et Windows, ainsi que 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 vers l’emplacement où vous souhaitez télécharger les images. Utilisez 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 ayant un agent de nœud, sa configuration est locale pour 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 avez votre propre clé publique SSH, transmettez son emplacement ici. Si aucune clé n’est fournie, nous en recherchons une 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 exige que le bit le moins significatif du premier octet soit toujours 0, et que le premier octet soit toujours un nombre pair (c’est-à-dire, 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 exige que le bit le moins significatif du premier octet soit toujours égal à 0 et que le premier octet soit toujours un nombre pair (c.-à-d., 00, 02, 04, 06...). Le premier octet de l’adresse passé en tant que -macPoolEnd doit être le même que le premier octet de l’adresse passé 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 MOC CloudAgent. 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 ce qui est 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, qui est 45 000 par défaut. 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 que 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 utilise par défaut un nom unique avec un préfixe 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 que le script ignore toutes les vérifications pour confirmer que la mémoire et l’espace disque sont disponibles avant d’autoriser le déploiement à se poursuivre. 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 vers les 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 l’agent cloud et les 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. Le déploiement est donc lent. 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 continue comme si l’indicateur n’était pas 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 de l’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