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

W tym przewodniku Szybki start opisano sposób konfigurowania klastra usługi Azure Kubernetes Service (AKS) Edge Essentials z jedną maszyną K3S z systemem Linux.

Uwaga

Celem tego skryptu szybkiego startu jest ułatwienie procesu oceny. Ten skrypt wymaga poświadczeń wyższego poziomu dla jednorazowej konfiguracji subskrypcji platformy Azure. Nie jest to przeznaczone do użytku produkcyjnego.

Wymagania wstępne

• Zobacz wymagania systemowe. W tym przewodniku Szybki start upewnij się, że masz co najmniej 4,5 GB wolnej pamięci RAM, 4 procesory wirtualne i 20 GB wolnego miejsca na dysku.
• Wymagania dotyczące systemu operacyjnego: zainstaluj system 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 server 2022 (kompilacja systemu operacyjnego 20348). Możesz pobrać wersję systemu 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 pominiesz te parametry, połączenie usługi Arc zostanie pominięte, ale klaster jest nadal wdrożony:
  • Poświadczenia logowania: wymagane do logowania interakcyjnego na platformie Azure przy użyciu interfejsu wiersza polecenia platformy Azure. Twoje konto powinno mieć jedną z tych ról Owner lub Contributor Administrator.
  • Identyfikator subskrypcji<subscription-id>: w witrynie Azure Portal wybierz używaną subskrypcję i poszukaj identyfikatora subskrypcji (GUID).
  • Identyfikator dzierżawy<tenant-id>: w witrynie Azure Portal wyszukaj ciąg Microsoft Entra ID, który powinien zostać wyświetlony na stronie Katalog domyślny. Wyszukaj identyfikator dzierżawy (GUID).
  • Lokalizacja (region świadczenia usługi Azure): <location>Gdzie chcesz utworzyć zasoby. Zobacz Azure Arc by Region , aby uzyskać lokalizacje obsługiwane przez Azure Arc enabled servers usługę i Azure Arc enabled Kubernetes . Wybierz region, w którym są obsługiwane oba te elementy.

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 je 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 witryny 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ółautora 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 plik 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ę, jeśli podano parametry platformy Connect-AideArc 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.

Napiwek

Zawartość json można zmodyfikować $aksedgeConfig w skryscie, AksEdgeQuickStart aby uzyskać dodatkowe opcje. Aby uzyskać dostępne opcje, zobacz Wdrażanie konfiguracji JSON.

Krok 2. Wdrażanie podstawowych elementów 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 aplikację AKS Edge Essentials i łączy klaster z platformą Azure przy użyciu usługi Azure Arc.

Napiwek

Jeśli funkcja Hyper-V nie została włączona na maszynie, 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. Jeśli przejdziesz do grupy zasobów, możesz wyświetlić klaster w witrynie Azure Portal:

   

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

   

4. Aby wyświetlić zasoby platformy Kubernetes, potrzebny jest token elementu nośnego:

   

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

   

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

   kubectl get pods --all-namespaces
   

   

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

Napiwek

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