Delen via

Snelstartgids voor AKS Edge Essentials

In deze snelle startgids wordt beschreven hoe u een Azure Kubernetes Service (AKS) Edge Essentials-cluster instelt met één machine, uitsluitend K3S Linux.

Notitie

  • Het doel van dit quickstartscript is om het evaluatieproces te vereenvoudigen. Voor dit script zijn referenties op een hoger niveau vereist voor een eenmalige installatie van het Azure-abonnement. Het script is niet bedoeld voor productiegebruik.
  • Met dit quickstartscript wordt standaard de KMS-invoegtoepassing (Key Management Service) (preview) ingeschakeld door Init.KmsPlugin in te stellen op true. Zie Geheime versleuteling inschakelen op een AKS Edge Essentials-clustervoor meer informatie.

Vereisten

  • Bekijk de systeemvereisten. Voor deze quickstart moet u ervoor zorgen dat u minimaal 4,5 GB RAM-geheugen hebt, 4 vCPU's en 20 GB vrije schijfruimte.
  • Besturingssysteemvereisten: Installeer Windows 10/11 IoT Enterprise/Enterprise/Pro op uw computer en activeer Windows. U wordt aangeraden de nieuwste clientversie 22H2 (OS build 19045) of Server 2022 (OS build 20348) te gebruiken. U kunt hier of Windows 11 een versie van Windows 10 downloaden.
  • Zie de licentievoorwaarden voor Microsoft-software zoals deze van toepassing zijn op uw gebruik van de software. Door het AksEdgeQuickStart script te gebruiken, accepteert u de licentievoorwaarden voor Microsoft-software en wordt de AcceptEULA vlag ingesteld om de acceptatie van de licentievoorwaarden aan te true geven.
  • Haal uw Azure-abonnementsparameters op: voor het verbinden van uw cluster met Azure Arc moet u deze parameters opgeven. Als u deze parameters overslaat, wordt de Arc-verbinding overgeslagen, maar wordt het cluster nog steeds geïmplementeerd:
    • Uw aanmeldingsreferenties: vereist voor interactieve aanmelding bij Azure met behulp van Azure CLI. Uw account moet een van deze rollen Owner of Contributor of Administrator hebben.
    • Uw abonnements-id<subscription-id>: selecteer in Azure Portal het abonnement dat u gebruikt en zoek de abonnements-id (GUID).
    • Uw <tenant-id>: zoek in Azure Portal naar Microsoft Entra-id, die u naar de pagina Standaardmap moet brengen. Zoek de tenant-ID (GUID).
    • De locatie (Azure-regio):<location>waar u uw resources wilt maken. Zie Azure Arc per regio voor de locaties die worden ondersteund door Azure Arc enabled servers en Azure Arc enabled Kubernetes services. Kies een regio waarin beide worden ondersteund.

Stap 1: Script downloaden voor eenvoudige implementatie

Download het AksEdgeQuickStart.ps1 script naar een werkmap. Afhankelijk van het beleid op je computer moet je het bestand mogelijk deblokkeren voordat je het uitvoert en vervolgens Set-ExecutionPolicy uitvoeren om de uitvoering van het script toe te staan.

Open een PowerShell-venster met verhoogde bevoegdheid en wijzig de map in een werkmap:

$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

Met dit script worden de volgende stappen geautomatiseerd:

  • In de werkmap downloadt het script het GitHub-archief van Azure/AKS-Edge en pakt het uit naar een map AKS-Edge-main (of AKS-Edge-tag<>). Standaard wordt hiermee de huidige hoofdbranch gedownload.
  • Gebruikt het AksEdgeAzureSetup-script om de gebruiker te vragen zich aan te melden bij Azure Portal met behulp van hun Azure-referenties en de volgende taken uit te voeren:
    • Hiermee wordt Azure CLI geïnstalleerd.
    • Hiermee maakt u een resourcegroep aksedge-rp.
    • Hiermee maakt u een service-principal aksedge-sp met de Contributor-rol die beperkt is tot de resourcegroep aksedge-rp. Als de service-principal al bestaat, wordt het wachtwoord opnieuw ingesteld. Deze service-principal wordt gebruikt om verbinding te maken met Azure Arc.
    • Registreert de resourceproviders Microsoft.HybridCompute, Microsoft.GuestConfiguration, Microsoft.HybridConnectivity, Microsoft.Kubernetes, Microsoft.KubernetesConfiguration en Microsoft.ExtendedLocation.
  • Roept de Start-AideWorkflow functie aan waarmee de volgende taken worden uitgevoerd:
    • Downloadt en installeert de AKS Edge Essentials MSI.
    • Installeert vereiste functies voor het hostbesturingssystemen (Install-AksEdgeHostFeatures). De computer kan opnieuw worden opgestart wanneer Hyper-V is ingeschakeld en u moet het script opnieuw opstarten.
    • Hiermee wordt één machinecluster geïmplementeerd met interne switch (alleen Linux-knooppunt).
  • Roept de Connect-AideArc functie aan als de Azure-parameters worden opgegeven. Met deze functie worden de volgende taken uitgevoerd:
    • Hiermee wordt de Azure Connected Machine Agent geïnstalleerd en wordt de hostmachine verbonden met Arc voor Servers.
    • Hiermee wordt het geïmplementeerde cluster aangesloten op Arc voor geïntegreerde Kubernetes-functionaliteit.

Tip

U kunt de json-inhoud $aksedgeConfig in het AksEdgeQuickStart script wijzigen voor eventuele extra opties. Zie JSON-implementatieconfiguratie voor beschikbare opties.

Stap 2: AKS Edge Essentials implementeren

Voer het AksEdgeQuickStart.ps1 script uit in een PowerShell-prompt met verhoogde bevoegdheid. Hiermee wordt een K3s-cluster weergegeven:

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

Geef de vlag op voor het installeren van de -UseK8s K8s-versie:

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

Het script installeert AKS Edge Essentials en verbindt uw cluster met Azure met behulp van Azure Arc.

Tip

Als Hyper-V niet is ingeschakeld op uw computer, schakelt het snelstartscript Hyper-V in en start u uw computer opnieuw op. Voer het AksEdgeQuickStart script opnieuw uit na het opnieuw opstarten.

Stap 3: Implementatie controleren

  1. Controleer of de implementatie is geslaagd door het volgende uit te voeren:

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

    In de volgende afbeelding ziet u pods in een K3S-cluster:

    Schermopname waarop te zien is dat alle pods actief zijn.

  2. U kunt uw cluster bekijken in Azure Portal als u naar uw resourcegroep navigeert:

    Schermopname van het cluster in Azure Portal

  3. Selecteer in de linkerzijbalk de naamruimte onder Kubernetes-bronnen (preview):

    Schermopname van Kubernetes-resources.

  4. Als u uw Kubernetes-resources wilt weergeven, hebt u een Bearer-token nodig:

    Schermopname van de pagina waarop Bearer-token vereist is.

  5. U kunt uitvoeren Get-AksEdgeManagedServiceToken om uw servicetoken op te halen:

    Schermopname die laat zien waar het token in de portal moet worden geplakt.

  6. U kunt nu resources in uw cluster bekijken. De workloads tonen de pods die worden uitgevoerd op uw cluster.

    kubectl get pods --all-namespaces

    Schermopname waarop alle pods in Arc te zien zijn.

U hebt nu een met Arc verbonden AKS Edge Essentials K3S-cluster met een Linux-knooppunt. U kunt het implementeren van een Linux-voorbeeldtoepassing op dit cluster verkennen.

Tip

Als u uw Azure-abonnementsgegevens niet hebt opgegeven tijdens het uitvoeren van het AksEdgeQuickStart.ps1 script, kunt u nog steeds verbinding maken met Azure Arc door de stappen in dit artikel te volgen.

Volgende stappen