Wdrażanie hosta Azure Kubernetes Service z wstępnie przygotowanymi obiektami usługi klastra i rekordami DNS przy użyciu programu PowerShell

  • Artykuł

Dotyczy: usługa AKS w usłudze Azure Stack HCI 22H2, AKS w systemie Windows Server

W tym przewodniku z instrukcjami opisano sposób konfigurowania wdrożenia hosta usługi AKS przy użyciu programu PowerShell, jeśli wstępnie przygotowane obiekty usługi klastra i rekordy DNS w usłudze AKS włączone przez usługę Azure Arc.

Zanim rozpoczniesz

Krok 1. Przygotowanie usługi Active Directory i serwera DNS do wdrożenia

Jeśli nie możesz włączyć dynamicznych aktualizacji DNS w środowisku DNS, aby umożliwić usłudze AKS włączone przez usługę Arc rejestrowanie ogólnej nazwy klastra agenta w chmurze w usłudze Active Directory i systemie DNS na potrzeby odnajdywania, należy wstępnie utworzyć odpowiednie rekordy w usłudze Active Directory i DNS.

Utwórz ogólną usługę klastra w usłudze Active Directory o nazwie (lub wybranej nazwie ca-cloudagent , która nie przekracza 32 znaków). Należy również utworzyć skojarzony rekord DNS wskazujący nazwę FQDN ogólnej usługi klastra z podanym cloudservicecidr adresem. Więcej szczegółów na temat kroków tego procesu można znaleźć w dokumentacji klastra trybu failover.

Wdrożenie usługi AKS próbuje zlokalizować określone clusterRoleName w usłudze Active Directory przed kontynuowaniem wdrażania.

Uwaga

Po wdrożeniu usługi AKS nie można zmienić tych informacji.

Krok 2. Przygotowanie maszyn do wdrożenia

Uruchom testy na każdym węźle fizycznym, aby sprawdzić, czy wszystkie wymagania zostały spełnione, aby zainstalować usługę AKS Arc. Otwórz program PowerShell jako administrator i uruchom następujące polecenie Initialize-AksHciNode :

Initialize-AksHciNode

Krok 3. Tworzenie sieci wirtualnej

Aby utworzyć sieć wirtualną dla węzłów we wdrożeniu New-AksHciNetworkSetting do użycia, utwórz zmienną środowiskową za pomocą polecenia programu PowerShell. Ta zmienna jest później używana do konfigurowania wdrożenia korzystającego ze statycznego adresu IP. Jeśli chcesz skonfigurować wdrożenie usługi AKS przy użyciu protokołu DHCP, zobacz New-AksHciNetworkSetting , aby zapoznać się z przykładami. Możesz również zapoznać się z niektórymi pojęciami dotyczącymi węzłów sieciowych.

#static IP
$vnet = New-AksHciNetworkSetting -name mgmt-vnet -vSwitchName "extSwitch" -k8sNodeIpPoolStart "172.16.10.1" -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"

Uwaga

Musisz dostosować wartości podane w tym przykładowym poleceniu dla środowiska.

Krok 4. Konfigurowanie wdrożenia przy użyciu wstępnie przygotowanych obiektów usługi klastra i rekordów DNS

Ustaw ustawienia konfiguracji hosta usługi AKS przy użyciu polecenia Set-AksHciConfig . Należy określić workingDirparametry , cloudServiceCidr, cloudConfigLocationi clusterRoleName . Jeśli chcesz zresetować szczegóły konfiguracji, uruchom ponownie polecenie z nowymi parametrami.

Skonfiguruj wdrożenie przy użyciu następującego polecenia:

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

Uwaga

Dostosuj wartości podane w tym przykładowym poleceniu dla danego środowiska.

Krok 5. Logowanie się do platformy Azure i konfigurowanie ustawień rejestracji

Uruchom następujące polecenie Set-AksHciRegistration programu PowerShell z nazwą subskrypcji i grupy zasobów, aby zalogować się na platformie Azure. Aby kontynuować, musisz mieć subskrypcję platformy Azure i istniejącą grupę zasobów platformy Azure w regionach świadczenia usługi Azure Wschodnie stany USA, Azja Południowo-Wschodnia lub Europa Zachodnia:

Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"

Krok 6. Rozpoczęcie nowego wdrożenia

Po skonfigurowaniu wdrożenia należy go uruchomić. Uruchomienie wdrożenia umożliwia zainstalowanie agentów/usług usługi AKS i hosta usługi AKS. Aby rozpocząć wdrażanie, uruchom następujące polecenie:

Install-AksHci

Ostrzeżenie

Podczas instalacji hosta usługi AKS typ zasobu Usługi Kubernetes — Azure Arc jest tworzony w grupie zasobów ustawionej podczas rejestracji. Nie usuwaj tego zasobu, ponieważ reprezentuje Azure Kubernetes Service hosta. Zasób można zidentyfikować, sprawdzając jego pole dystrybucji pod kątem wartości aks_management. Usunięcie tego zasobu powoduje wdrożenie poza zasadami.

W tym przewodniku z instrukcjami przedstawiono sposób konfigurowania hosta usługi AKS przy użyciu programu PowerShell, jeśli masz wstępnie przygotowane obiekty usługi klastra i rekordy DNS.

Następne kroki