Set-AksHciConfig

Synopse

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

Syntax

Nastavení konfigurace pro hostitele

Set-AksHciConfig  -imageDir <String>
                  -workingDir <String>
                  -cloudConfigLocation <String>
                  -vnet <Virtual Network>
                 [-createAutoConfigContainers {true, false}]
                 [-offlineDownload]
                 [-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

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 však 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:\> $proxySetting = 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 Azure Kubernetes Service v Azure Stack HCI, bude ukládat image virtuálních pevných disků. Tento parametr je povinný. Cesta musí odkazovat na sdílenou cestu k úložišti, 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

Toto je pracovní adresář modulu, 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 k úložišti, například C:\ClusterStorage\Volume2\ImageStore, nebo na 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

-offlineDownload

Vyvolá offline stažení během Install-AksHci. Musíte také spustit příkaz 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: True
Accept pipeline input: False
Accept wildcard characters: False

-stagingShare

Místní cesta, do které chcete obrázky stáhnout. Tento parametr se používá společně 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_A2_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 budete moct přihlásit k libovolnému virtuálnímu počítači vytvořenému Azure Kubernetes Service v nasazení Azure Stack HCI. Pokud máte vlastní veřejný klíč SSH, předejte jeho umístění sem. Pokud není zadaný žádný klíč, vyhledáme ho v . %systemdrive%\akshci\.ssh\akshci_rsapub. Pokud soubor neexistuje, vygeneruje se a použije se pár klíčů SSH ve výše uvedeném umístění.

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 adres 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 adres MAC používejte pro dlouhodobá nasazení, aby přiřazené adresy MAC byly konzistentní. Fondy adres MAC jsou užitečné, pokud máte požadavek, 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 adres 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 adres MAC používejte pro dlouhodobá nasazení, aby přiřazené adresy MAC byly konzistentní. Fondy adres MAC jsou užitečné, pokud máte požadavek, 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í rutiny 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 přiřadí ke službě MOC CloudAgent. Tato hodnota by měla být poskytnuta pomocí formátu CIDR; například 192.168.1.2/16. Tento parametr můžete zadat, abyste zajistili, že všechno 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

Verze Azure Kubernetes Service v Azure Stack HCI, kterou chcete nasadit. Výchozí hodnota je nejnovější verze. Výchozí nastavení nedoporučujeme měnit.

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, což je výchozí hodnota 45000. Výchozí nastavení nedoporučujeme měnit.

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 měli agenti uzlu použít pro svůj autorizační port. Výchozí hodnota je 45001. Výchozí nastavení nedoporučujeme měnit.

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. Výchozí nastavení nedoporučujeme měnit.

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. Výchozí nastavení nedoporučujeme měnit.

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. Výchozí nastavení nedoporučujeme měnit.

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í Azure Kubernetes Service na komponenty Azure Stack HCI, jako jsou cloudové agenty a agenty uzlů, v nezabezpečeném režimu (bez připojení zabezpečených 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 se zablokuje 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 se skryje a příkaz bude pokračovat, 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ýrazní potenciální problémy, které je potř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