Állítson be egy Azure Kubernetes Service gazdagépet az Azure Stack HCI-ben és a Windows Serveren, és helyezzen üzembe egy számítási feladatfürtöt a PowerShell használatával

A következőkre vonatkozik: Azure Stack HCI vagy Windows Server Datacenter

Ez a rövid útmutató végigvezeti egy Azure Kubernetes Service (AKS) gazdagép beállításán. A PowerShell használatával Kubernetes-fürtöket hozhat létre az Azure Stack HCI-n és a Windows Serveren. Ha inkább Windows Admin Center szeretne használni, olvassa el a Beállítás Windows Admin Center című témakört.

Megjegyzés

Előkészületek

  • Győződjön meg arról, hogy teljesítette a rendszerkövetelmények összes előfeltételét.
  • Azure-fiók használatával regisztrálja az AKS-gazdagépet a számlázáshoz. További információ: Azure-követelmények.

Az AksHci PowerShell-modul telepítése

Kövesse az alábbi lépéseket az Azure Stack HCI-fürt vagy a Windows Server-fürt összes csomópontján:

Megjegyzés

Ha távoli PowerShellt használ, a CredSSP-t kell használnia.

  1. Zárja be az összes megnyitott PowerShell-ablakot, nyisson meg egy új PowerShell-munkamenetet rendszergazdaként, és futtassa a következő parancsot az Azure Stack HCI vagy a Windows Server-fürt összes csomópontján:

    Install-PackageProvider -Name NuGet -Force 
    Install-Module -Name PowershellGet -Force -Confirm:$false
    

    A betöltött modulok frissítésének biztosításához ismét be kell zárnia az összes meglévő PowerShell-ablakot. Ne folytassa a következő lépésvel, amíg be nem zárja az összes megnyitott PowerShell-ablakot.

  2. Telepítse az AKS-HCI PowerShell-modult úgy, hogy a következő parancsot futtatja az Azure Stack HCI vagy a Windows Server-fürt összes csomópontján:

    Install-Module -Name AksHci -Repository PSGallery -Force -AcceptLicense
    

    A betöltött modulok frissítésének biztosításához ismét be kell zárnia az összes meglévő PowerShell-ablakot. Ne folytassa a következő lépésvel, amíg be nem zárja az összes megnyitott PowerShell-ablakot.

Egy segédszkripttel törölheti a régi AKS-HCI PowerShell-modulokat, hogy elkerülje a PowerShell-verzióval kapcsolatos problémákat az AKS-telepítésben.

A telepítés ellenőrzése

Get-Command -Module AksHci

Az AksHci PowerShell-parancsok teljes listájának megtekintéséhez lásd: AksHci PowerShell.

Az erőforrás-szolgáltató regisztrálása az előfizetésben

A regisztrációs folyamat előtt engedélyezze a megfelelő erőforrás-szolgáltatót az Azure for AKS-ben az Arc-regisztrációval. Ehhez futtassa a következő PowerShell-parancsokat:

Az Azure-ba való bejelentkezéshez futtassa a Connect-AzAccount PowerShell parancsot:

Connect-AzAccount

Ha másik előfizetésre szeretne váltani, futtassa a Set-AzContext PowerShell parancsot:

Set-AzContext -Subscription "xxxx-xxxx-xxxx-xxxx"

Az alábbi parancsok futtatásával regisztrálhatja Azure-előfizetését az Azure Arc-kompatibilis Kubernetes-erőforrás-szolgáltatókban. Ez a regisztrációs folyamat akár 10 percet is igénybe vehet, de csak egyszer kell végrehajtani egy adott előfizetésben:

Register-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
Register-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Register-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation

A regisztrációs folyamat ellenőrzéséhez futtassa a következő PowerShell-parancsokat:

Get-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
Get-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Get-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation

1. lépés: A gép(ek) előkészítése az üzembe helyezésre

Futtasson ellenőrzéseket minden fizikai csomóponton, és ellenőrizze, hogy az Arc által engedélyezett AKS telepítéséhez szükséges összes követelmény teljesül-e. Nyissa meg a PowerShellt rendszergazdaként, és futtassa a következő Initialize-AksHciNode parancsot az Azure Stack HCI és a Windows Server-fürt összes csomópontján:

Initialize-AksHciNode

2. lépés: Virtuális hálózat létrehozása

Futtassa az alábbi parancsokat az Azure Stack HCI és a Windows Server-fürt bármely csomópontján.

Az elérhető kapcsolók nevének lekéréséhez futtassa az alábbi parancsot. Győződjön meg arról, hogy a SwitchType virtuális gép kapcsolója "Külső":

Get-VMSwitch

Példa a kimenetre:

Name        SwitchType     NetAdapterInterfaceDescription
----        ----------     ------------------------------
extSwitch   External       Mellanox ConnectX-3 Pro Ethernet Adapter

Ha virtuális hálózatot szeretne létrehozni az üzemelő példány csomópontjaihoz, hozzon létre egy környezeti változót a New-AksHciNetworkSetting PowerShell paranccsal. Ez a virtuális hálózat később statikus IP-címet használó üzembe helyezés konfigurálására szolgál. Ha az AKS-telepítést DHCP-vel szeretné konfigurálni, tekintse meg például a New-AksHciNetworkSetting című témakört. Áttekinthet néhány hálózati csomópontfogalmat is.

#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

Megjegyzés

Testre kell szabnia az ebben a példaparancsban látható értékeket a környezetéhez.

3. lépés: Az üzembe helyezés konfigurálása

Futtassa az alábbi parancsokat az Azure Stack HCI és a Windows Server-fürt bármely csomópontján.

Az AKS-gazdagép konfigurációs beállításainak létrehozásához használja a Set-AksHciConfig parancsot. Meg kell adnia a , workingDira és cloudConfigLocation a imageDirparamétert. Ha alaphelyzetbe szeretné állítani a konfiguráció részleteit, futtassa újra a parancsot új paraméterekkel.

Konfigurálja az üzembe helyezést a következő paranccsal:

$csvPath = 'C:\clusterstorage\volume01' # Specify your preferred CSV path
Set-AksHciConfig -imageDir $csvPath\Images -workingDir $csvPath\ImageStore -cloudConfigLocation $csvPath\Config -vnet $vnet

Megjegyzés

Testre kell szabnia az ebben a példaparancsban látható értékeket a környezetéhez.

4. lépés: Jelentkezzen be az Azure-ba, és konfigurálja a regisztrációs beállításokat

1. lehetőség: Használja Microsoft Entra fiókját, ha "Tulajdonos" engedéllyel rendelkezik

Az Azure-ba való bejelentkezéshez futtassa a következő Set-AksHciRegistration PowerShell-parancsot az előfizetéssel és az erőforráscsoport nevével. Rendelkeznie kell egy Azure-előfizetéssel és egy meglévő Azure-erőforráscsoportval Ausztrália keleti régiójában, az USA keleti régiójában, Délkelet-Ázsiában vagy Nyugat-Európa Azure-régióiban:

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

2. lehetőség: Azure-szolgáltatásnév használata

Ha nem rendelkezik hozzáféréssel egy olyan előfizetéshez, amelyen Ön "Tulajdonos", regisztrálhatja az AKS-gazdagépet az Azure-ban számlázás céljából egy szolgáltatásnév használatával. További információ a szolgáltatásnév használatáról: AKS regisztrálása az Azure Stack HCI-ben és a Windows Serveren szolgáltatásnév használatával.

5. lépés: Új üzembe helyezés indítása

Futtassa a következő parancsot az Azure Stack HCI- vagy Windows Server-fürt bármely csomópontján.

Az üzembe helyezés konfigurálása után el kell indítania az AKS-ügynökök/-szolgáltatások és az AKS-gazdagép telepítéséhez. Az üzembe helyezés megkezdéséhez futtassa a következő parancsot:

Tipp

Ha további állapotadatokat szeretne látni a telepítés során, állítsa be a beállítást $VerbosePreference = "Continue" a folytatás előtt.

Install-AksHci

Figyelmeztetés

Az AKS-gazdagép telepítése során létrejön egy Kubernetes – Azure Arc-erőforrástípus a regisztráció során beállított erőforráscsoportban. Ne törölje ezt az erőforrást, mert az az AKS-gazdagépet jelöli. Az erőforrást a terjesztési mező értékének aks_managementellenőrzésével azonosíthatja. Ha törli ezt az erőforrást, az szabályzaton kívüli üzembe helyezést eredményez.

6. lépés: Kubernetes-fürt létrehozása

Az AKS-gazdagép telepítése után üzembe helyezhet egy Kubernetes-fürtöt. Nyissa meg a PowerShellt rendszergazdaként, és futtassa a következő New-AksHciCluster parancsot. Ez a példaparancs létrehoz egy új Kubernetes-fürtöt egy nevű linuxnodepool Linux-csomópontkészlettel, amelynek csomópontszáma 1.

További információ a csomópontkészletekről: Csomópontkészletek használata az AKS-ben.

New-AksHciCluster -name mycluster -nodePoolName linuxnodepool -nodeCount 1 -osType Linux

Az üzembe helyezett fürtök ellenőrzése

Az üzembe helyezett Kubernetes-fürtök listájának lekéréséhez futtassa a következő Get-AksHciCluster PowerShell-parancsot:

Get-AksHciCluster
ProvisioningState     : provisioned
KubernetesVersion     : v1.20.7
NodePools             : linuxnodepool
WindowsNodeCount      : 0
LinuxNodeCount        : 0
ControlPlaneNodeCount : 1
Name                  : mycluster

A fürt csomópontkészleteinek listájának lekéréséhez futtassa a következő Get-AksHciNodePool PowerShell-parancsot:

Get-AksHciNodePool -clusterName mycluster
ClusterName  : mycluster
NodePoolName : linuxnodepool
Version      : v1.20.7
OsType       : Linux
NodeCount    : 1
VmSize       : Standard_K8S3_v1
Phase        : Deployed

7. lépés: A fürt csatlakoztatása az Arc-kompatibilis Kuberneteshez

Csatlakoztassa a fürtöt az Arc-kompatibilis Kuberneteshez az Enable-AksHciArcConnection parancs futtatásával. Az alábbi példa összekapcsolja a Kubernetes-fürtöt az Arctal a parancsban Set-AksHciRegistration megadott előfizetési és erőforráscsoport-adatok használatával:

Connect-AzAccount
Enable-AksHciArcConnection -name mycluster

Megjegyzés

Ha problémákat vagy hibaüzeneteket tapasztal a telepítési folyamat során, további információért tekintse meg a telepítés ismert hibáit és hibáit .

Kubernetes-fürt skálázása

Ha felfelé vagy lefelé szeretné skálázni a fürtöt, a Set-AksHciCluster paranccsal módosíthatja a vezérlősík csomópontjainak számát. A Linux- vagy Windows-munkavégző csomópontok számának módosításához használja a Set-AksHciNodePool parancsot.

A vezérlősík csomópontjainak méretezéséhez futtassa a következő parancsot:

Set-AksHciCluster -name mycluster -controlPlaneNodeCount 3

A csomópontkészletben lévő munkavégző csomópontok skálázásához futtassa a következő parancsot:

Set-AksHciNodePool -clusterName mycluster -name linuxnodepool -count 3

Megjegyzés

Az Azure Stack HCI-n és a Windows Serveren futó AKS korábbi verzióiban a Set-AksHciCluster parancsot is használták a munkavégző csomópontok skálázásához. Most, hogy az AKS csomópontkészleteket vezet be a számítási feladatfürtökben, ezzel a paranccsal csak akkor skálázhatja a munkavégző csomópontokat, ha a fürt a New-AksHciCluster régi paraméterkészletével lett létrehozva.

A munkavégző csomópontok csomópontkészletben való méretezéséhez használja a Set-AksHciNodePool parancsot.

A fürtök elérése a kubectl használatával

A Kubernetes-fürtök kubectl használatával való eléréséhez futtassa a Get-AksHciCredential PowerShell-parancsot. Ez a megadott fürt kubeconfig-fájlját fogja használni a kubectl alapértelmezett kubeconfig fájljaként. A kubectl használatával is üzembe helyezhet alkalmazásokat a Helm használatával:

Get-AksHciCredential -name mycluster

Kubernetes-fürt törlése

Kubernetes-fürt törléséhez futtassa a következő parancsot:

Remove-AksHciCluster -name mycluster

Megjegyzés

Győződjön meg arról, hogy a fürt törölve lett a Hyper-V kezelőjében található meglévő virtuális gépek megtekintésével. Ha nincsenek törölve, manuálisan törölheti a virtuális gépeket. Ezután futtassa a parancsot Restart-Service wssdagent. Futtassa ezt a parancsot a feladatátvevő fürt minden csomópontján.

Naplók lekérése

Ha naplókat szeretne lekérni az összes podról, futtassa a Get-AksHciLogs parancsot. Ez a parancs létrehoz egy nevű kimeneti tömörített mappát akshcilogs.zip a munkakönyvtárban. A mappa teljes elérési útja a akshcilogs.zip kimenet a következő parancs futtatása után:

Get-AksHciLogs

Ebben a rövid útmutatóban megtanulta, hogyan állíthat be AKS-gazdagépet, és hogyan hozhat létre Kubernetes-fürtöket a PowerShell használatával. Azt is megtanulta, hogyan skálázhat egy Kubernetes-fürtöt a PowerShell használatával, és hogyan érheti el a fürtöket a használatával kubectl.

Következő lépések