Set-AksHciConfig

Stručný obsah

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

Syntax

Nastavit konfiguraci pro hostitele

Set-AksHciConfig  -imageDir <String>
                  -workingDir <String>
                  -cloudConfigLocation <String>
                  -vnet <Virtual Network>
                 [-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>]
                 [-skipHostLimitChecks]
                 [-skipRemotingChecks]
                 [-insecure]
                 [-skipUpdates]
                 [-forceDnsReplication]   

Popis

Nastavte nastavení konfigurace pro hostitele služby Azure Kubernetes. pokud nasazujete v uzlu 2-4 Azure Stack clusteru HCI nebo Windows Server 2019 Datacenter pro převzetí služeb při selhání, musíte zadat parametry-workingDir a-cloudConfigLocation. pro jeden uzel Windows Datacenter serveru 2019 jsou všechny parametry volitelné a nastavené na výchozí hodnoty. Pro zajištění optimálního výkonu však doporučujeme použít Azure Stack nasazení clusteru HCI v uzlu 2-4.

Příklady

Nasazení na cluster uzlu 2-4 se sítí DHCP a sítí VLAN

PS C:\> $vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -vlanID 7

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Nasazení na cluster uzlu 2-4 s sítí DHCP bez sítě VLAN

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\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Nasazení s využitím statických IP adres a sítě VLAN

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" -vlanID 7

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Nasazení pomocí sítě se statickými IP adresami bez sítě VLAN

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\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Nasazení pomocí proxy server

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\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -proxySetting $proxySettings -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Nasazení pomocí předem nakonfigurovaného clusteru Cloud agentů a záznamu DNS

Před spuštěním tohoto příkladu musíte připravit obecnou Clusterovou službu ve službě Active Directory s názvem ca-cloudagent (nebo názvem podle vlastního výběru), ale nepřekračuje 32 znaků. Také je třeba vytvořit přidružený záznam DNS ukazující na plně kvalifikovaný název domény obecné clusterové služby se zadanou cloudservicecidr adresou.

Nasazení AKS na Azure Stack HCI se pokusí vyhledat zadanou clusterRoleName v Active Directory, než budete pokračovat v nasazení.

Poznámka

Po nasazení AKS na Azure Stack HCI se tyto informace nedají změnit.

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" -vlanID 7

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16" -clusterRoleName "ca-cloudagent"

Parametry

-imageDir

Cesta k adresáři, do kterého služba Azure Kubernetes v Azure Stack HCL uloží své image VHD. Tento parametr je povinný. Cesta musí ukazovat na cestu ke sdílenému úložišti, například C:\ClusterStorage\Volume2\ImageStore nebo na sdílenou SLOŽKU SMB, jako je 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ář, který modul používá k ukládání malých souborů. Tento parametr je povinný. Cesta musí ukazovat na cestu ke sdílenému úložišti, například c:\ClusterStorage\Volume2\ImageStore nebo na sdílenou SLOŽKU SMB, jako je například \\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í, do kterého bude cloudový agent ukládat svou konfiguraci. Tento parametr je povinný. Cesta musí ukazovat na cestu ke sdílenému úložišti, například C:\ClusterStorage\Volume2\ImageStore nebo na sdílenou SLOŽKU SMB, jako je například \\FileShare\ImageStore . Umístění musí být na vysoce dostupné sdílené složce, aby úložiště bylo vždycky dostupné.

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

Type: VirtualNetwork
Parameter Sets: (All)
Aliases:

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

-nodeConfigLocation

Umístění, kam budou v agentech zaukládána konfigurace. Každý uzel má agenta uzlu, takže jeho konfigurace je místní. Toto umístění musí být místní cesta. Výchozí hodnota %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 plochu ovládacího prvku. 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 ke každému virtuálnímu počítači vytvořenému službou Azure Kubernetes při nasazení Azure Stack HCI. Pokud máte vlastní veřejný klíč SSH, předáte sem jeho umístění. Pokud není zadaný žádný klíč, budeme vyhledáme v %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

Tato možnost slouží k určení začátku adresy MAC pro fond adres MAC, který chcete použít pro virtuální počítač hostitele služby Azure Kubernetes. Syntaxe adresy MAC vyžaduje, aby nejméně významný bit prvního bajtu měl vždy hodnotu 0 a první bajt by měl být vždy sudým číslem (tj. 00, 02, 04, 06...). Typická adresa MAC může vypadat takto: 02:1E: 2B: 78:00:00. Používejte fondy adres MAC pro dlouhodobá nasazení, aby se přiřazené adresy MAC shodovaly. Fondy adres MAC jsou užitečné, pokud požadujete, 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

Tato možnost slouží k určení konce adresy MAC pro fond adres MAC, který chcete použít pro virtuální počítač hostitele služby Azure Kubernetes. Syntaxe adresy MAC vyžaduje, aby nejméně významný bit prvního bajtu měl vždy hodnotu 0 a první bajt by měl být vždy sudým číslem (tj. 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. Používejte fondy adres MAC pro dlouhodobá nasazení, aby se přiřazené adresy MAC shodovaly. Fondy adres MAC jsou užitečné, pokud požadujete, 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 byl 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 zadání předpony statické IP adresy nebo sítě, která se má přiřadit ke službě Course CloudAgent. Tato hodnota by měla být poskytnuta pomocí formátu CIDR. (Příklad: 192.168.1.2/16). Možná budete chtít tuto skutečnost zadat, aby se zajistilo, že všechny důležité informace o síti budou vždycky dostupné, protože se IP adresa nemě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

Verze služby Azure Kubernetes na Azure Stack HCL, kterou chcete nasadit. Výchozí hodnota 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 agenti uzlu naslouchají, 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é agenti uzlu použijí 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ém by měl Cloud 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á Cloud 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 použije při vytváření cloudového agenta jako generické služby v rámci clusteru. Ve výchozím nastavení se jedná o 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

Tento parametr poskytuje vlastní název Microsoft provozovaného cloudového umístění. 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

Požádá skript o přeskočení všech kontrol, které udělá, aby se před povolením pokračování nasazení potvrdilo, ž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 o přeskočení všech kontrol, které udělá, aby 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

-insecure

Nasazovat Azure Kubernetes Service v Azure Stack HCI, jako jsou cloudový agent a agenti 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 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í zpomalení nasazení. Pokud na tento problém nastane, uvidíte, že Install-AksHci zablokované ve smyčce. Pokud se chcete s tímto problémem selhat, 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 kdyby 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 AksHci PowerShellu