Poznámka
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Platí pro: Windows Server Datacenter
Tento rychlý start vás provede nastavením hostitele Azure Kubernetes Service (AKS). Clustery Kubernetes vytvoříte na 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 jste předem vytvořili objekty služby clusteru a záznamy DNS, podívejte se na Nasazení hostitele AKS s předem vytvořený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.
Než začnete
- Ujistěte se, že splňujete 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
Na všech uzlech v clusteru s Windows Serverem postupujte takto:
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 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 AksHci PowerShell spuštěním následujícího příkazu na všech uzlech v clusteru 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 najdete v tématu AksHci PowerShell.
Registrujte poskytovatele prostředků k vašemu předplatnému
Před procesem registrace aktivujte příslušného poskytovatele prostředků v Azure pro registraci služby AKS. 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 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. Otevřete PowerShell jako správce a spusťte následující příkaz Initialize-AksHciNode na všech uzlech v clusteru s Windows Serverem:
Initialize-AksHciNode
Krok 2: Vytvoření virtuální sítě
Na libovolném uzlu v 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 přepínač virtuálního počítače SwitchType je nastaven jako 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í, vytvořte proměnnou prostředí pomocí příkazu PowerShell New-AksHciNetworkSetting. 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 v 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 parametry imageDir, workingDir a cloudConfigLocation. 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 uvedené v tomto ukázkovém příkazu musíte přizpůsobit pro vaše prostředí, ale nemůžete změnit název virtuálního počítače na hostiteli nebo v clusteru Kubernetes.
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: Austrálie – východ, USA – východ, Jihovýchodní Asie nebo Západní Evropa.
Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"
Možnost 2: Použití provozního účtu Azure
Pokud nemáte přístup k předplatnému, kde jste vlastníkem, můžete svého hostitele AKS zaregistrovat do Azure pro účely fakturace pomocí aplikačního objektu služby. Další informace o použití instančního objektu najdete v tématu Registrace AKS na Windows Serveru pomocí instančního objektu.
Krok 5: Spuštění nového nasazení
Na libovolném uzlu v 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:
Návod
Pokud chcete zobrazit další podrobnosti o stavu během instalace, nastavte $VerbosePreference = "Continue" před pokračováním.
Install-AksHci
Výstraha
Během instalace hostitele AKS se vytvoří typ prostředku Kubernetes – Azure Arc ve skupině prostředků, která je nastavená během registrace. Nepoužívejte k odstranění tento zdroj, protože představuje vašeho AKS hostitele. 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 fondech uzlů najdete v části Použití fondu uzlů v AKS.
New-AksHciCluster -name mycluster -nodePoolName linuxnodepool -nodeCount 1 -osType Linux
Zkontrolujte nasazené clustery
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
Chcete-li získat seznam poolů uzlů v clustru, spusťte následující příkaz PowerShell Get-AksHciNodePool:
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, další informace najdete v tématu Známé problémy a chyby 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 Windows Serveru 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. Tento příkaz používá soubor kubeconfig zadaného clusteru jako výchozí soubor kubeconfig pro kubectl. K nasazení aplikací pomocí nástroje Helm můžete také použít 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 v Hyper-V Manageru. 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 ve failover clusteru.
Získejte protokoly
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 přistupovat ke clusterům pomocí kubectl.