Set-AksHciConfig
Streszczenie
Ustawia lub aktualizuje ustawienia konfiguracji hosta usługi 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 usługi Azure Kubernetes Service. Jeśli wdrażasz w klastrze lokalnym platformy Azure 2–4 lub klastrze trybu failover systemu Windows Server 2019 Datacenter, musisz określić -workingDir parametry i -cloudConfigLocation . W przypadku pojedynczego węzła systemu 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 lokalnego platformy Azure z 2–4 węzłem.
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 , lub udział SMB, taki jak C:\ClusterStorage\Volume2\ImageStore\\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 konfigurację. Ten parametr jest wymagany. Ścieżka musi wskazywać udostępnioną ścieżkę magazynu, taką jak , lub udział SMB, taki jak C:\ClusterStorage\Volume2\ImageStore\\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ć automatyczną dystrybucję, użyj false jako argumentu dla tego parametru. Jeśli automatyczna dystrybucja jest wyłączona, używany jest tylko wybrany przez imageDir Ciebie wolumin CSV. Domyślna wartość 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-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ą firmy i przeniesionych na serwer wdrażania podczas instalacji-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 minimum polecenia , 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 full polecenia , jeśli chcesz, aby wszystkie obrazy wdrożeń hybrydowych 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 usługi 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 w przypadku długotrwałych wdrożeń, aby przypisane 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órej chcesz użyć dla maszyny wirtualnej hosta usługi 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 w przypadku długotrwałych wdrożeń, aby przypisane 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 ip/sieć, który ma zostać przypisany do usługi MOC CloudAgent. Ta wartość powinna być 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łów 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ć na potrzeby 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ę, która ma być używana podczas tworzenia agenta w chmurze jako usługi ogólnej w klastrze. Ten parametr domyślnie ma 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 wszelkich kontroli w celu potwierdzenia dostępności pamięci i miejsca na dysku przed zezwoleniem na kontynuowanie wdrażania. 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 z węzłami lokalnymi, jak i zdalnymi. 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
-niepewny
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 trybu niezabezpieczonego 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 wdrażania. Jeśli wystąpi ten problem, zobaczysz, że Install-AksHci jest on zablokowany w pętli. Aby przejść przez ten problem, 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