Set-AksHciConfig

  • Článek

Synopse

Nastaví nebo aktualizuje nastavení konfigurace pro hostitele Azure Kubernetes Service.

Syntax

Nastavení konfigurace pro hostitele

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]

Popis

Nastaví nastavení konfigurace pro hostitele Azure Kubernetes Service. Pokud nasazujete na cluster Azure Stack HCI se 2 až 4 uzly nebo cluster s podporou převzetí služeb při selhání Windows Serveru 2019 Datacenter, musíte zadat -workingDir parametry a -cloudConfigLocation . Pro Windows Server 2019 Datacenter s jedním uzlem jsou všechny parametry volitelné a nastavené na výchozí hodnoty. Pro optimální výkon ale doporučujeme použít nasazení clusteru Azure Stack HCI se 2 až 4 uzly.

Příklady

Nasazení v clusteru se 2 až 4 uzly se sítí 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"

Nasazení se sítí se statickými IP adresami

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"

Nasazení s proxy serverem

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"

Parametry

-imageDir

Cesta k adresáři, ve kterém hybridní AKS ukládá své image VHD. Tento parametr je povinný. Cesta musí odkazovat na sdílenou cestu úložiště, například C:\ClusterStorage\Volume2\ImageStore, nebo sdílenou složku SMB, například \\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

Pracovní adresář pro modul, který se má použít k ukládání malých souborů. Tento parametr je povinný. Cesta musí odkazovat na sdílenou cestu úložiště, například 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

Umístění, ve kterém cloudový agent ukládá svoji konfiguraci. Tento parametr je povinný. Cesta musí odkazovat na sdílenou cestu úložiště, například C:\ClusterStorage\Volume2\ImageStore, nebo sdílenou složku SMB, například \\FileShare\ImageStore. Umístění musí být ve sdílené složce s vysokou dostupností, aby bylo úložiště vždy přístupné.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: %systemdrive%\wssdcloudagent
Accept pipeline input: False
Accept wildcard characters: False

-vnet

Název objektu AksHciNetworkSetting vytvořeného příkazem New-AksHciNetworkSetting .

Type: VirtualNetwork
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-createAutoConfigContainers

Umožňuje zakázat automatickou distribuci dat virtuálních počítačů na sdílených svazcích clusteru (CSV). Pokud chcete zakázat automatickou distribuci, použijte false jako argument pro tento parametr. Pokud je automatická distribuce zakázaná, použije se jenom sdílený svazek clusteru, pro imageDir který jste vybrali. Výchozí hodnota je true.

Type: System.Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False

-offlineStáhnout

Vyvolá offline stahování během install-AksHci. Musíte také spustit Enable-AksHciOfflineDownload. Tento příznak se používá společně s parametrem -stagingShare .

Type: System.Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-offsiteTransferCompleted

Nastaví nasazení tak, aby používalo artefakty stažené mimo lokalitu a přenášené na server nasazení během install-AksHci. Tento příznak se používá společně s parametrem -offlineDownload a -stagingShare .

-Režimu

Režim stahování, který chcete použít pro offline stahování. Použijte minimum , pokud chcete mít minimální image pro hybridní nasazení AKS. Tato možnost zahrnuje požadované image Linuxu a jenom požadovanou image Kubernetes. Použijte full , pokud chcete všechny image pro hybridní nasazení AKS. Tato možnost zahrnuje všechny image Linuxu a Windows a všechny podporované image Kubernetes. Tento parametr použijte společně s parametrem -offlineDownload . Výchozí formát je full.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: full
Accept pipeline input: False
Accept wildcard characters: False

-stagingShare

Místní cesta, kam chcete obrázky stáhnout. Používejte v kombinaci s parametrem offlineDownload .

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False

-nodeConfigLocation

Umístění, ve kterém agenti uzlu ukládají svoji konfiguraci. Každý uzel má agenta uzlu, takže jeho konfigurace je pro tento uzel místní. Toto umístění musí být místní cesta. Výchozí hodnota je %systemdrive%\programdata\wssdagent pro všechna nasazení.

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

Velikost virtuálního počítače, který se má vytvořit pro řídicí rovinu. Pokud chcete získat seznam dostupných velikostí virtuálních počítačů, spusťte příkaz 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

Cesta k souboru veřejného klíče SSH Pomocí tohoto veřejného klíče se můžete přihlásit k libovolnému virtuálnímu počítači vytvořenému hybridním nasazením AKS. Pokud máte vlastní veřejný klíč SSH, předejte sem jeho umístění. Pokud není k dispozici žádný klíč, vyhledáme ho v části %systemdrive%\akshci\.ssh\akshci_rsa.pub. Pokud soubor neexistuje, vygeneruje se pár klíčů SSH v tomto umístění a použije se.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-macPoolStart

Určuje začátek adresy MAC fondu MAC, který chcete použít pro virtuální počítač hostitele Azure Kubernetes Service. Syntaxe adresy MAC vyžaduje, aby nejméně významný bit prvního bajtu byl vždy 0 a první bajt vždy sudé číslo (to znamená 00, 02, 04, 06...). Typická adresa MAC může vypadat takto: 02:1E:2B:78:00:00. Fondy MAC používejte pro dlouhodobá nasazení, aby přiřazené adresy MAC byly konzistentní. Fondy MAC jsou užitečné, pokud požadujete, aby virtuální počítače měly konkrétní adresy MAC. Výchozí formát je None.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-macPoolEnd

Určuje konec adresy MAC fondu MAC, který chcete použít pro virtuální počítač hostitele Azure Kubernetes Service. Syntaxe adresy MAC vyžaduje, aby nejméně významný bit prvního bajtu byl vždy 0 a první bajt vždy sudé číslo (to znamená 00, 02, 04, 06...). První bajt adresy předané jako -macPoolEnd by měl být stejný jako první bajt adresy předané jako -macPoolStart. Fondy MAC používejte pro dlouhodobá nasazení, aby přiřazené adresy MAC byly konzistentní. Fondy MAC jsou užitečné, pokud požadujete, aby virtuální počítače měly konkrétní adresy MAC. Výchozí formát je None.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-proxySettings

Objekt proxy vytvořené pomocí 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

Poskytuje statickou IP/síťovou předponu, která se má přiřadit ke službě MOC CloudAgent. Tato hodnota by měla být zadaná pomocí formátu CIDR; například 192.168.1.2/16. Tento parametr můžete zadat, abyste zajistili, že vše důležité v síti bude vždy přístupné, protože IP adresa se nezmění. Výchozí formát je None.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Verze

Hybridní verze AKS, kterou chcete nasadit. Výchozí je nejnovější verze. Nedoporučujeme měnit výchozí nastavení.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Latest version
Accept pipeline input: False
Accept wildcard characters: False

-nodeAgentPort

Číslo portu TCP/IP, na kterém by měli agenti uzlu naslouchat, které je ve výchozím nastavení 45000. Nedoporučujeme měnit výchozí nastavení.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 45000
Accept pipeline input: False
Accept wildcard characters: False

-nodeAgentAuthorizerPort

Číslo portu TCP/IP, které by agenti uzlu měli použít pro svůj autorizační port. Výchozí hodnota je 45001. Nedoporučujeme měnit výchozí nastavení.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 45001
Accept pipeline input: False
Accept wildcard characters: False

-cloudAgentPort

Číslo portu TCP/IP, na které by měl cloudový agent naslouchat. Výchozí hodnota je 55000. Nedoporučujeme měnit výchozí nastavení.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 55000
Accept pipeline input: False
Accept wildcard characters: False

-cloudAgentAuthorizerPort

Číslo portu TCP/IP, které by měl cloudový agent použít pro svůj autorizační port. Výchozí hodnota je 65000. Nedoporučujeme měnit výchozí nastavení.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 65000
Accept pipeline input: False
Accept wildcard characters: False

-clusterRoleName

Určuje název, který se má použít při vytváření cloudového agenta jako obecné služby v rámci clusteru. Tento parametr má ve výchozím nastavení jedinečný název s předponou ca- a příponou GUID. Nedoporučujeme měnit výchozí nastavení.

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

Poskytuje vlastní název umístění provozovaného cloudu Microsoftu. Výchozí název je MocLocation. Nedoporučujeme měnit výchozí nastavení.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: MocLocation
Accept pipeline input: False
Accept wildcard characters: False

-skipHostLimitChecks

Před povolením pokračování nasazení skript přeskočí všechny kontroly, aby se ověřilo, že je k dispozici paměť a místo na disku. Toto nastavení nedoporučujeme používat.

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

Požaduje, aby skript přeskočí všechny kontroly a potvrdil možnosti vzdálené komunikace na místních i vzdálených uzlech. Toto nastavení nedoporučujeme používat.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Nejistá

Nasadí hybridní komponenty AKS, jako jsou cloudové agenty a agenty uzlů, v nezabezpečeném režimu (žádná připojení zabezpečená protokolem TLS). V produkčních prostředích nedoporučujeme používat nezabezpečený režim.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-skipUpdates

Tento příznak použijte, pokud chcete přeskočit všechny dostupné aktualizace. Toto nastavení nedoporučujeme používat.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-forceDnsReplication

Replikace DNS může v některých systémech trvat až hodinu. To způsobí, že nasazení bude pomalé. Pokud narazíte na tento problém, uvidíte, že Install-AksHci je zablokovaný ve smyčce. Pokud chcete tento problém vyřešit, zkuste použít tento příznak. Příznak -forceDnsReplication není zaručenou opravou. Pokud logika za příznakem selže, chyba je skrytá a příkaz pokračuje, jako by příznak nebyl zadaný.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-skipValidationChecks

Tento příznak použijte, pokud chcete přeskočit ověřovací kontroly infrastruktury prostředí a vstupu konfigurace uživatele. Tyto kontroly zvýrazňují potenciální problémy, které je třeba vyřešit před pokračováním v instalaci. Toto nastavení nedoporučujeme používat.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Další kroky

Referenční informace k PowerShellu pro AksHci