Sdílet prostřednictvím


Set-AksHciConfig

Synopse

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

Syntaxe

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 služby Azure Kubernetes Service. Pokud nasazujete do místního clusteru Azure se 2 až 4 uzly nebo clusteru s podporou převzetí služeb při selhání windows Serveru 2019 Datacenter, musíte zadat parametry a -cloudConfigLocation parametry-workingDir. Pro Windows Server 2019 Datacenter s jedním uzlem 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í místního clusteru Azure 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

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:\> $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í úložiště AKS ukládá image VHD. 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

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á svou 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 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

Umožňuje zakázat automatickou distribuci dat virtuálních počítačů na sdílených svazcích clusteru (CSV). Chcete-li zakázat automatické rozdělení, použijte false jako argument pro tento parametr. Pokud je automatická distribuce zakázaná, použije se jenom vybraný sdílený svazek clusteru imageDir . 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 stahování během instalace 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 během instalace AksHci se přenesly na server nasazení. Tento příznak se používá společně s parametrem a -stagingShare parametrem-offlineDownload.

-režim

Režim stahování, který chcete použít ke stažení offline. Použijte minimum , pokud chcete 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í hodnota 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 k místu, kam chcete obrázky stáhnout. Použije se 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 %systemdrive%\programdata\wssdagent je 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. Seznam dostupných velikostí virtuálních počítačů získáte spuštěním Get-AksHciVmSizepříkazu .

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 ho sem. Pokud není k dispozici žádný klíč, vyhledáme ho ve skupině %systemdrive%\akshci\.ssh\akshci_rsa.pub. Pokud soubor neexistuje, v tomto umístění se vygeneruje pár klíčů SSH 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 hostitelský virtuální počítač 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 (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 máte požadavek, aby virtuální počítače měly konkrétní adresy MAC. Výchozí hodnota 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 hostitelský virtuální počítač 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 (to znamená 00, 02, 04, 06...). První bajt adresy předaný jako -macPoolEnd první bajt adresy musí být stejný jako první bajt adresy předané jako -macPoolStartadresa . 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í hodnota 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 adresu nebo předponu 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; Například 192.168.1.2/16. Tento parametr můžete zadat, abyste měli jistotu, že je vše důležité v síti vždy přístupné, protože IP adresa se nezmění. Výchozí hodnota 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í 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 mají agenti uzlu naslouchat, což je ve výchozím nastavení 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 agenti uzlu měli 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é má 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žba v rámci clusteru. Tento parametr má výchozí 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í microsoftu provozovaného cloudu. Výchozí název je MocLocation. Výchozí nastavení nedoporučujeme měnit.

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

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

-skipHostLimitChecks

Vyžaduje, aby skript přeskočí všechny kontroly, aby se ověřilo, že je paměť a místo na disku k dispozici, než povolíte nasazení pokračovat. 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

Vyžaduje, aby skript přeskočí všechny kontroly, které potvrdí možnosti vzdálené komunikace místním i vzdáleným uzlům. 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, například agenta cloudu a agenty 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 dochází, uvidíte, že Install-AksHci je zablokovaný 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 je skrytá a příkaz pokračuje, 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

-skipValidationChecks

Tento příznak použijte, pokud chcete přeskočit kontroly ověření infrastruktury prostředí a vstupu konfigurace uživatele. Tyto kontroly zvýrazňují 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