Az AKS Edge Essentials rövid útmutatója

Ez a gyors kezdési útmutató bemutatja, hogyan lehet beállítani az Azure Kubernetes Service (AKS) Edge Essentials Linux-alapú egygépes csomóponttal rendelkező K3S fürtöt.

Feljegyzés

  • Ez a rövid útmutatószkript megkönnyíti a kiértékelési folyamatot. Magasabb szintű hitelesítő adatokra van szükség az Azure-előfizetés egyszeri beállításához. A szkript nem éles használatra készült.
  • Ez a gyors indítási szkript alapértelmezés szerint engedélyezi a Key Management Service (KMS) beépülő modult (előzetes verzió) az Init.KmsPlugin értékét igazraállítva. További információért lásd: Titkosítás engedélyezése egy AKS Edge Essentials fürtön.

Előfeltételek

  • Tekintse meg a rendszerkövetelményeket. Ebben a rövid útmutatóban győződjön meg arról, hogy legalább 4,5 GB RAM-ra, 4 virtuális processzorra és 20 GB szabad lemezterületre van szüksége.
  • Operációsrendszer-követelmények: telepítse a Windows 10/11 IoT Enterprise/Enterprise/Pro rendszert a gépére, és aktiválja a Windowst. Használja az ügyfél legújabb 22H2-es verzióját (19045-ös operációsrendszer-build) vagy a Server 2022-et (os build: 20348). A Windows 10 egy verzióját itt vagy a Windows 11-et itt töltheti le.
  • Tekintse meg a Microsoft szoftverlicenc-feltételeit , mivel azok a szoftver Ön általi használatára vonatkoznak. A AksEdgeQuickStart szkript használatával elfogadja a Microsoft szoftverlicenc-feltételeit, és a AcceptEULA jelölő true az licencfeltételek elfogadását jelzi.
  • Szerezze be az Azure-előfizetés paramétereit: ha a klasztert az Azure Arc-hoz szeretné csatlakoztatni, meg kell adnia ezeket a paramétereket. Ha kihagyja ezeket a paramétereket, a rendszer kihagyja az Arc-kapcsolatot, de a fürt továbbra is üzembe van helyezve:
    • Bejelentkezési hitelesítő adatai: Az Azure CLI használatával végzett interaktív hitelesítéshez szükséges. A fióknak rendelkeznie kell az alábbi szerepkörök Owneregyikével, Contributorvagy Administrator.
    • Az előfizetés azonosítója<subscription-id>: Az Azure Portalon válassza ki a használt előfizetést, és keresse meg az előfizetés azonosítóját (GUID).
    • Bérlőazonosító<tenant-id>: Az Azure Portalon keresse meg a Microsoft Entra ID-t, amely elnavigálja önt az Alapértelmezett címtár oldalra. Keresse meg a bérlőazonosítót (GUID).
    • Hely (Azure-régió):<location>Ahol az erőforrásokat létre szeretné hozni. Az és Azure Arc enabled servers szolgáltatási helyszíneiről az Azure Arc régiónkénti támogatottságáról az Azure Arc enabled Kubernetes című témakörben olvashat. Válasszon egy régiót, amelyben mindkettő támogatott.

1. lépés: Szkript letöltése az egyszerű üzembe helyezés érdekében

Töltse le a AksEdgeQuickStart.ps1 szkriptet egy működő mappába. A gép házirend-beállításaitól függően előfordulhat, hogy fel kell oldania a fájl letiltását mielőtt futtatja, és a Set-ExecutionPolicy parancsot is végre kell hajtania a szkriptek futtatásának engedélyezéséhez.

Nyisson meg egy emelt szintű PowerShell-ablakot, és módosítsa a könyvtárat munkamappára:

$url = "https://raw.githubusercontent.com/Azure/AKS-Edge/main/tools/scripts/AksEdgeQuickStart/AksEdgeQuickStart.ps1"
Invoke-WebRequest -Uri $url -OutFile .\AksEdgeQuickStart.ps1
Unblock-File .\AksEdgeQuickStart.ps1
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force

Ez a szkript a következő lépéseket automatizálja:

  • A munkamappában a szkript letölti az Azure/AKS-Edge GitHub-archívumát, és kibontja az AKS-Edge-main. Alapértelmezés szerint ez a lépés letölti az aktuális főágat.
  • Az AksEdgeAzureSetup szkripttel megkéri a felhasználót, hogy jelentkezzen be az Azure Portalra az Azure-beli hitelesítő adataikkal, és hajtsa végre a következő feladatokat:
    • Telepíti az Azure CLI-t.
    • Létrehoz egy erőforráscsoportot aksedge-rp.
    • Létrehoz egy egyszerű aksedge-sp szolgáltatást, amelynek közreműködői szerepköre az aksedge-rp erőforráscsoport hatókörére korlátozódik. Ha a szolgáltatásnév már létezik, visszaállítja a jelszavát. Ez a szolgáltatásnév az Azure Archoz való csatlakozásra szolgál.
    • Regisztrálja a Microsoft.HybridCompute, a Microsoft.GuestConfiguration, a Microsoft.HybridConnectivity, a Microsoft.Kubernetes, a Microsoft.KubernetesConfiguration és a Microsoft.ExtendedLocation erőforrás-szolgáltatókat.
  • Meghívja a Start-AideWorkflow következő feladatokat végrehajtó függvényt:
    • Letölti és telepíti az AKS Edge Essentials MSI-t.
    • A gazdagép operációs rendszerének szükséges funkcióit telepíti (Install-AksEdgeHostFeatures). Előfordulhat, hogy a gép újraindul, ha a Hyper-V engedélyezve van, és újra kell indítania a szkriptet.
    • Egyetlen gépfürtöt helyez üzembe belső kapcsolóval (csak Linux-csomópont esetén).
  • Meghívja a függvényt, Connect-AideArc ha az Azure-paraméterek meg vannak adva. Ez a függvény a következő feladatokat hajtja végre:
    • Telepíti az Azure Connected Machine Agentet, és csatlakoztatja a kiszolgáló gépet az Arc for Servershez.
    • Csatlakoztatja az üzembe helyezett fürtöt az Archoz a csatlakoztatott Kuberneteshez.

Tipp.

A $aksedgeConfig szkriptben lévő AksEdgeQuickStart json-tartalmat bármilyen további beállításhoz módosíthatja. A rendelkezésre álló lehetőségekért tekintse meg az üzembehelyezési JSON-konfigurációt.

2. lépés: Az AKS Edge Essentials üzembe helyezése

Egy emelt szintű PowerShell-parancssorban futtassa a AksEdgeQuickStart.ps1 szkriptet. Ez a szkript egy K3s-fürtöt hoz létre:

.\AksEdgeQuickStart.ps1 -SubscriptionId "<subscription-id>" -TenantId "<tenant-id>" -Location "<location>"

A Kubernetes-verzió telepítéséhez adja meg a jelölőt -UseK8s :

.\AksEdgeQuickStart.ps1 -SubscriptionId "<subscription-id>" -TenantId "<tenant-id>" -Location "<location>" -UseK8s

A szkript telepíti az AKS Edge Essentials csomagot, majd az Azure Arc használatával csatlakoztatja a fürtöt az Azure-hoz.

Tipp.

Ha a Hyper-V nincs engedélyezve a számítógépén, a gyorsindítási szkript bekapcsolja a Hyper-V-t és újraindítja a számítógépet. Futtassa újra a AksEdgeQuickStart szkriptet az újraindítás után.

3. lépés: Az üzembe helyezés ellenőrzése

  1. Ellenőrizze, hogy az üzembe helyezés sikeres volt-e a következő futtatásával:

    kubectl get nodes -o wide
    kubectl get pods -A -o wide
    

    Az alábbi képen egy K3S-fürt podjai láthatók:

    Képernyőkép az összes futó podról.

  2. Az Azure portálon megtekintheti a fürtöt, ha az erőforráscsoportjára navigál:

    Képernyőkép a fürtről az Azure Portalon

  3. A bal oldali panelen válassza ki a Névtereket a Kubernetes-erőforrások alatt (előzetes verzió):

    Képernyőkép a Kubernetes-erőforrásokról.

  4. A Kubernetes-erőforrások megtekintéséhez tulajdonosi jogkivonatra van szükség:

    Képernyőkép a tulajdonosi jogkivonat kötelező oldalról.

  5. Futtassa Get-AksEdgeManagedServiceToken a szolgáltatásjogkivonat lekéréséhez:

    Képernyőkép, amely megmutatja az azonosító beillesztésének helyét a portálon.

  6. Most már megtekintheti a klaszter erőforrásait. A számítási feladatok a fürtön futó podokat jelenítik meg.

    kubectl get pods --all-namespaces
    

    Képernyőkép az Arc összes podról.

Most már rendelkezik egy Arc-csatlakoztatott AKS Edge Essentials K3S-fürttel, linuxos csomóponttal. Megismerkedhet egy linuxos mintaalkalmazás üzembe helyezésével ezen a fürtön.

Tipp.

Ha nem adta meg az Azure-előfizetés adatait a AksEdgeQuickStart.ps1 szkript futtatása közben, a cikkben ismertetett lépések végrehajtásával továbbra is csatlakozhat az Azure Archoz.

Következő lépések