Przewodnik Szybki start dotyczący usługi AKS Edge Essentials

W tym przewodniku Szybki start opisano sposób konfigurowania klastra tylko z systemem Linux Azure Kubernetes Service (AKS) Edge Essentials.

Wymagania wstępne

• Zobacz wymagania systemowe. W tym przewodniku Szybki start upewnij się, że masz co najmniej 4,5 GB wolnego miejsca na dysku, 4 procesory wirtualne i 20 GB wolnego miejsca na dysku.
• Wymagania dotyczące systemu operacyjnego: zainstaluj Windows 10/11 IoT Enterprise/Enterprise/Pro na maszynie i aktywuj system Windows. Zalecamy użycie najnowszej wersji klienta 22H2 (kompilacja systemu operacyjnego 19045) lub serwera 2022 (kompilacja systemu operacyjnego 20348). Możesz pobrać wersję Windows 10 tutaj lub Windows 11 tutaj.
• Zobacz postanowienia licencyjne dotyczące oprogramowania firmy Microsoft , które mają zastosowanie do korzystania z oprogramowania. Korzystając ze skryptu AksEdgeQuickStart , akceptujesz postanowienia licencyjne dotyczące oprogramowania firmy Microsoft, a flaga AcceptEULA jest ustawiona na true wskazanie akceptacji postanowień licencyjnych.
• Pobierz parametry subskrypcji platformy Azure: aby połączyć klaster z usługą Azure Arc, należy podać te parametry. Jeśli pominąsz te parametry, połączenie usługi Arc zostanie pominięte, ale klaster jest nadal wdrażany.
  • Poświadczenia logowania: wymagane do interaktywnego logowania do platformy Azure przy użyciu interfejsu wiersza polecenia platformy Azure. Twoje konto powinno mieć jedną z tych ról Owner lub ContributorAdministrator.
  • Identyfikator subskrypcji<subscription-id>: w Azure Portal wybierz używaną subskrypcję i poszukaj identyfikatora subskrypcji (GUID).
  • Identyfikator dzierżawy<tenant-id>: w Azure Portal wyszukaj Tożsamość Microsoft Entra, co powinno spowodować przejście do strony Katalog domyślny. Wyszukaj identyfikator dzierżawy (GUID).
  • Lokalizacja (region platformy Azure)<location>: miejsce, w którym mają zostać utworzone zasoby. Zobacz Azure Arc by Region , aby zapoznać się z lokalizacjami obsługiwanymi przez Azure Arc enabled servers usługi i Azure Arc enabled Kubernetes . Wybierz region, w którym są obsługiwane oba.

Krok 1. Pobieranie skryptu w celu łatwego wdrożenia

AksEdgeQuickStart.ps1 Pobierz skrypt do folderu roboczego. W zależności od konfiguracji zasad na maszynie może być konieczne odblokowanie pliku przed uruchomieniem i uruchomieniem Set-ExecutionPolicy , aby umożliwić wykonywanie skryptu.

Otwórz okno programu PowerShell z podwyższonym poziomem uprawnień i zmień katalog na folder roboczy:

$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

Ten skrypt automatyzuje następujące kroki:

• W folderze roboczym skrypt pobiera archiwum usługi GitHub azure/AKS-Edge i rozpakowuje do folderu AKS-Edge-main (lub AKS-Edge-tag<>). Domyślnie spowoduje to pobranie bieżącej gałęzi głównej.
• Używa skryptu AksEdgeAzureSetup, aby monitować użytkownika o zalogowanie się do Azure Portal przy użyciu poświadczeń platformy Azure i wykonuje następujące zadania:
  • Instaluje interfejs wiersza polecenia platformy Azure.
  • Tworzy grupę zasobów aksedge-rp.
  • Tworzy jednostkę usługi aksedge-sp z rolą Współautor ograniczoną do zakresu grupy zasobów aksedge-rp . Jeśli jednostka usługi już istnieje, resetuje hasło. Ta jednostka usługi służy do nawiązywania połączenia z usługą Azure Arc.
  • Rejestruje dostawców zasobów Microsoft.HybridCompute, Microsoft.GuestConfiguration, Microsoft.HybridConnectivity, Microsoft.Kubernetes, Microsoft.KubernetesConfiguration i Microsoft.ExtendedLocation.
• Start-AideWorkflow Wywołuje funkcję wykonującą następujące zadania:
  • Pobiera i instaluje msi usługi AKS Edge Essentials.
  • Instaluje wymagane funkcje systemu operacyjnego hosta (Install-AksEdgeHostFeatures). Maszyna może zostać uruchomiona ponownie po włączeniu funkcji Hyper-V i należy ponownie uruchomić skrypt.
  • Wdraża pojedynczy klaster maszyn z przełącznikiem wewnętrznym (tylko węzeł systemu Linux).
• Wywołuje funkcję, Connect-AideArc jeśli podano parametry platformy Azure. Ta funkcja wykonuje następujące zadania:
  • Instaluje agenta połączonej maszyny platformy Azure i łączy maszynę hosta z usługą Arc for Servers.
  • Łączy wdrożony klaster z usługą Arc w celu nawiązania połączenia z platformą Kubernetes.

Krok 2. Wdrażanie podstaw usługi AKS Edge

W wierszu polecenia programu PowerShell z podwyższonym poziomem uprawnień uruchom AksEdgeQuickStart.ps1 skrypt. Spowoduje to wyświetlenie klastra K3s:

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

Aby zainstalować wersję K8s, określ flagę -UseK8s :

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

Skrypt instaluje podstawy usługi AKS Edge i łączy klaster z platformą Azure przy użyciu usługi Azure Arc.

Porada

Jeśli na maszynie nie włączono funkcji Hyper-V, skrypt szybkiego startu włącza funkcję Hyper-V i uruchamia ponownie maszynę. AksEdgeQuickStart Uruchom ponownie skrypt po ponownym uruchomieniu.

Krok 3. Weryfikowanie wdrożenia

1. Upewnij się, że wdrożenie zakończyło się pomyślnie, uruchamiając polecenie:

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

   Na poniższej ilustracji przedstawiono zasobniki w klastrze K3S:

   

2. Klaster można wyświetlić w Azure Portal, jeśli przejdziesz do grupy zasobów:

   

3. Na panelu po lewej stronie wybierz przestrzeń nazw w obszarze Zasoby kubernetes (wersja zapoznawcza):

   

4. Aby wyświetlić zasoby platformy Kubernetes, potrzebujesz tokenu elementu nośnego:

   

5. Możesz uruchomić polecenie Get-AksEdgeManagedServiceToken , aby pobrać token usługi:

   

6. Teraz możesz wyświetlać zasoby w klastrze. W obszarze Obciążenia są wyświetlane zasobniki uruchomione w klastrze.

   kubectl get pods --all-namespaces
   

   

Masz teraz połączony z usługą Arc klaster AKS Edge Essentials K3S z węzłem systemu Linux. Możesz eksplorować wdrażanie przykładowej aplikacji systemu Linux w tym klastrze.

Porada

Jeśli podczas uruchamiania skryptu AksEdgeQuickStart.ps1 nie podano szczegółów subskrypcji platformy Azure, nadal możesz nawiązać połączenie z usługą Azure Arc, wykonując kroki opisane w tym artykule.

Następne kroki

• Omówienie opcji wdrażania.
• Wdrażanie aplikacji systemu Linux.
• Dodaj węzeł systemu Windows.
• Omówienie
• Odinstalowywanie klastra usługi AKS