Set-AksHciConfig

Streszczenie

Ustawia lub aktualizuje ustawienia konfiguracji hosta Azure Kubernetes Service.

Składnia

Ustawianie konfiguracji hosta

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]   

Opis

Ustawia ustawienia konfiguracji hosta Azure Kubernetes Service. Jeśli wdrażasz w klastrze Azure Stack HCI 2–4 węzła lub w klastrze trybu failover systemu Windows Server 2019 Datacenter, musisz określić -workingDir parametry i -cloudConfigLocation . W przypadku pojedynczego węzła windows Server 2019 Datacenter wszystkie parametry są opcjonalne i ustawione na ich wartości domyślne. Jednak w celu uzyskania optymalnej wydajności zalecamy użycie wdrożenia klastra Azure Stack HCI z 2 do 4 węzłów.

Przykłady

Aby wdrożyć w klastrze 2–4 węzłów z siecią 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"

Aby wdrożyć przy użyciu statycznej sieci 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"

Aby wdrożyć za pomocą serwera proxy

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

Ścieżka do katalogu, w którym hybrydowa usługa AKS przechowuje swoje obrazy wirtualnego dysku twardego. Ten parametr jest wymagany. Ścieżka musi wskazywać udostępnioną ścieżkę magazynu, taką jak C:\ClusterStorage\Volume2\ImageStore, lub udział SMB, taki jak \\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

Katalog roboczy modułu do przechowywania małych plików. Ten parametr jest wymagany. Ścieżka musi wskazywać udostępnioną ścieżkę magazynu, taką jak 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

Lokalizacja, w której agent chmury przechowuje jego konfigurację. Ten parametr jest wymagany. Ścieżka musi wskazywać udostępnioną ścieżkę magazynu, taką jak C:\ClusterStorage\Volume2\ImageStore, lub udział SMB, taki jak \\FileShare\ImageStore. Lokalizacja musi znajdować się w udziale o wysokiej dostępności, aby magazyn był zawsze dostępny.

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

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

-vnet

Nazwa obiektu AksHciNetworkSetting utworzonego za New-AksHciNetworkSetting pomocą polecenia .

Type: VirtualNetwork
Parameter Sets: (All)
Aliases:

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

-createAutoConfigContainers

Umożliwia wyłączenie automatycznej dystrybucji danych maszyny wirtualnej na udostępnionych woluminach klastra (CSV). Aby wyłączyć dystrybucję automatyczną, użyj false jako argumentu dla tego parametru. Jeśli dystrybucja automatyczna jest wyłączona, używany jest tylko wybrany przez imageDir Ciebie plik CSV. Wartość domyślna to true.

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

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

-offlinePobierz

Wywołuje pobieranie w trybie offline podczas instalacji Install-AksHci. Należy również uruchomić polecenie Enable-AksHciOfflineDownload. Ta flaga jest używana razem z 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

Ustawia wdrożenie w celu używania artefaktów pobranych poza siedzibą i przeniesionych na serwer wdrażania podczas instalacji Install-AksHci. Ta flaga jest używana razem z parametrem -offlineDownload i -stagingShare .

-Tryb

Tryb pobierania, którego chcesz użyć do pobierania w trybie offline. Użyj polecenia minimum , aby uzyskać minimalną liczbę obrazów dla wdrożenia hybrydowego usługi AKS. Ta opcja obejmuje wymagane obrazy systemu Linux i tylko wymagany obraz kubernetes. Użyj polecenia full , jeśli chcesz, aby wszystkie obrazy dla wdrożenia hybrydowego usługi AKS. Ta opcja obejmuje wszystkie obrazy systemów Linux i Windows oraz wszystkie obsługiwane obrazy kubernetes. Użyj tego parametru w parze z parametrem -offlineDownload . Wartość domyślna to full.

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

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

-stagingShare

Ścieżka lokalna do miejsca, w którym mają być pobierane obrazy. Użyj w parze z 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

Lokalizacja, w której agenci węzła przechowują konfigurację. Każdy węzeł ma agenta węzła, więc jego konfiguracja jest lokalna dla tego węzła. Ta lokalizacja musi być ścieżką lokalną. Wartość domyślna to %systemdrive%\programdata\wssdagent dla wszystkich wdrożeń.

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

Rozmiar maszyny wirtualnej do utworzenia dla płaszczyzny sterowania. Aby uzyskać listę dostępnych rozmiarów maszyn wirtualnych, uruchom polecenie 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

Ścieżka do pliku klucza publicznego SSH. Za pomocą tego klucza publicznego możesz zalogować się do dowolnej maszyny wirtualnej utworzonej przez wdrożenie hybrydowe usługi AKS. Jeśli masz własny klucz publiczny SSH, przekaż jego lokalizację tutaj. Jeśli nie podano żadnego klucza, szukamy go w obszarze %systemdrive%\akshci\.ssh\akshci_rsa.pub. Jeśli plik nie istnieje, para kluczy SSH jest generowana w tej lokalizacji i używana.

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

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

-macPoolStart

Określa początek adresu MAC puli MAC, której chcesz użyć dla maszyny wirtualnej hosta Azure Kubernetes Service. Składnia adresu MAC wymaga, aby najmniej znaczący bit pierwszego bajtu zawsze wynosił 0, a pierwszy bajt zawsze powinien być liczbą parzystą (czyli 00, 02, 04, 06...). Typowy adres MAC może wyglądać następująco: 02:1E:2B:78:00:00. Używaj pul adresów MAC na potrzeby długotrwałych wdrożeń, aby adresy MAC były spójne. Pule adresów MAC są przydatne, jeśli wymagane jest, aby maszyny wirtualne miały określone adresy MAC. Wartość domyślna to None.

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

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

-macPoolEnd

Określa koniec adresu MAC puli MAC, który ma być używany dla maszyny wirtualnej hosta Azure Kubernetes Service. Składnia adresu MAC wymaga, aby najmniej znaczący bit pierwszego bajtu zawsze wynosił 0, a pierwszy bajt zawsze powinien być liczbą parzystą (czyli 00, 02, 04, 06...). Pierwszy bajt adresu przekazanego jako powinien być taki sam jak -macPoolEnd pierwszy bajt adresu przekazanego -macPoolStartjako . Używaj pul adresów MAC na potrzeby długotrwałych wdrożeń, aby adresy MAC były spójne. Pule adresów MAC są przydatne, jeśli wymagane jest, aby maszyny wirtualne miały określone adresy MAC. Wartość domyślna to None.

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

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

-proxySettings

Obiekt proxy utworzony przy użyciu polecenia 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

Zawiera statyczny prefiks adresu IP/sieci, który ma zostać przypisany do usługi MOC CloudAgent. Ta wartość powinna zostać podana przy użyciu formatu CIDR; na przykład 192.168.1.2/16. Możesz określić ten parametr, aby upewnić się, że wszystkie ważne elementy w sieci są zawsze dostępne, ponieważ adres IP nie zmienia się. Wartość domyślna to None.

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

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

-Wersja

Wersja hybrydowej usługi AKS, którą chcesz wdrożyć. Wartość domyślna to najnowsza wersja. Nie zalecamy zmiany wartości domyślnej.

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

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

-nodeAgentPort

Numer portu TCP/IP, na którym agenci węzła powinni nasłuchiwać, czyli domyślnie 45000. Nie zalecamy zmiany wartości domyślnej.

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

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

-nodeAgentAuthorizerPort

Numer portu TCP/IP, którego agenci węzła powinni używać dla portu autoryzacji. Wartość domyślna to 45001. Nie zalecamy zmiany wartości domyślnej.

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

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

-cloudAgentPort

Numer portu TCP/IP, na który powinien nasłuchiwać agent chmury. Wartość domyślna to 55000. Nie zalecamy zmiany wartości domyślnej.

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

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

-cloudAgentAuthorizerPort

Numer portu TCP/IP, którego agent chmury powinien użyć na potrzeby portu autoryzacji. Wartość domyślna to 65000. Nie zalecamy zmiany wartości domyślnej.

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

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

-clusterRoleName

Określa nazwę używaną podczas tworzenia agenta w chmurze jako usługi ogólnej w klastrze. Ten parametr domyślnie określa unikatową nazwę z prefiksem ca- i sufiksem GUID. Nie zalecamy zmiany wartości domyślnej.

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

Udostępnia niestandardową nazwę lokalizacji chmury obsługiwanej przez firmę Microsoft. Nazwa domyślna to MocLocation. Nie zalecamy zmiany wartości domyślnej.

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

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

-skipHostLimitChecks

Żądania pomijania wszystkich kontroli w celu potwierdzenia, że pamięć i miejsce na dysku są dostępne przed zezwoleniem na kontynuowanie wdrożenia. Nie zalecamy używania tego ustawienia.

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

Żądania pomijania wszystkich kontroli w celu potwierdzenia możliwości komunikacji zdalnej zarówno do węzłów lokalnych, jak i zdalnych. Nie zalecamy używania tego ustawienia.

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

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

-Niebezpieczne

Wdraża składniki hybrydowe usługi AKS, takie jak agent w chmurze i agenty węzłów, w trybie niezabezpieczonym (bez zabezpieczonych połączeń TLS). Nie zalecamy używania niezabezpieczonego trybu w środowiskach produkcyjnych.

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

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

-skipUpdates

Użyj tej flagi, jeśli chcesz pominąć wszystkie dostępne aktualizacje. Nie zalecamy używania tego ustawienia.

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

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

-forceDnsReplication

Replikacja DNS może potrwać do godziny w niektórych systemach. Powoduje to spowolnienie wdrożenia. Jeśli wystąpi ten problem, zobaczysz, że Install-AksHci jest ona zablokowana w pętli. Aby przejść do tego problemu, spróbuj użyć tej flagi. Flaga -forceDnsReplication nie jest gwarantowaną poprawką. Jeśli logika za flagą zakończy się niepowodzeniem, błąd jest ukryty, a polecenie będzie kontynuowane tak, jakby flaga nie została podana.

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

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

-skipValidationChecks

Użyj tej flagi, jeśli chcesz pominąć sprawdzanie poprawności danych wejściowych infrastruktury środowiska i konfiguracji użytkownika. Te testy podkreślają potencjalne problemy, które należy rozwiązać przed kontynuowaniem instalacji. Nie zalecamy używania tego ustawienia.

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

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

Następne kroki

Dokumentacja programu PowerShell usługi AksHci