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

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

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řeskočí se připojení Arc; nicméně 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 ContributorAdministrator .
  • 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 tenanta<tenant-id>: V portálu Azure vyhledejte Microsoft Entra ID, které vás přesměruje na stránku Výchozí adresář. Vyhledejte ID tenanta (GUID).
  • Umístění (oblast Azure):<location>Kde chcete prostředky vytvořit. Podívejte se na Azure Arc podle regionu pro umístění podporovaná službami Azure Arc enabled servers a Azure Arc enabled Kubernetes. 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ří servisního principála aksedge-sp s rolí Přispěvatel omezený na obor skupiny prostředků aksedge-rp. Pokud zástupce služby již existuje, resetuje se jeho heslo. Tento aplikační objekt se používá k připojení k 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.

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 vytvoří 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.

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:

   

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

   

3. Na levém panelu vyberte Jmenné prostory v části Prostředky Kubernetes (náhled):

   

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

   

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

   

6. Teď můžete zobrazit prostředky v clusteru. Workloads ukazují pody spuštěné ve vašem clusteru.

   kubectl get pods --all-namespaces
   

   

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.

Další kroky

• Seznamte se s možnostmi nasazení.
• Nasaďte aplikaci pro Linux.
• Přidat uzel Windows.
• Přehled
• Odinstalace clusteru AKS