Set-AksHciConfig

Synopse

Nastavte nebo aktualizujte 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}]
                 [-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]
                 [-insecure]
                 [-skipUpdates]
                 [-forceDnsReplication]   

Description

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

Příklady

Nasazení v clusteru s 2-4 uzly se sítěmi 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 statickými sítěmi IP adres

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í pomocí proxy serveru

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, kde Azure Kubernetes Service ve službě Azure Stack HCI ukládá image virtuálního pevného disku. Tento parametr je povinný. Cesta musí odkazovat na sdílenou cestu k úložišti, jako C:\ClusterStorage\Volume2\ImageStoreje například nebo sdílená složka 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

Jedná se o pracovní adresář pro modul, který se má použít pro ukládání malých souborů. Tento parametr je povinný. Cesta musí odkazovat na sdílenou cestu úložiště, jako je například sdílená složka SMB, například c:\ClusterStorage\Volume2\ImageStore\\FileShare\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í, kam cloudový agent ukládá svou konfiguraci. Tento parametr je povinný. Cesta musí odkazovat na sdílenou cestu k úložišti, jako C:\ClusterStorage\Volume2\ImageStoreje například nebo sdílená složka SMB, například \\FileShare\ImageStore. Umístění musí být ve sdílené složce s vysokou dostupností, aby úložiště bylo 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 pomocí New-AksHciNetworkSetting příkazu.

Type: VirtualNetwork
Parameter Sets: (All)
Aliases:

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

-createAutoConfigContainers

Tento parametr umožňuje zakázat automatickou distribuci dat virtuálního počítače 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 vybraný imageDir sdílený svazek clusteru. 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

-nodeConfigLocation

Umístění, kam agenti uzlu ukládají svoji konfiguraci. Každý uzel má agenta uzlu, takže jeho konfigurace je pro něj 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 Get-AksHciVmSizepříkaz .

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 ke všem virtuálním počítačům vytvořeným Azure Kubernetes Service v nasazení Azure Stack HCI. Pokud máte vlastní veřejný klíč SSH, můžete sem předat jeho umístění. Pokud není k dispozici žádný klíč, vyhledáme ho v souboru %systemdrive%\akshci\.ssh\akshci_rsa.pub. Pokud soubor neexistuje, vygeneruje se a použije 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 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 měl být vždy 0 a první bajt by měl být vždy sudým číslem (tedy 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 máte požadavek, aby virtuální počítače měly konkrétní adresy MAC. Výchozí 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 měl být vždy 0 a první bajt by měl být vždy sudým číslem (tedy 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 máte požadavek, aby virtuální počítače měly konkrétní adresy MAC. Výchozí 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

Dá se použít k poskytnutí předpony statické IP adresy nebo sítě, která se má přiřadit ke službě MOC CloudAgent. Tato hodnota by měla být poskytována pomocí formátu CIDR. (Příklad: 192.168.1.2/16). Můžete ho zadat, abyste měli jistotu, že cokoli důležitého v síti je vždy přístupné, protože IP adresa se nezmění. Výchozí je None.

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

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

-version

Verze Azure Kubernetes Service ve službě Azure Stack HCI, 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 agenti uzlu měli naslouchat, což je výchozí hodnota 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é má 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žba v rámci clusteru. Výchozí hodnota je jedinečný název s předponou ca- a příponou guid (například ca-9e6eb299-bc0b-4f00-9fd7-942843820c26). 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í microsoftu provozovaného cloudu. 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

-concurrentDownloads

Kolik částí segmentuje stahování obsahu pro velké soubory stažené během instalací a upgradů. Ve výchozím nastavení se velké soubory segmentují do 10 souběžných stahování. Tento parametr je funkce preview.

Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 10
Accept pipeline input: False
Accept wildcard characters: False

-skipHostLimitChecks

Před povolením pokračování nasazení vyžaduje, aby skript přeskočí všechny kontroly, které provede, aby potvrdil, ž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žádá skript, aby přeskočí všechny kontroly, které provádí, aby potvrdil možnosti vzdálené komunikace pro místní i vzdálené uzly. 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

-nezabezpečená

Nasadí Azure Kubernetes Service na komponenty Azure Stack HCI, jako jsou cloudoví agenti a agenti uzlů, v nezabezpečeném režimu (bez zabezpečených připojení TLS).  Nedoporučujeme používat nezabezpečený režim v produkčních prostředích.

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 k tomuto problému dojde, uvidíte, že se Install-AksHci zablokuje ve smyčce. Pokud chcete tento problém projít, zkuste použít tento příznak. Příznak -forceDnsReplication není zaručenou opravou. Pokud logika příznaku selže, chyba bude skrytá a příkaz bude pokračovat, jako by příznak nebyl poskytnut.

Type: System.String
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 Prostředí PowerShell AksHci