Tworzenie i aprowizowanie usługi IoT Edge dla systemu Linux na urządzeniach z systemem Windows na dużą skalę przy użyciu kluczy symetrycznych

Jeśli chcesz użyć programu PowerShell, wykonaj następujące kroki, aby przygotować urządzenie docelowe do instalacji usługi Azure IoT Edge dla systemu Linux w systemie Windows i wdrożenia maszyny wirtualnej z systemem Linux:

1. Ustaw zasady wykonywania na urządzeniu docelowym na wartość AllSigned. Bieżące zasady wykonywania można sprawdzić w wierszu polecenia programu PowerShell z podwyższonym poziomem uprawnień przy użyciu następującego polecenia:

   Get-ExecutionPolicy -List
   

   Jeśli polityka wykonywania local machine nie jest AllSigned, można ustawić politykę wykonywania przy użyciu:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

Aby uzyskać więcej informacji na temat modułu Azure IoT Edge dla systemu Linux w programie Windows PowerShell, zobacz dokumentację funkcji programu PowerShell.

Jeśli chcesz użyć centrum administracyjnego systemu Windows, wykonaj następujące kroki, aby pobrać i zainstalować centrum administracyjne systemu Windows oraz zainstalować rozszerzenie Usługi Azure IoT Edge w centrum administracyjnym systemu Windows:

1. Pobierz i uruchom instalator Windows Admin Center. Postępuj zgodnie z monitami kreatora instalacji, aby zainstalować program Windows Admin Center.

2. Po zainstalowaniu użyj obsługiwanej przeglądarki, aby otworzyć Centrum administracyjne systemu Windows. Obsługiwane przeglądarki obejmują przeglądarki Microsoft Edge (Windows 10, wersja 1709 lub nowsza), Google Chrome i Microsoft Edge Insider.

3. Przy pierwszym użyciu centrum administracyjnego systemu Windows zostanie wyświetlony monit o wybranie certyfikatu do użycia. Wybierz klienta Centrum Administracyjnego Windows jako certyfikat.

4. Zainstaluj rozszerzenie usługi Azure IoT Edge. Wybierz ikonę koła zębatego w prawym górnym rogu pulpitu nawigacyjnego Centrum Administracyjnego systemu Windows.

   

5. W menu Ustawienia w obszarze Gatewaywybierz pozycję Extensions.

6. Na karcie Dostępne rozszerzenia znajdź azure IoT Edge na liście rozszerzeń. Wybierz go, a następnie wybierz monit Zainstaluj znajdujący się nad listą rozszerzeń.

7. Po zakończeniu instalacji na karcie Zainstalowane rozszerzenia powinna zostać wyświetlona rozszerzenie Azure IoT Edge.

Utwórz indywidualną rejestrację DPS

1. W witrynie Azure portal przejdź do wystąpienia usługi aprowizacji urządzeń IoT Hub.

2. W obszarze Ustawienia wybierz pozycję Zarządzaj rejestracjami.

3. Wybierz pozycję Dodaj rejestrację indywidualną, a następnie wykonaj następujące kroki, aby skonfigurować rejestrację:

   1. Wybierz Klucz symetryczny w obszarze Mechanizm.

   2. Podaj unikatowy identyfikator rejestracji dla urządzenia.

   3. Opcjonalnie podaj identyfikator urządzenia IoT Hub dla swojego urządzenia. Identyfikatory urządzeń umożliwiają określanie celu poszczególnych urządzeń na potrzeby wdrożenia modułu. Jeśli nie podasz identyfikatora urządzenia, zostanie użyty identyfikator rejestracji.

   4. Wybierz pozycję True , aby zadeklarować, że rejestracja dotyczy urządzenia usługi IoT Edge.

   5. Opcjonalnie dodaj wartość tagu do stanu początkowej bliźniaczej reprezentacji urządzenia. Tagów można używać do grup docelowych urządzeń na potrzeby wdrażania modułu. Przykład:

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   6. Wybierz Zapisz.

4. Skopiuj wartość klucza podstawowego indywidualnej rejestracji do użycia podczas instalowania środowiska uruchomieniowego IoT Edge.

Teraz, gdy rejestracja istnieje dla tego urządzenia, środowisko uruchomieniowe usługi IoT Edge może automatycznie aprowizować urządzenie podczas instalacji.

Utwórz rejestrację grupy DPS

1. W witrynie Azure portal przejdź do wystąpienia usługi aprowizacji urządzeń IoT Hub.

2. W obszarze Ustawienia wybierz pozycję Zarządzaj rejestracjami.

3. Wybierz pozycję Dodaj rejestrację indywidualną, a następnie wykonaj następujące kroki, aby skonfigurować rejestrację:

   1. Podaj nazwę grupy.

   2. Wybierz Klucz symetryczny jako rodzaj uwierzytelniania.

   3. Wybierz pozycję True , aby zadeklarować, że rejestracja dotyczy urządzenia usługi IoT Edge. W przypadku rejestracji grupowej wszystkie urządzenia muszą być urządzeniami IoT Edge lub żadne z nich nie może być.

   4. Opcjonalnie, dodaj wartość tagu do początkowego stanu bliźniaczego urządzenia. Tagów można używać do grup docelowych urządzeń na potrzeby wdrażania modułu. Przykład:

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   5. Wybierz Zapisz.

4. Skopiuj wartość Klucz podstawowy swojej grupy rejestracji, aby użyć jej podczas tworzenia kluczy urządzenia dla rejestracji grupowej.

Teraz, gdy istnieje grupa rejestracji, środowisko uruchomieniowe usługi IoT Edge może automatycznie aprowizować urządzenia podczas instalacji.

Uzyskiwanie klucza urządzenia

Każde urządzenie konfigurowane w ramach grupowego enrolmentu wymaga pochodnego klucza urządzenia do przeprowadzenia symetrycznej autentykacji klucza w trakcie procesu rejestracji podczas przydzielania.

Aby wygenerować klucz urządzenia, użyj klucza skopiowanego z grupy rejestracji usługi DPS, aby obliczyć HMAC-SHA256 unikatowego identyfikatora rejestracji urządzenia i przekonwertować wynik na format Base64.

W systemie Windows możesz użyć programu PowerShell do wygenerowania pochodnego klucza urządzenia, jak pokazano w poniższym przykładzie.

Zastąp wartość KLUCZ wartością klucza zasadniczego, którą zanotowałeś wcześniej.

Zastąp wartość REG_ID identyfikatorem rejestracji urządzenia.

$KEY='PASTE_YOUR_ENROLLMENT_KEY_HERE'
$REG_ID='PASTE_YOUR_REGISTRATION_ID_HERE'

$hmacsha256 = New-Object System.Security.Cryptography.HMACSHA256
$hmacsha256.key = [Convert]::FromBase64String($KEY)
$sig = $hmacsha256.ComputeHash([Text.Encoding]::ASCII.GetBytes($REG_ID))
$derivedkey = [Convert]::ToBase64String($sig)
echo "`n$derivedkey`n"

Poniżej przedstawiono przykładowe dane wyjściowe klucza pochodnego urządzenia:

Jsm0lyGpjaVYVP2g3FnmnmG9dI/9qU24wNoykUmermc=

Zainstaluj usługę IoT Edge dla systemu Linux w systemie Windows na urządzeniu docelowym.

1. W sesji programu PowerShell z podwyższonym poziomem uprawnień uruchom każde z poniższych poleceń, aby pobrać usługę IoT Edge dla systemu Linux w systemie Windows.

   $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
   $ProgressPreference = 'SilentlyContinue'
   Invoke-WebRequest "https://aka.ms/AzEflowMSI" -OutFile $msiPath
   

2. Zainstaluj usługę IoT Edge dla systemu Linux w systemie Windows na urządzeniu.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"
   

   Można określić niestandardowe katalogi instalacji IoT Edge dla systemu Linux w systemie Windows oraz katalogi VHDX, dodając parametry INSTALLDIR="<FULLY_QUALIFIED_PATH>" i VHDXDIR="<FULLY_QUALIFIED_PATH>" do polecenia instalacyjnego. Jeśli na przykład chcesz użyć folderu D:\EFLOW do instalacji i D:\EFLOW-VHDX dla dysku VHDX, możesz użyć następującego polecenia cmdlet programu PowerShell.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn","INSTALLDIR=D:\EFLOW", "VHDXDIR=D:\EFLOW-VHDX"
   

3. Ustaw zasady wykonywania na urządzeniu docelowym na AllSigned, jeśli jeszcze nie są. Zobacz wymagania programu PowerShell dotyczące poleceń, które pozwolą sprawdzić bieżące zasady wykonywania i ustawić je na AllSigned.

4. Utwórz usługę IoT Edge dla systemu Linux we wdrożeniu systemu Windows. Wdrożenie tworzy maszynę wirtualną z systemem Linux i instaluje środowisko uruchomieniowe usługi IoT Edge.

   Deploy-Eflow
   

   Wskazówka

   Domyślnie polecenie Deploy-Eflow tworzy maszynę wirtualną z systemem Linux z 1 GB pamięci RAM, 1 rdzeniem vCPU i 16 GB miejsca na dysku. Jednak zasoby wymagane przez maszynę wirtualną są bardzo zależne od wdrożonych obciążeń. Jeśli maszyna wirtualna nie ma wystarczającej ilości pamięci do obsługi obciążeń, uruchomienie nie powiedzie się.

   Dostępne zasoby maszyny wirtualnej można dostosować przy użyciu Deploy-Eflow opcjonalnych parametrów polecenia.

   Na przykład poniższe polecenie tworzy maszynę wirtualną z 4 rdzeniami procesorów wirtualnych, 4 GB pamięci RAM (reprezentowanymi w MB) i 20 GB miejsca na dysku:

   Deploy-Eflow -cpuCount 4 -memoryInMB 4096 -vmDiskSize 20
   

   Aby uzyskać informacje o wszystkich dostępnych parametrach opcjonalnych, zobacz Funkcje programu PowerShell dla usługi IoT Edge dla systemu Linux w systemie Windows.

   Ostrzeżenie

   Domyślnie maszyna wirtualna EFLOW z systemem Linux nie ma konfiguracji DNS. Wdrożenia korzystające z protokołu DHCP spróbują uzyskać konfigurację DNS propagowaną przez serwer DHCP. Sprawdź konfigurację DNS, aby upewnić się, że masz połączenie z Internetem. Aby uzyskać więcej informacji, zobacz AzEFLOW-DNS.

   Można przypisać GPU do wdrożenia, aby umożliwić działanie modułów Linux z przyspieszeniem GPU. Aby uzyskać dostęp do tych funkcji, należy zainstalować wymagania wstępne opisane w artykule przyspieszanie procesora GPU dla usługi Azure IoT Edge dla systemu Linux w systemie Windows.

   Aby użyć passthrough GPU, dodaj parametr gpuName, gpuPassthroughType i gpuCount do polecenia Deploy-Eflow. Aby uzyskać informacje o wszystkich dostępnych parametrach opcjonalnych, zobacz Funkcje programu PowerShell dla usługi IoT Edge dla systemu Linux w systemie Windows.

   Ostrzeżenie

   Włączenie przekazywania urządzeń sprzętowych może zwiększyć ryzyko dla bezpieczeństwa. Firma Microsoft zaleca sterownik ograniczania ryzyka urządzenia od dostawcy procesora GPU, jeśli ma to zastosowanie. Aby uzyskać więcej informacji, zobacz Wdrażanie urządzeń graficznych przy użyciu dyskretnego przypisania urządzenia.

5. Wprowadź wartość "Y", aby zaakceptować postanowienia licencyjne.

6. W zależności od preferencji wprowadź wartość "O" lub "R", aby włączyć lub wyłączyć opcjonalne dane diagnostyczne.

7. Po zakończeniu wdrażania okno programu PowerShell zgłasza wdrożenie zakończone pomyślnie.

   

   Po pomyślnym wdrożeniu możesz przystąpić do aprowizowania urządzenia.

1. Zainstaluj i otwórz Centrum administracyjne systemu Windows.

   Na stronie startowej Windows Admin Center, na liście połączeń, zostanie wyświetlone połączenie localhost reprezentujące komputer, na którym uruchomiony jest Windows Admin Center. Wszystkie dodatkowe serwery, komputery lub klastry, którymi zarządzasz, zostaną również wyświetlone tutaj.

   Centrum administracyjne systemu Windows umożliwia zarządzanie usługą Azure IoT Edge dla systemu Linux w systemie Windows na urządzeniu lokalnym lub na zdalnych urządzeniach zarządzanych. W tym przewodniku połączenie hosta lokalnego będzie służyć jako urządzenie docelowe do wdrożenia usługi Azure IoT Edge dla systemu Linux w systemie Windows.

2. Upewnij się, że urządzenie lokalne znajduje się na liście Wszystkie połączenia, jak pokazano poniżej.

   

   Jeśli chcesz wdrożyć na zdalnym urządzeniu docelowym zamiast urządzenia lokalnego i nie widzisz żądanego urządzenia docelowego na liście, postępuj zgodnie z instrukcjami , aby dodać urządzenie.

3. Wybierz pozycję + Dodaj, aby rozpocząć tworzenie wdrożenia. Wdrożenie tworzy maszynę wirtualną z systemem Linux i instaluje środowisko uruchomieniowe usługi IoT Edge.

4. W panelu Dodawanie lub tworzenie zasobów znajdź kafelek Azure IoT Edge. Wybierz pozycję Utwórz nowe, aby zainstalować nowe wystąpienie usługi Azure IoT Edge dla systemu Linux na Windows na urządzeniu.

   Jeśli masz już usługę IoT Edge dla systemu Linux w systemie Windows uruchomioną na urządzeniu, możesz wybrać pozycję Dodaj, aby nawiązać połączenie z istniejącym urządzeniem usługi IoT Edge i zarządzać nim za pomocą Centrum administracyjnego systemu Windows.

   

5. Zostanie otwarte okienko Create an Azure IoT Edge for Linux on Windows deployment (Tworzenie usługi Azure IoT Edge dla systemu Linux w systemie Windows). ** Na 1. karcie Wstęp przejrzyj minimalne wymagania i kliknij Dalej.

6. Przejrzyj warunki licencji, zaznacz Akceptujęi wybierz Dalej.

7. Możesz włączać lub wyłączać opcjonalne dane diagnostyczne, zależnie od swoich preferencji.

8. Wybierz pozycję Dalej: Wdróż.

   

9. Na 2. Wdróż zakładkę w obszarze Wybierz urządzenie docelowe kliknij na liście swoje urządzenie, aby upewnić się, że spełnia minimalne wymagania. Po potwierdzeniu stanu jako obsługiwanego wybierz pozycję Dalej.

   

10. Na karcie 2.2 Ustawienia przejrzyj ustawienia konfiguracji wdrożenia. W poniższej tabeli przedstawiono ustawienia i ich wartości domyślne.

    Ustawienia	Wartość domyślna
    Rozmiar dysku wirtualnego w GB	16
    Pamięć w mb (liczba parzysta)	1024
    Liczba rdzeni	2
    Wersja usługi Azure IoT Edge	1.1 (LTS)

    Uwaga / Notatka

    Usługa IoT Edge dla systemu Linux w systemie Windows używa przełącznika domyślnego, który przypisuje maszynie wirtualnej z systemem Linux wewnętrzny adres IP. Nie można uzyskać dostępu do tego wewnętrznego adresu IP spoza komputera z systemem Windows. Możesz nawiązać połączenie z maszyną wirtualną lokalnie po zalogowaniu się na maszynie z systemem Windows.

    Jeśli używasz systemu Windows Server, przed wdrożeniem IoT Edge dla systemu Linux w Windows skonfiguruj przełącznik domyślny .

    Można przypisać GPU do wdrożenia, aby umożliwić działanie modułów Linux z przyspieszeniem GPU. Aby uzyskać dostęp do tych funkcji, należy zainstalować wymagania wstępne opisane w artykule przyspieszanie procesora GPU dla usługi Azure IoT Edge dla systemu Linux w systemie Windows. Jeśli w tym momencie instalujesz tylko te wymagania wstępne w procesie wdrażania, musisz zacząć ponownie od początku.

    Dostępne są dwie opcje przekazywania GPU: bezpośrednie przypisanie urządzeń (DDA) i parawirtualizacja GPU (GPU-PV), w zależności od przypisanego do wdrożenia adaptera GPU.

    W przypadku metody przypisania bezpośredniego urządzenia wybierz liczbę procesorów GPU do przydzielenia do maszyny wirtualnej z systemem Linux.

    W przypadku metody parawirtualizacji nie są potrzebne żadne dodatkowe ustawienia.

    Ostrzeżenie

    Włączenie przekazywania urządzeń sprzętowych może zwiększyć ryzyko dla bezpieczeństwa. Firma Microsoft zaleca sterownik ograniczania ryzyka urządzenia od dostawcy procesora GPU, jeśli ma to zastosowanie. Aby uzyskać więcej informacji, zobacz Wdrażanie urządzeń graficznych przy użyciu dyskretnego przypisania urządzenia.

    Gdy ustawienia będą zadowalające, wybierz pozycję Dalej.

11. Na karcie wdrażania 2.3 możesz obserwować postęp wdrażania. Pełny proces obejmuje pobieranie pakietu usługi Azure IoT Edge dla systemu Linux w systemie Windows, instalowanie pakietu, konfigurowanie urządzenia hosta i konfigurowanie maszyny wirtualnej z systemem Linux. Ukończenie tego procesu może potrwać kilka minut. Pomyślne wdrożenie zostało pokazane poniżej.

    

12. Po zakończeniu wdrażania możesz przystąpić do aprowizowania urządzenia. Wybierz pozycję Dalej: Połącz, aby przejść do 3. Połącz kartę, która obsługuje aprowizowanie urządzeń usługi Azure IoT Edge.

W przypadku programu PowerShell uruchom następujące polecenie, zastępując wartości zastępcze swoimi własnymi:

Provision-EflowVm -provisioningType DpsSymmetricKey -​scopeId PASTE_YOUR_ID_SCOPE_HERE -registrationId PASTE_YOUR_REGISTRATION_ID_HERE -symmKey PASTE_YOUR_PRIMARY_KEY_OR_DERIVED_KEY_HERE

W centrum administracyjnym systemu Windows wykonaj następujące czynności:

1. W okienku aprowizacji urządzeń usługi Azure IoT Edge wybierz pozycję Klucz symetryczny (DPS) z listy rozwijanej Metoda aprowizacji.

2. W portalu Azure przejdź do instancji DPS.

3. Podaj identyfikator zakresu usługi DPS, identyfikator rejestracji urządzenia i klucz podstawowy rejestracji lub klucz pochodny w polach Centrum administracyjnego systemu Windows.

4. Wybierz Provisionowanie za pomocą wybranej metody.

   

5. Po zakończeniu konfiguracji wybierz pozycję Zakończ. Nastąpi powrót do głównego pulpitu nawigacyjnego. Teraz powinno zostać wyświetlone nowe urządzenie, którego typem jest IoT Edge Devices. Możesz wybrać urządzenie usługi IoT Edge, aby nawiązać z nim połączenie. Po stronie Przegląd możesz wyświetlić listę modułów IoT Edge oraz stan IoT Edge swojego urządzenia.

Możesz zweryfikować, czy utworzona przez Ciebie rejestracja indywidualna została użyta w usłudze zarządzania urządzeniami. Przejdź do instancji usługi konfiguracji urządzeń w portalu Azure. Otwórz szczegóły rejestracji dla rejestracji indywidualnej, którą utworzyłeś. Zwróć uwagę, że stan rejestracji to przypisany i że identyfikator urządzenia znajduje się na liście.

Możesz sprawdzić, czy rejestracja grupowa, którą utworzyłeś w usłudze konfiguracji urządzeń, została użyta. Przejdź do instancji usługi konfiguracji urządzeń w portalu Azure. Otwórz szczegóły rejestracji dla rejestracji grupowej, którą utworzyłeś. Przejdź do karty Rejestracja, aby wyświetlić wszystkie urządzenia zarejestrowane w tej grupie.

1. Zaloguj się do usługi IoT Edge dla systemu Linux na maszynie wirtualnej z systemem Windows przy użyciu następującego polecenia w sesji programu PowerShell:

   Connect-EflowVm
   

   Uwaga / Notatka

   Jedynym kontem, które może korzystać z SSH na maszynie wirtualnej, jest użytkownik, który ją utworzył.

2. Po zalogowaniu się możesz sprawdzić listę uruchomionych modułów usługi IoT Edge przy użyciu następującego polecenia systemu Linux:

   sudo iotedge list
   

3. Jeśli musisz rozwiązać problemy z usługą IoT Edge, użyj następujących poleceń systemu Linux.

   1. Pobierz dzienniki usługi.

      sudo journalctl -u iotedge
      

   2. check Użyj narzędzia , aby zweryfikować konfigurację i stan połączenia urządzenia.

      sudo iotedge check
      

   Uwaga / Notatka

   Na nowo aprowizowanych urządzeniach może zostać wyświetlony błąd związany z usługą IoT Edge Hub:

   × gotowość produkcyjna: katalog magazynu Edge Hub jest zachowywany w systemie plików hosta: błąd

   Nie można sprawdzić bieżącego stanu kontenera edgeHub

   Ten błąd jest oczekiwany na nowo zaaprowizowanych urządzeniach, ponieważ moduł usługi IoT Edge Hub nie jest uruchomiony. Aby rozwiązać ten problem, w usłudze IoT Hub ustaw moduły dla urządzenia i utwórz wdrożenie. Utworzenie wdrożenia urządzenia powoduje uruchomienie modułów na urządzeniu, w tym modułu IoT Edge Hub.

1. Wybierz urządzenie usługi IoT Edge z listy połączonych urządzeń w Centrum administracyjnym systemu Windows, aby nawiązać z nim połączenie.

2. Na stronie przeglądu urządzenia są wyświetlane niektóre informacje o urządzeniu:

   • W sekcji Lista modułów usługi IoT Edge przedstawiono uruchomione moduły na urządzeniu. Po pierwszym uruchomieniu usługi IoT Edge powinien zostać wyświetlony tylko moduł edgeAgent. Moduł edgeAgent działa domyślnie i pomaga zainstalować i uruchomić dodatkowe moduły wdrażane na urządzeniu.

   • Sekcja stanu usługi IoT Edge zawiera stan usługi i powinna zgłaszać aktywne (uruchomione).