Sdílet prostřednictvím

Úvodní příručka pro AKS Edge Essentials

  • Článek

Tento rychlý start popisuje, jak nastavit cluster Azure Kubernetes Service (AKS) Edge Essentials jen pro jeden počítač K3S s Linuxem.

Poznámka:

Účelem tohoto skriptu rychlého startu je usnadnit proces vyhodnocení. Tento skript vyžaduje pro jednorázové nastavení předplatného Azure přihlašovací údaje vyšší úrovně. Toto není určeno pro produkční použití.

Požadavky

  • Podívejte se na požadavky na systém. V tomto rychlém startu se ujistěte, že máte minimálně 4,5 GB paměti RAM zdarma, 4 virtuální procesory a 20 GB volného místa na disku.
  • Požadavky na operační systém: Nainstalujte na počítač Windows 10/11 IoT Enterprise/Enterprise/Pro a aktivujte Windows. Doporučujeme použít nejnovější verzi klienta 22H2 (build operačního systému 19045) nebo Server 2022 (build operačního systému 20348). Verzi Windows 10 si můžete stáhnout zde nebo Windows 11 zde.
  • Podívejte se na licenční podmínky pro software společnosti Microsoft, které platí pro vaše používání softwaru. Pomocí AksEdgeQuickStart skriptu přijímáte licenční podmínky pro software společnosti Microsoft a AcceptEULA příznak je nastavený tak, aby indikuje true přijetí licenčních podmínek.
  • Získejte parametry předplatného Azure: pro připojení clusteru ke službě Azure Arc musíte zadat tyto parametry. Pokud tyto parametry přeskočíte, připojení Arc se přeskočí, ale cluster je stále nasazený:
    • Přihlašovací údaje: Vyžaduje se pro interaktivní přihlášení k Azure pomocí Azure CLI. Váš účet by měl mít jednu z těchto rolí Owner nebo AdministratorContributor .
    • VAŠE ID <subscription-id>předplatného: Na webu Azure Portal vyberte předplatné, které používáte, a vyhledejte ID předplatného (GUID).
    • VAŠE ID <tenant-id> tenanta: Na webu Azure Portal vyhledejte ID Microsoft Entra, které by vás mělo dostat na stránku Výchozí adresář. Vyhledejte ID tenanta (GUID).
    • Umístění (oblast Azure): <location>Kde chcete prostředky vytvořit. Informace o umístěních podporovaných službou Azure Arc enabled servers a Azure Arc enabled Kubernetes službách najdete v azure Arc podle oblastí. Zvolte oblast, ve které jsou obě podporované.

Krok 1: Stažení skriptu pro snadné nasazení

AksEdgeQuickStart.ps1 Stáhněte skript do pracovní složky. V závislosti na nastavení zásad na vašem počítači možná budete muset před spuštěním a spuštěním Set-ExecutionPolicy odblokovat soubor, abyste umožnili spuštění skriptu.

Otevřete okno PowerShellu se zvýšenými oprávněními a změňte adresář na pracovní složku:

$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

Tento skript automatizuje následující kroky:

  • V pracovní složce skript stáhne archiv GitHubu Azure/AKS-Edge a rozbalí se do složky AKS-Edge-main (nebo AKS-Edge-tag><). Ve výchozím nastavení se stáhne aktuální hlavní větev.
  • Pomocí skriptu AksEdgeAzureSetup vyzve uživatele, aby se přihlásil k webu Azure Portal pomocí svých přihlašovacích údajů Azure a provedl následující úlohy:
    • Nainstaluje Azure CLI.
    • Vytvoří skupinu prostředků aksedge-rp.
    • Vytvoří instanční objekt aksedge-sp s rolí Přispěvatel omezený na obor skupiny prostředků aksedge-rp. Pokud instanční objekt již existuje, resetuje jeho heslo. Tento instanční objekt se používá k připojení ke službě Azure Arc.
    • Zaregistruje poskytovatele prostředků Microsoft.HybridCompute, Microsoft.GuestConfiguration, Microsoft.HybridConnectivity, Microsoft.Kubernetes, Microsoft.KubernetesConfiguration a Microsoft.ExtendedLocation.
  • Start-AideWorkflow Vyvolá funkci, která provádí následující úlohy:
    • Stáhne a nainstaluje MSI AKS Edge Essentials.
    • Nainstaluje požadované funkce hostitelského operačního systému (Install-AksEdgeHostFeatures). Počítač se může restartovat, když je technologie Hyper-V povolená, a musíte skript znovu restartovat.
    • Nasadí jeden cluster počítače s interním přepínačem (pouze uzel s Linuxem).
  • Connect-AideArc Vyvolá funkci, pokud jsou zadané parametry Azure. Tato funkce provádí následující úlohy:
    • Nainstaluje agenta Azure Connected Machine a připojí hostitelský počítač k Arc for Servers.
    • Připojí nasazený cluster ke službě Arc pro připojené Kubernetes.

Tip

Obsah JSON ve AksEdgeQuickStart skriptu můžete upravit $aksedgeConfig pro všechny další možnosti. Dostupné možnosti najdete v tématu Konfigurace JSON nasazení.

Krok 2: Nasazení AKS Edge Essentials

Na příkazovém řádku PowerShellu se zvýšenými oprávněními spusťte AksEdgeQuickStart.ps1 skript. Tím se zobrazí cluster K3s:

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

Pro instalaci verze K8s zadejte -UseK8s příznak:

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

Skript nainstaluje AKS Edge Essentials a připojí váš cluster k Azure pomocí Azure Arc.

Tip

Pokud na vašem počítači není povolená technologie Hyper-V, skript pro rychlý start povolí Technologii Hyper-V a restartuje počítač. AksEdgeQuickStart Po restartování spusťte skript znovu.

Krok 3: Ověření nasazení

  1. Spuštěním příkazu potvrďte, že nasazení proběhlo úspěšně:

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

    Následující obrázek znázorňuje pody v clusteru K3S:

    Snímek obrazovky zobrazující všechny spuštěné pody

  2. Cluster můžete zobrazit na webu Azure Portal, pokud přejdete do skupiny prostředků:

    Snímek obrazovky znázorňující cluster na webu Azure Portal

  3. Na levém panelu vyberte obory názvů v části Prostředky Kubernetes (Preview):

    Snímek obrazovky s prostředky Kubernetes

  4. Pokud chcete zobrazit prostředky Kubernetes, potřebujete nosný token:

    Snímek obrazovky znázorňující požadovanou stránku nosný token

  5. Token služby můžete načíst spuštěním Get-AksEdgeManagedServiceToken :

    Snímek obrazovky znázorňující, kam vložit token na portálu

  6. Teď můžete zobrazit prostředky v clusteru. Úlohy zobrazují pody spuštěné v clusteru.

    kubectl get pods --all-namespaces

    Snímek obrazovky zobrazující všechny pody v Arc

Teď máte cluster AKS Edge Essentials K3S připojený k Arc s uzlem Linuxu. Můžete prozkoumat nasazení ukázkové linuxové aplikace v tomto clusteru.

Tip

Pokud jste při spuštění AksEdgeQuickStart.ps1 skriptu nezadali podrobnosti o předplatném Azure, můžete se k Azure Arc připojit pomocí kroků v tomto článku.

Další kroky