Een Azure Kubernetes Service-host implementeren met vooraf gefaseerde clusterserviceobjecten en DNS-records met behulp van PowerShell
Van toepassing op: AKS op Azure Stack HCI 22H2, AKS op Windows Server
In deze handleiding wordt beschreven hoe u PowerShell gebruikt om uw AKS-hostimplementatie te configureren als u vooraf gefaseerde clusterserviceobjecten en DNS-records in AKS hebt ingeschakeld door Azure Arc.
Voordat u begint
- Zorg ervoor dat u voldoet aan alle vereisten in systeemvereisten.
- Download en installeer de AksHci PowerShell-module.
Stap 1: Uw Active Directory- en DNS-server voorbereiden voor implementatie
Als u dynamische DNS-updates in uw DNS-omgeving niet kunt inschakelen zodat AKS die door Arc is ingeschakeld, de algemene clusternaam van de cloudagent registreert in Active Directory en het DNS-systeem voor detectie, moet u de respectieve records vooraf maken in Active Directory en DNS.
Maak een algemene clusterservice in Active Directory met de naam ca-cloudagent
(of een naam van uw keuze die niet langer is dan 32 tekens). Maak ook een gekoppelde DNS-record die verwijst naar de FQDN van de algemene clusterservice met het opgegeven cloudservicecidr
adres. Zie de documentatie over failoverclustering voor meer informatie over de stappen in dit proces.
De AKS-implementatie probeert de opgegeven clusterRoleName
in Active Directory te vinden voordat u doorgaat met de implementatie.
Notitie
Zodra AKS is geïmplementeerd, kan deze informatie niet meer worden gewijzigd.
Stap 2: Uw machines voorbereiden op implementatie
Voer controles uit op elk fysiek knooppunt om te zien of aan alle vereisten wordt voldaan om AKS Arc te installeren. Open PowerShell als beheerder en voer de volgende opdracht Initialize-AksHciNode uit:
Initialize-AksHciNode
Stap 3: Een virtueel netwerk maken
Als u een virtueel netwerk wilt maken voor de knooppunten in uw implementatie die u wilt gebruiken, maakt u een omgevingsvariabele met de New-AksHciNetworkSetting
PowerShell-opdracht. Deze variabele wordt later gebruikt om een implementatie te configureren die gebruikmaakt van een statisch IP-adres. Als u uw AKS-implementatie wilt configureren met DHCP, raadpleegt u New-AksHciNetworkSetting voor voorbeelden. U kunt ook enkele concepten van netwerkknooppunten bekijken.
# 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"
Notitie
U moet de waarden aanpassen die in deze voorbeeldopdracht voor uw omgeving worden weergegeven.
Stap 4: Uw implementatie configureren met de vooraf voorbereide clusterserviceobjecten en DNS-records
Stel de configuratie-instellingen voor de AKS-host in met behulp van de opdracht Set-AksHciConfig . U moet de workingDir
parameters , cloudServiceCidr
en cloudConfigLocation
clusterRoleName
parameters opgeven. Als u de configuratiegegevens opnieuw wilt instellen, voert u de opdracht opnieuw uit met nieuwe parameters.
Configureer uw implementatie met de volgende opdracht:
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16" -clusterRoleName "ca-cloudagent"
Notitie
Pas de waarden aan die worden weergegeven in deze voorbeeldopdracht voor uw omgeving.
Stap 5: Aanmelden bij Azure en registratie-instellingen configureren
Voer de volgende Set-AksHciRegistration PowerShell-opdracht uit met de naam van uw abonnement en resourcegroep om u aan te melden bij Azure. U moet een Azure-abonnement hebben en een bestaande Azure-resourcegroep in de Azure-regio's VS - oost, Azië - zuidoost of Europa - west om door te gaan:
Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"
Stap 6: Een nieuwe implementatie starten
Nadat u de implementatie hebt geconfigureerd, moet u deze starten. Bij het starten van de implementatie worden de AKS-agents/-services en de AKS-host geïnstalleerd. Voer de volgende opdracht uit om de implementatie te starten:
Install-AksHci
Waarschuwing
Tijdens de installatie van uw AKS-host wordt een Kubernetes- Azure Arc-resourcetype gemaakt in de resourcegroep die tijdens de registratie is ingesteld. Verwijder deze resource niet, omdat deze uw Azure Kubernetes Service-host vertegenwoordigt. U kunt de resource identificeren door het bijbehorende distributieveld voor de aks_management
waarde te controleren. Als u deze resource verwijdert, resulteert dit in een implementatie buiten het beleid.