Wdrażanie hosta usługi Azure Kubernetes Service z wstępnie przygotowanymi obiektami usługi klastra i rekordami DNS przy użyciu programu PowerShell
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 w przypadku wstępnie przygotowanych obiektów usługi klastra i rekordów DNS w usłudze AKS z włączoną usługą Azure Arc.
Zanim rozpoczniesz
- Upewnij się, że spełnisz wszystkie wymagania wstępne w wymaganiach systemowych.
- Pobierz i zainstaluj moduł programu PowerShell usługi AksHci.
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łączonej 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). Ponadto utwórz skojarzony rekord DNS wskazujący nazwę FQDN ogólnej usługi klastra z podanym cloudservicecidr adresem. Aby uzyskać więcej informacji na temat kroków w tym procesie, zobacz dokumentację 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 kontrole 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 do użycia, utwórz zmienną środowiskową za pomocą New-AksHciNetworkSetting polecenia programu PowerShell. Ta zmienna jest używana później 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 wyświetlane 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 za pomocą 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 wyświetlane 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ę do platformy Azure. Aby kontynuować, musisz mieć subskrypcję platformy Azure i istniejącą grupę zasobów platformy Azure w regionach 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 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 jest tworzony typ zasobu Kubernetes — Azure Arc w grupie zasobów ustawionej podczas rejestracji. Nie usuwaj tego zasobu, ponieważ reprezentuje on hosta usługi Azure Kubernetes Service. Zasób można zidentyfikować, sprawdzając jego pole dystrybucji dla aks_management wartości. Usunięcie tego zasobu powoduje wdrożenie poza zasadami.