Nastavení hostitele služby Azure Kubernetes Service na místním Azure a Windows Serveru a nasazení clusteru úloh pomocí PowerShellu
Platí pro: Místní Azure nebo Windows Server Datacenter
Tento rychlý start vás provede nastavením hostitele Azure Kubernetes Service (AKS). Clustery Kubernetes vytvoříte na místním Azure a Windows Serveru pomocí PowerShellu. Pokud chcete místo toho použít Centrum pro správu Systému Windows, přečtěte si téma Nastavení v Centru pro správu Systému Windows.
Poznámka:
- Pokud máte předem připravené objekty služby clusteru a záznamy DNS, přečtěte si téma Nasazení hostitele AKS s předzpracovanými objekty služby clusteru a záznamy DNS pomocí PowerShellu.
- Pokud máte proxy server, přečtěte si téma Nastavení hostitele AKS a nasazení clusteru úloh pomocí PowerShellu a proxy serveru.
- Instalace AKS do Azure Local po nastavení virtuálních počítačů Arc se nepodporuje. Další informace najdete v známých problémech s virtuálními počítači Arc. Pokud chcete nainstalovat AKS v Azure Local, musíte odinstalovat most prostředků Arc a pak nainstalovat AKS do Azure Local. Po vyčištění a instalaci AKS můžete znovu nasadit nový most prostředků Arc, ale nepamatuje si entity virtuálních počítačů, které jste vytvořili dříve.
Než začnete
- Ujistěte se, že jste splnili všechny požadavky v požadavcích na systém.
- K registraci hostitele AKS pro fakturaci použijte účet Azure. Další informace najdete v požadavcích Azure.
Instalace modulu PowerShellu AksHci
Postupujte podle těchto kroků na všech uzlech místního clusteru Azure nebo clusteru Windows Serveru:
Poznámka:
Pokud používáte vzdálený PowerShell, musíte použít CredSSP.
Zavřete všechna otevřená okna PowerShellu, otevřete novou relaci PowerShellu jako správce a na všech uzlech v místním prostředí Azure nebo clusteru s Windows Serverem spusťte následující příkaz:
Install-PackageProvider -Name NuGet -Force Install-Module -Name PowershellGet -Force -Confirm:$falseAbyste měli jistotu, že se načtené moduly aktualizují, musíte znovu zavřít všechna existující okna PowerShellu. Nepokračujte k dalšímu kroku, dokud nezavřete všechna otevřená okna PowerShellu.
Nainstalujte modul PowerShellu AKS-HCI spuštěním následujícího příkazu na všech uzlech v místním nebo clusteru Azure s Windows Serverem:
Install-Module -Name AksHci -Repository PSGallery -Force -AcceptLicenseAbyste měli jistotu, že se načtené moduly aktualizují, musíte znovu zavřít všechna existující okna PowerShellu. Nepokračujte k dalšímu kroku, dokud nezavřete všechna otevřená okna PowerShellu.
Pomocí pomocného skriptu můžete odstranit staré moduly PowerShellu AKS-HCI, abyste se vyhnuli problémům souvisejícím s verzí PowerShellu v nasazení AKS.
Ověření instalace
Get-Command -Module AksHci
Úplný seznam příkazů PowerShellu AksHci zobrazíte v tématu AksHci PowerShell.
Registrace poskytovatele prostředků do předplatného
Před registrací povolte příslušného poskytovatele prostředků v Azure pro AKS povolenou registrací služby Arc. Uděláte to tak, že spustíte následující příkazy PowerShellu:
Pokud se chcete přihlásit k Azure, spusťte příkaz PowerShellu Connect-AzAccount :
Connect-AzAccount
Pokud chcete přepnout na jiné předplatné, spusťte příkaz PowerShellu Set-AzContext :
Set-AzContext -Subscription "xxxx-xxxx-xxxx-xxxx"
Spuštěním následujících příkazů zaregistrujte své předplatné Azure pro poskytovatele prostředků Kubernetes s podporou Azure Arc. Tento proces registrace může trvat až 10 minut, ale u konkrétního předplatného ho stačí provést jenom jednou:
Register-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
Register-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Register-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation
Pokud chcete ověřit proces registrace, spusťte následující příkazy PowerShellu:
Get-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
Get-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Get-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation
Krok 1: Příprava počítačů na nasazení
Spusťte kontroly na všech fyzických uzlech a zjistěte, jestli jsou splněné všechny požadavky na instalaci AKS povolené službou Arc. Otevřete PowerShell jako správce a spusťte následující příkaz Initialize-AksHciNode na všech uzlech v místním prostředí Azure a clusteru s Windows Serverem:
Initialize-AksHciNode
Krok 2: Vytvoření virtuální sítě
Na libovolném uzlu místního Azure a clusteru s Windows Serverem spusťte následující příkazy.
Pokud chcete získat názvy dostupných přepínačů, spusťte následující příkaz. Ujistěte se, že SwitchType je přepínač vašeho virtuálního počítače externí:
Get-VMSwitch
Ukázkový výstup:
Name SwitchType NetAdapterInterfaceDescription
---- ---------- ------------------------------
extSwitch External Mellanox ConnectX-3 Pro Ethernet Adapter
Pokud chcete vytvořit virtuální síť pro uzly ve vašem nasazení, která se má použít, vytvořte proměnnou prostředí pomocí příkazu New-AksHciNetworkSetting PowerShellu. Tato virtuální síť se použije později ke konfiguraci nasazení, které používá statickou IP adresu. Pokud chcete nakonfigurovat nasazení AKS pomocí protokolu DHCP, příklady najdete v tématu New-AksHciNetworkSetting . Můžete si také projít některé koncepty síťových uzlů.
#static IP
$vnet = New-AksHciNetworkSetting -name myvnet -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" -vlanId 9
Poznámka:
Hodnoty zobrazené v tomto ukázkovém příkazu je nutné přizpůsobit pro vaše prostředí.
Krok 3: Konfigurace nasazení
Na libovolném uzlu místního Azure a clusteru s Windows Serverem spusťte následující příkazy.
K vytvoření nastavení konfigurace pro hostitele AKS použijte příkaz Set-AksHciConfig . Je nutné zadat parametr imageDir, workingDira cloudConfigLocation parametry. Pokud chcete obnovit podrobnosti o konfiguraci, spusťte příkaz znovu s novými parametry.
Nakonfigurujte nasazení pomocí následujícího příkazu:
$csvPath = 'C:\clusterstorage\volume01' # Specify your preferred CSV path
Set-AksHciConfig -imageDir $csvPath\Images -workingDir $csvPath\ImageStore -cloudConfigLocation $csvPath\Config -vnet $vnet
Poznámka:
Hodnoty zobrazené v tomto ukázkovém příkazu je nutné přizpůsobit pro vaše prostředí.
Krok 4: Přihlášení k Azure a konfigurace nastavení registrace
Možnost 1: Pokud máte oprávnění Vlastník, použijte svůj účet Microsoft Entra.
Spuštěním následujícího příkazu Set-AksHciRegistration PowerShellu s názvem předplatného a skupiny prostředků se přihlaste k Azure. Musíte mít předplatné Azure a existující skupinu prostředků Azure v oblastech Azure – východ, USA – východ, Jihovýchodní Asie nebo Západní Evropa:
Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"
Možnost 2: Použití instančního objektu Azure
Pokud nemáte přístup k předplatnému, na kterém jste vlastníkem, můžete svého hostitele AKS zaregistrovat do Azure k fakturaci pomocí instančního objektu. Další informace o použití instančního objektu najdete v tématu Registrace AKS v Místním prostředí Azure a Windows Serveru pomocí instančního objektu.
Krok 5: Spuštění nového nasazení
Na libovolném uzlu místního Azure nebo clusteru s Windows Serverem spusťte následující příkaz.
Jakmile nakonfigurujete nasazení, musíte ho spustit, abyste mohli nainstalovat agenty a služby AKS a hostitele AKS. Pokud chcete zahájit nasazení, spusťte následující příkaz:
Tip
Pokud chcete zobrazit další podrobnosti o stavu během instalace, nastavte $VerbosePreference = "Continue" před pokračováním.
Install-AksHci
Upozorňující
Během instalace hostitele AKS se vytvoří typ prostředku Kubernetes – Azure Arc ve skupině prostředků, která je nastavená během registrace. Neodstraňovat tento prostředek, protože představuje vašeho hostitele AKS. Zdroj můžete identifikovat tak, že zkontrolujete jeho distribuční pole pro hodnotu aks_management. Pokud tento prostředek odstraníte, dojde k nasazení mimo zásady.
Krok 6: Vytvoření clusteru Kubernetes
Po instalaci hostitele AKS můžete nasadit cluster Kubernetes. Otevřete PowerShell jako správce a spusťte následující příkaz New-AksHciCluster . Tento ukázkový příkaz vytvoří nový cluster Kubernetes s jedním fondem uzlů Linuxu s názvem linuxnodepool počet uzlů 1.
Další informace o fondechuzlůch
New-AksHciCluster -name mycluster -nodePoolName linuxnodepool -nodeCount 1 -osType Linux
Kontrola nasazených clusterů
Pokud chcete získat seznam nasazených clusterů Kubernetes, spusťte následující příkaz Prostředí PowerShell Get-AksHciCluster :
Get-AksHciCluster
ProvisioningState : provisioned
KubernetesVersion : v1.20.7
NodePools : linuxnodepool
WindowsNodeCount : 0
LinuxNodeCount : 0
ControlPlaneNodeCount : 1
Name : mycluster
Pokud chcete získat seznam fondů uzlů v clusteru, spusťte následující příkaz Get-AksHciNodePool PowerShell:
Get-AksHciNodePool -clusterName mycluster
ClusterName : mycluster
NodePoolName : linuxnodepool
Version : v1.20.7
OsType : Linux
NodeCount : 1
VmSize : Standard_K8S3_v1
Phase : Deployed
Krok 7: Připojení clusteru k Kubernetes s podporou Arc
Připojte cluster ke Kubernetes s podporou Arc spuštěním příkazu Enable-AksHciArcConnection . Následující příklad připojí cluster Kubernetes ke službě Arc pomocí podrobností o předplatném a skupině prostředků, které jste předali v Set-AksHciRegistration příkazu:
Connect-AzAccount
Enable-AksHciArcConnection -name mycluster
Poznámka:
Pokud během procesu instalace narazíte na problémy nebo chybové zprávy, přečtěte si další informace o známých problémech a chybách instalace.
Škálování clusteru Kubernetes
Pokud potřebujete vertikálně navýšit nebo snížit kapacitu clusteru, můžete počet uzlů řídicí roviny změnit pomocí příkazu Set-AksHciCluster . Pokud chcete změnit počet linuxových nebo windows pracovních uzlů ve fondu uzlů, použijte příkaz Set-AksHciNodePool .
Pokud chcete škálovat uzly řídicí roviny, spusťte následující příkaz:
Set-AksHciCluster -name mycluster -controlPlaneNodeCount 3
Pokud chcete škálovat pracovní uzly ve fondu uzlů, spusťte následující příkaz:
Set-AksHciNodePool -clusterName mycluster -name linuxnodepool -count 3
Poznámka:
V předchozích verzích AKS na místním a Windows Serveru Azure se k škálování pracovních uzlů použil také příkaz Set-AksHciCluster . Teď, když AKS zavádí fondy uzlů v clusterech úloh, můžete pomocí tohoto příkazu škálovat pracovní uzly pouze v případě, že byl cluster vytvořen se starou sadou parametrů v New-AksHciCluster.
Pokud chcete škálovat pracovní uzly ve fondu uzlů, použijte příkaz Set-AksHciNodePool .
Přístup ke clusterům pomocí kubectl
Pokud chcete získat přístup ke clusterům Kubernetes pomocí kubectl, spusťte příkaz Get-AksHciCredential PowerShell. Použije se soubor kubeconfig zadaného clusteru jako výchozí soubor kubeconfig pro kubectl. K nasazení aplikací pomocí Nástroje Helm můžete použít také kubectl:
Get-AksHciCredential -name mycluster
Odstranění clusteru Kubernetes
Pokud chcete odstranit cluster Kubernetes, spusťte následující příkaz:
Remove-AksHciCluster -name mycluster
Poznámka:
Zkontrolujte, jestli je cluster odstraněný, a to tak, že se podíváte na existující virtuální počítače ve Správci technologie Hyper-V. Pokud se neodstraní, můžete virtuální počítače odstranit ručně. Pak spusťte příkaz Restart-Service wssdagent. Spusťte tento příkaz na každém uzlu v clusteru s podporou převzetí služeb při selhání.
Získání protokolů
Pokud chcete získat protokoly ze všech podů, spusťte příkaz Get-AksHciLogs . Tento příkaz vytvoří výstupní zazipovanou složku volanou akshcilogs.zip v pracovním adresáři. Úplná cesta ke akshcilogs.zip složce je výstupem po spuštění následujícího příkazu:
Get-AksHciLogs
V tomto rychlém startu jste zjistili, jak nastavit hostitele AKS a vytvářet clustery Kubernetes pomocí PowerShellu. Dozvěděli jste se také, jak pomocí PowerShellu škálovat cluster Kubernetes a jak přistupovat ke clusterům pomocí kubectl.