Szybki Start: wdrażanie pierwszego modułu IoT Edge na urządzeniu wirtualnym z systemem WindowsQuickstart: Deploy your first IoT Edge module to a virtual Windows device

Wypróbuj Azure IoT Edge w tym przewodniku Szybki Start, wdrażając kod kontenerowy na wirtualnym urządzeniu z systemem Windows IoT Edge.Try out Azure IoT Edge in this quickstart by deploying containerized code to a virtual Windows IoT Edge device. IoT Edge umożliwia zdalne zarządzanie kodem na urządzeniach, dzięki czemu można wysyłać więcej obciążeń do krawędzi.IoT Edge allows you to remotely manage code on your devices so that you can send more of your workloads to the edge. W tym przewodniku szybki start zalecamy korzystanie z maszyny wirtualnej platformy Azure dla urządzenia IoT Edge.For this quickstart, we recommend using an Azure virtual machine for your IoT Edge device. Za pomocą maszyny wirtualnej można szybko utworzyć maszynę testową, zainstalować wymagania wstępne, a następnie usunąć ją po zakończeniu.Using a virtual machine allows you to quickly create a test machine, install the prerequisites, and then delete it when you're finished.

W tym przewodniku Szybki start zawarto informacje na temat wykonywania następujących czynności:In this quickstart you learn how to:

  • Utwórz centrum IoT.Create an IoT hub.
  • Rejestrowanie urządzenia usługi IoT Edge w centrum IoT Hub.Register an IoT Edge device to your IoT hub.
  • Zainstaluj i uruchom środowisko uruchomieniowe IoT Edge na urządzeniu wirtualnym.Install and start the IoT Edge runtime on your virtual device.
  • Zdalne wdrażanie modułu do urządzenia usługi IoT Edge i wysyłanie telemetrii do usługi IoT Hub.Remotely deploy a module to an IoT Edge device and send telemetry to IoT Hub.

Diagram — architektura przewodnika Szybki start dla urządzenia i chmury

Ten przewodnik Szybki Start przeprowadzi Cię przez proces tworzenia maszyny wirtualnej z systemem Windows i skonfigurowania jej jako urządzenia IoT Edge.This quickstart walks you through creating a Windows virtual machine and configuring it to be an IoT Edge device. Następnie należy wdrożyć moduł z Azure Portal na urządzeniu.Then, you deploy a module from the Azure portal to your device. Moduł używany w tym przewodniku szybki start to symulowany czujnik, który generuje dane dotyczące temperatury, wilgotności i ciśnienia.The module used in this quickstart is a simulated sensor that generates temperature, humidity, and pressure data. Inne samouczki Azure IoT Edge kompilują się po pracy wykonywanej w tym miejscu przez wdrożenie dodatkowych modułów, które analizują symulowane dane dla szczegółowych informacji o firmie.The other Azure IoT Edge tutorials build upon the work you do here by deploying additional modules that analyze the simulated data for business insights.

Jeśli nie masz aktywnej subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.If you don't have an active Azure subscription, create a free account before you begin.

Używanie usługi Azure Cloud ShellUse Azure Cloud Shell

Na platforma Azure hostowane jest Azure Cloud Shell, interaktywne środowisko powłoki, z którego można korzystać w przeglądarce.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Do pracy z usługami platformy Azure można używać programu Bash lub PowerShell w środowisku Cloud Shell.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. Aby uruchomić kod z tego artykułu bez konieczności instalowania narzędzi w środowisku lokalnym, można użyć wstępnie zainstalowanych poleceń środowiska Cloud Shell.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Aby uruchomić środowisko Azure Cloud Shell:To start Azure Cloud Shell:

OpcjaOption Przykład/linkExample/Link
Wybierz pozycję Wypróbuj w prawym górnym rogu bloku kodu.Select Try It in the upper-right corner of a code block. Wybranie pozycji Wypróbuj nie spowoduje automatycznego skopiowania kodu do środowiska Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Przykład funkcji Wypróbuj w środowisku Azure Cloud Shell
Przejdź do witryny https://shell.azure.com lub wybierz przycisk Uruchom Cloud Shell, aby otworzyć środowisko Cloud Shell w przeglądarce.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. Uruchamianie środowiska Cloud Shell w nowym oknieLaunch Cloud Shell in a new window
Wybierz przycisk Cloud Shell na pasku menu w prawym górnym rogu witryny Azure Portal.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Przycisk Cloud Shell w witrynie Azure Portal

Aby uruchomić kod z tego artykułu w środowisku Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Uruchom usługę Cloud Shell.Start Cloud Shell.

  2. Wybierz przycisk Kopiuj w bloku kodu, aby skopiować kod.Select the Copy button on a code block to copy the code.

  3. Wklej kod w sesji Cloud Shell, naciskając klawisze Ctrl+Shift+V w systemach Windows i Linux lub klawisze Cmd+Shift+V w systemie macOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Naciśnij klawisz Enter, aby uruchomić kod.Select Enter to run the code.

Użyj interfejsu wiersza polecenia platformy Azure, aby wykonać wiele kroków z tego przewodnika Szybki Start.You use the Azure CLI to complete many of the steps in this quickstart. Usługa Azure IoT ma rozszerzenie umożliwiające włączenie dodatkowych funkcji.Azure IoT has an extension to enable additional functionality.

Dodaj rozszerzenie Azure IoT do wystąpienia Cloud Shell.Add the Azure IoT extension to the Cloud Shell instance.

az extension add --name azure-iot

Uwaga

W tym artykule jest stosowana Najnowsza wersja rozszerzenia usługi Azure IoT o nazwie azure-iot .This article uses the newest version of the Azure IoT extension, called azure-iot. Starsza wersja jest wywoływana azure-cli-iot-ext . W danym momencie powinna być zainstalowana tylko jedna wersja.The legacy version is called azure-cli-iot-ext.You should only have one version installed at a time. Za pomocą polecenia można az extension list sprawdzić poprawność zainstalowanych rozszerzeń.You can use the command az extension list to validate the currently installed extensions.

Służy az extension remove --name azure-cli-iot-ext do usuwania starszej wersji rozszerzenia.Use az extension remove --name azure-cli-iot-ext to remove the legacy version of the extension.

Użyj az extension add --name azure-iot , aby dodać nową wersję rozszerzenia.Use az extension add --name azure-iot to add the new version of the extension.

Aby zobaczyć, jakie rozszerzenia zostały zainstalowane, użyj programu az extension list .To see what extensions you have installed, use az extension list.

Wymagania wstępnePrerequisites

Zasoby w chmurze:Cloud resources:

  • Grupa zasobów do zarządzania wszystkimi zasobami używanymi w tym przewodniku Szybki start.A resource group to manage all the resources you use in this quickstart.

    az group create --name IoTEdgeResources --location westus2
    

Urządzenie usługi IoT Edge:IoT Edge device:

  • Maszyna wirtualna z systemem Windows, która będzie działać jako urządzenie IoT Edge.A Windows virtual machine to act as your IoT Edge device. Tę maszynę wirtualną można utworzyć przy użyciu następującego polecenia, zastępując je {password} bezpiecznym hasłem:You can create this virtual machine using the following command, replacing {password} with a secure password:

    az vm create --resource-group IoTEdgeResources --name EdgeVM --image MicrosoftWindowsDesktop:Windows-10:rs5-pro:latest --admin-username azureuser --admin-password {password} --size Standard_DS1_v2
    

    Utworzenie i uruchomienie nowej maszyny wirtualnej może potrwać kilka minut.It may take a few minutes to create and start the new virtual machine.

    Po uruchomieniu maszyny wirtualnej można pobrać plik RDP do użycia podczas nawiązywania połączenia z maszyną wirtualną:Once your virtual machine starts, you can download an RDP file for use when connecting to your virtual machine:

    1. Przejdź do nowej maszyny wirtualnej z systemem Windows w Azure Portal.Navigate to your new Windows virtual machine in the Azure portal.
    2. Wybierz pozycję Połącz.Select Connect.
    3. Na karcie RDP wybierz pozycję Pobierz plik RDP.On the RDP tab, select Download RDP File.

    Otwórz ten plik z Podłączanie pulpitu zdalnego, aby nawiązać połączenie z maszyną wirtualną z systemem Windows przy użyciu nazwy użytkownika i hasła podanego za pomocą az vm create polecenia.Open this file with Remote Desktop Connection to connect to your Windows virtual machine using the administrator name and password you specified with the az vm create command.

Uwaga

Maszyna wirtualna z systemem Windows zaczyna się od systemu Windows w wersji 1809 (kompilacja 17763), czyli najnowszej kompilacji długoterminowej pomocy technicznej systemu Windows.Your Windows virtual machine starts with Windows version 1809 (build 17763), which is the latest Windows long-term support build. System Windows automatycznie sprawdza aktualizacje co 22 godziny.Windows automatically checks for updates every 22 hours by default. Po sprawdzeniu maszyny wirtualnej system Windows wypycha aktualizację wersji, która jest niezgodna z IoT Edge dla systemu Windows, co uniemożliwi dalsze korzystanie z IoT Edge funkcji systemu Windows.After a check on your virtual machine, Windows pushes a version update that is incompatible with IoT Edge for Windows, which prevents further use of IoT Edge for Windows features. Zalecamy ograniczenie używania maszyny wirtualnej do 22 godzin lub czasowo wstrzymanie aktualizacji systemu Windows.We recommend limiting use of your virtual machine to within 22 hours or temporarily pausing Windows updates.

W tym przewodniku szybki start do uproszczenia jest stosowana maszyna wirtualna z systemem Windows.This quickstart uses a Windows desktop virtual machine for simplicity. Informacje o tym, które systemy operacyjne Windows są ogólnie dostępne w scenariuszach produkcyjnych, można znaleźć w temacie Azure IoT Edge obsługiwane systemy.For information about which Windows operating systems are generally available for production scenarios, see Azure IoT Edge supported systems.

Aby skonfigurować własne urządzenie z systemem Windows w celu IoT Edge, w tym urządzeń z systemem IoT Core, wykonaj kroki opisane w temacie Instalowanie środowiska wykonawczego Azure IoT Edge w systemie Windows.If you're ready to configure your own Windows device for IoT Edge, including devices running IoT Core, follow the steps in Install the Azure IoT Edge runtime on Windows.

Tworzenie centrum IoT HubCreate an IoT hub

Rozpocznij pracę z przewodnikiem Szybki start od utworzenia centrum IoT za pomocą interfejsu wiersza polecenia platformy Azure.Start the quickstart by creating an IoT hub with Azure CLI.

Diagram — tworzenie centrum IoT Hub w chmurze

W tym przewodniku Szybki start wystarcza warstwa bezpłatna usługi IoT Hub.The free level of IoT Hub works for this quickstart. Jeśli w przeszłości użyto IoT Hub i masz już utworzone centrum, możesz użyć tego Centrum IoT.If you've used IoT Hub in the past and already have a hub created, you can use that IoT hub.

Poniższy kod tworzy bezpłatny koncentrator F1 w grupie zasobów IoTEdgeResources .The following code creates a free F1 hub in the resource group IoTEdgeResources. Zamień na {hub_name} unikatową nazwę Centrum IoT.Replace {hub_name} with a unique name for your IoT hub. Utworzenie IoT Hub może potrwać kilka minut.It might take a few minutes to create an IoT Hub.

az iot hub create --resource-group IoTEdgeResources --name {hub_name} --sku F1 --partition-count 2

Jeśli wystąpi błąd, ponieważ w subskrypcji jest już jedno bezpłatne centrum, zmień jednostkę SKU na S1.If you get an error because there's already one free hub in your subscription, change the SKU to S1. Jeśli wystąpi błąd polegający na niedostępności nazwy centrum IoT Hub, oznacza to, że ktoś inny ma już centrum o takiej nazwie.If you get an error that the IoT Hub name isn't available, it means that someone else already has a hub with that name. Wypróbuj nową nazwę.Try a new name.

Rejestrowanie urządzenia usługi IoT EdgeRegister an IoT Edge device

Zarejestruj urządzenie usługi IoT Edge, korzystając z nowo utworzonego centrum IoT.Register an IoT Edge device with your newly created IoT hub. Diagram — rejestrowanie urządzenia przy użyciu tożsamości usługi IoT HubDiagram - Register a device with an IoT Hub identity

Utwórz tożsamość urządzenia symulowanego, aby umożliwić mu komunikowanie się z centrum IoT Hub.Create a device identity for your simulated device so that it can communicate with your IoT hub. Tożsamość urządzenia jest przechowywana w chmurze, a w celu skojarzenia urządzenia fizycznego z tożsamością urządzenia używane są unikatowe parametry połączenia urządzenia.The device identity lives in the cloud, and you use a unique device connection string to associate a physical device to a device identity.

Ponieważ urządzenia usługi IoT Edge zachowują się inaczej niż typowe urządzenia IoT, a także mogą być inaczej zarządzane, zadeklaruj tę tożsamość jako należącą do urządzenia usługi IoT Edge za pomocą flagi --edge-enabled.Since IoT Edge devices behave and can be managed differently than typical IoT devices, declare this identity to be for an IoT Edge device with the --edge-enabled flag.

  1. W Azure Cloud Shell wprowadź następujące polecenie, aby utworzyć urządzenie o nazwie myEdgeDevice w centrum.In the Azure Cloud Shell, enter the following command to create a device named myEdgeDevice in your hub.

    az iot hub device-identity create --device-id myEdgeDevice --edge-enabled --hub-name {hub_name}
    

    Jeśli wystąpi błąd dotyczący kluczy zasad iothubowner, upewnij się, że na Cloud Shell jest uruchomiona Najnowsza wersja rozszerzenia Azure-IoT.If you get an error about iothubowner policy keys, make sure that your Cloud Shell is running the latest version of the azure-iot extension.

  2. Wyświetl parametry połączenia dla urządzenia, które łączy urządzenie fizyczne z jego tożsamością w IoT Hub.View the connection string for your device, which links your physical device with its identity in IoT Hub. Zawiera nazwę Centrum IoT, nazwę urządzenia, a następnie klucz współużytkowany, który uwierzytelnia połączenia między nimi.It contains the name of your IoT hub, the name of your device, and then a shared key that authenticates connections between the two.

    az iot hub device-identity show-connection-string --device-id myEdgeDevice --hub-name {hub_name}
    
  3. Skopiuj wartość klucza connectionString z danych wyjściowych JSON i zapisz ją.Copy the value of the connectionString key from the JSON output and save it. Ta wartość to parametry połączenia urządzenia.This value is the device connection string. Za pomocą tych parametrów połączenia skonfigurujesz środowisko uruchomieniowe usługi IoT Edge w następnej sekcji.You'll use this connection string to configure the IoT Edge runtime in the next section.

    Pobieranie parametrów połączenia z danych wyjściowych interfejsu wiersza polecenia

Instalowanie i uruchamianie środowiska uruchomieniowego usługi IoT EdgeInstall and start the IoT Edge runtime

Zainstaluj środowisko uruchomieniowe usługi Azure IoT Edge na urządzeniu usługi IoT Edge i skonfiguruj je przy użyciu parametrów połączenia urządzenia.Install the Azure IoT Edge runtime on your IoT Edge device and configure it with a device connection string. Diagram — uruchamianie środowiska uruchomieniowego na urządzeniuDiagram - Start the runtime on device

Środowisko uruchomieniowe usługi IoT Edge jest wdrażane na wszystkich urządzeniach usługi IoT Edge.The IoT Edge runtime is deployed on all IoT Edge devices. Składa się ono z trzech składników.It has three components. Demon IoT Edge Security jest uruchamiany za każdym razem, gdy IoT Edge urządzenie zostanie uruchomione i rozpocznie rozruch urządzenia przez uruchomienie agenta IoT Edge.The IoT Edge security daemon starts each time an IoT Edge device boots and bootstraps the device by starting the IoT Edge agent. Agent usługi IoT Edge ułatwia wdrażanie i monitorowanie modułów na urządzeniu usługi IoT Edge, w tym centrum usługi IoT Edge.The IoT Edge agent manages deployment and monitoring of modules on the IoT Edge device, including the IoT Edge hub. Centrum usługi IoT Edge obsługuje komunikację między modułami na urządzeniu usługi IoT Edge oraz między urządzeniem a usługą IoT Hub.The IoT Edge hub handles communications between modules on the IoT Edge device, and between the device and IoT Hub.

Skrypt instalacji zawiera także aparat kontenera o nazwie Moby, który zarządza obrazami kontenerów na urządzeniu usługi IoT Edge.The installation script also includes a container engine called Moby that manages the container images on your IoT Edge device.

Podczas instalowania środowiska uruchomieniowego pojawi się prośba o podanie parametrów połączenia urządzenia.During the runtime installation, you're asked for a device connection string. Użyj parametrów pobranych za pomocą wiersza polecenia platformy Azure.Use the string that you retrieved from the Azure CLI. Za pomocą tych parametrów urządzenie fizyczne jest kojarzone z tożsamością urządzenia usługi IoT Edge na platformie Azure.This string associates your physical device with the IoT Edge device identity in Azure.

Nawiązywanie połączenia z urządzeniem usługi IoT EdgeConnect to your IoT Edge device

Kroki opisane w tej sekcji odbywają się na urządzeniu IoT Edge, dlatego chcesz połączyć się z tą maszyną wirtualną teraz za pośrednictwem pulpitu zdalnego.The steps in this section all take place on your IoT Edge device, so you want to connect to that virtual machine now via remote desktop.

Instalowanie i Konfigurowanie usługi IoT EdgeInstall and configure the IoT Edge service

Pobierz i zainstaluj środowisko uruchomieniowe usługi IoT Edge za pomocą programu PowerShell.Use PowerShell to download and install the IoT Edge runtime. Do skonfigurowania urządzenia użyj parametrów połączenia urządzenia pobranych z usługi IoT Hub.Use the device connection string that you retrieved from IoT Hub to configure your device.

  1. Jeśli jeszcze tego nie zrobiono, wykonaj kroki opisane w temacie Rejestrowanie nowego urządzenia Azure IoT Edge , aby zarejestrować urządzenie i pobrać parametry połączenia urządzenia.If you haven't already, follow the steps in Register a new Azure IoT Edge device to register your device and retrieve the device connection string.

  2. Na maszynie wirtualnej Uruchom program PowerShell jako administrator.In the virtual machine, run PowerShell as an administrator.

    Uwaga

    Użyj sesji AMD64 programu PowerShell, aby zainstalować IoT Edge, a nie PowerShell (x86).Use an AMD64 session of PowerShell to install IoT Edge, not PowerShell (x86). Jeśli nie masz pewności, który typ sesji jest używany, uruchom następujące polecenie:If you're not sure which session type you're using, run the following command:

    (Get-Process -Id $PID).StartInfo.EnvironmentVariables["PROCESSOR_ARCHITECTURE"]
    
  3. Polecenie Deploy-IoTEdge sprawdza, czy komputer z systemem Windows jest w obsługiwanej wersji, włącza funkcję Containers, pobiera środowisko uruchomieniowe Moby, a następnie pobiera środowisko uruchomieniowe IoT Edge.The Deploy-IoTEdge command checks that your Windows machine is on a supported version, turns on the containers feature, downloads the Moby runtime, and then downloads the IoT Edge runtime.

    . {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; `
    Deploy-IoTEdge -ContainerOs Windows
    
  4. Komputer może zostać automatycznie uruchomiony ponownie.Your machine may restart automatically. Jeśli zostanie wyświetlony monit o polecenie Deploy-IoTEdge w celu ponownego uruchomienia, zrób to teraz.If you are prompted by the Deploy-IoTEdge command to reboot, do so now.

  5. Uruchom ponownie program PowerShell jako administrator.Run PowerShell as an administrator again.

  6. Polecenie Initialize-IoTEdge konfiguruje środowisko uruchomieniowe IoT Edge na komputerze.The Initialize-IoTEdge command configures the IoT Edge runtime on your machine. Polecenie domyślnie umożliwia ręczne Inicjowanie obsługi przy użyciu kontenerów systemu Windows.The command defaults to manual provisioning with Windows containers.

    . {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; `
    Initialize-IoTEdge -ContainerOs Windows
    
  7. Po wyświetleniu prośby o podanie wartości DeviceConnectionString, wpisz parametry skopiowane w poprzedniej sekcji.When prompted for a DeviceConnectionString, provide the string that you copied in the previous section. Nie dołączaj znaków cudzysłowów otaczających parametry połączenia.Don't include quotes around the connection string.

Wyświetlanie stanu środowiska uruchomieniowego usługi IoT EdgeView the IoT Edge runtime status

Sprawdź, czy środowisko uruchomieniowe zostało pomyślnie zainstalowane i skonfigurowane.Verify that the runtime was successfully installed and configured. Ukończenie instalacji może potrwać kilka minut, a moduł agenta IoT Edge zostanie uruchomiony.It may take a few minutes for the installation to complete and the IoT Edge agent module to start.

  1. Sprawdź stan usługi IoT Edge.Check the status of the IoT Edge service.

    Get-Service iotedge
    
  2. Jeśli potrzebujesz rozwiązać problem z usługą, pobierz jej dzienniki.If you need to troubleshoot the service, retrieve the service logs.

    . {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; Get-IoTEdgeLog
    
  3. Wyświetl wszystkie moduły uruchomione na urządzeniu usługi IoT Edge.View all the modules running on your IoT Edge device. Ponieważ usługa została właśnie uruchomiona po raz pierwszy, tylko moduł edgeAgent powinien być widoczny jako uruchomiony.Since the service just started for the first time, you should only see the edgeAgent module running. Moduł edgeAgent jest domyślnie uruchamiany i ułatwia Instalowanie i uruchamianie wszelkich dodatkowych modułów wdrażanych na urządzeniu.The edgeAgent module runs by default and helps to install and start any additional modules that you deploy to your device.

    iotedge list
    

    Wyświetlanie jednego modułu na urządzeniu

Urządzenie usługi IoT Edge jest teraz skonfigurowane.Your IoT Edge device is now configured. Jest ono gotowe do uruchamiania modułów wdrożonych w chmurze.It's ready to run cloud-deployed modules.

Wdrażanie modułuDeploy a module

Zarządzając urządzeniem usługi Azure IoT Edge z chmury, wdróż moduł przesyłający dane telemetryczne do centrum IoT Hub.Manage your Azure IoT Edge device from the cloud to deploy a module that sends telemetry data to IoT Hub.

Diagram — wdrażanie modułu z chmury do urządzenia

Jedną z najważniejszych funkcji usługi Azure IoT Edge jest możliwość wdrażania kodu na urządzeniach usługi IoT Edge z poziomu chmury.One of the key capabilities of Azure IoT Edge is being able to deploy code to your IoT Edge devices from the cloud. Moduły usługi IoT Edge to pakiety plików wykonywalnych implementowane jako kontenery.IoT Edge modules are executable packages implemented as containers. Ta sekcja obejmuje wdrożenie wstępnie skompilowanego modułu z sekcji modułów IoT Edge w portalu Azure Marketplace bezpośrednio z poziomu usługi Azure IoT Hub.In this section, you deploy a pre-built module from the IoT Edge Modules section of the Azure Marketplace directly from your Azure IoT Hub.

Moduł, który wdrożysz w tej sekcji, symuluje czujnik i wysyła wygenerowane dane.The module that you deploy in this section simulates a sensor and sends generated data. Ten moduł jest przydatny, gdy rozpoczyna się pracę z usługą IoT Edge, ponieważ symulowane dane można wykorzystać przy programowaniu i testowaniu.This module is a useful piece of code when you're getting started with IoT Edge because you can use the simulated data for development and testing. Jeśli chcesz zobaczyć, co dokładnie robi ten moduł, możesz wyświetlić kod źródłowy symulowanego czujnika temperatury.If you want to see exactly what this module does, you can view the simulated temperature sensor source code.

Aby wdrożyć swój pierwszy moduł z witryny Azure Marketplace, wykonaj następujące kroki:To deploy your first module from the Azure Marketplace, use the following steps:

  1. Zaloguj się do Azure Portal i przejdź do centrum IoT Hub.Sign in to the Azure portal and navigate to your IoT hub.

  2. W menu po lewej stronie w obszarze Automatyczne zarządzanie urządzeniamiwybierz pozycję IoT Edge.From the menu on the left pane, under Automatic Device Management, select IoT Edge.

  3. Kliknij identyfikator urządzenia na urządzeniu docelowym z listy urządzeń.Click on the device ID of the target device from the list of devices.

  4. Na górnym pasku wybierz pozycję Ustaw moduły.On the upper bar, select Set Modules.

    Wybierz pozycję Ustaw moduły na stronie Szczegóły urządzenia

  5. W sekcji IoT Edge modułów na stronie kliknij pozycję Dodaj i wybierz pozycję moduł Marketplace z menu rozwijanego.In the IoT Edge Modules section of the page, click Add and select Marketplace Module from the drop-down menu.

    Dodaj moduł witryny Marketplace

  6. W witrynie IoT Edge MarketplaceWyszukaj ciąg "symulowanie czujnika temperatury" i wybierz ten moduł.In the IoT Edge Module Marketplace, search for "Simulated Temperature Sensor" and select that module.

  7. Zwróć uwagę, że moduł SimulatedTemperatureSensor jest dodawany do sekcji modułów IoT Edge z uruchomionymżądanym stanem.Notice that the SimulatedTemperatureSensor module is added to the IoT Edge Modules section, with the desired status running.

    Wybierz pozycję Dalej: trasy , aby przejść do następnego kroku kreatora.Select Next: Routes to continue to the next step of the wizard.

    Przejdź do następnego kroku po wystawieniu modułu czujnika temperatury

  8. Na karcie trasy kreatora możesz określić sposób przekazywania komunikatów między modułami i IoT Hub.On the Routes tab of the wizard, you can define how messages are passed between modules and the IoT Hub. Trasy są konstruowane przy użyciu par nazwa/wartość.Routes are constructed using name/value pairs. Na tej stronie powinny być widoczne dwie trasy.You should see two routes on this page. Trasa domyślna o nazwie Route wysyła wszystkie komunikaty do IoT Hub (która jest wywoływana $upstream ).The default route called route sends all messages to IoT Hub (which is called $upstream). Druga trasa o nazwie SimulatedTemperatureSensorToIoTHub została utworzona automatycznie po dodaniu modułu z portalu Marketplace.A second route called SimulatedTemperatureSensorToIoTHub was created automatically when you added the module from the Marketplace. Ta trasa wysyła wszystkie komunikaty przeznaczone wyłącznie z modułu symulowanej temperatury do IoT Hub.This route sends all messages specifically from the simulated temperature module to IoT Hub. Trasy domyślnej można usunąć, ponieważ jest ona nadmiarowa w tym przypadku.You can delete the default route because it's redundant in this case.

    Wybierz kolejno pozycje Dalej: przegląd + Utwórz , aby przejść do następnego kroku kreatora.Select Next: Review + create to continue to the next step of the wizard.

    Usuń trasę domyślną, a następnie przejdź do następnego kroku

  9. Na karcie Przegląd + tworzenie kreatora można wyświetlić podgląd pliku JSON, który definiuje wszystkie moduły, które są wdrażane na urządzeniu IoT Edge.On the Review + create tab of the wizard, you can preview the JSON file that defines all the modules that get deployed to your IoT Edge device. Zwróć uwagę, że moduł SimulatedTemperatureSensor jest dołączony, a także dwa moduły uruchomieniowe, edgeAgent i edgeHub.Notice that the SimulatedTemperatureSensor module is included as well as the two runtime modules, edgeAgent and edgeHub. Wybierz pozycję Utwórz po zakończeniu przeglądania.Select Create when you're done reviewing.

    Podczas przesłania nowego wdrożenia na urządzenie usługi IoT Edge do urządzenia nie jest wypychane żadne powiadomienie.When you submit a new deployment to an IoT Edge device, nothing is pushed to your device. Nie jest to konieczne, ponieważ urządzenie regularnie wysyła do usługi IoT Hub zapytania w celu odebrania wszelkich nowych instrukcji.Instead, the device queries IoT Hub regularly for any new instructions. Jeśli urządzenie znajdzie zaktualizowany manifest wdrażania, użyje informacji o nowym wdrożeniu, aby ściągnąć obrazy modułów z chmury, a następnie zacznie uruchamiać moduły lokalnie.If the device finds an updated deployment manifest, it uses the information about the new deployment to pull the module images from the cloud then starts running the modules locally. Ten proces może potrwać kilka minut.This process may take a few minutes.

  10. Po utworzeniu szczegółów wdrożenia modułu Kreator powróci do strony szczegółów urządzenia.After you create the module deployment details, the wizard returns you to the device details page. Na stronie Szczegóły urządzenia Wyświetl stan wdrożenia na karcie moduły . Należy wymienić trzy moduły: $edgeAgent, $edgeHub i SimulatedTemperatureSensor.On the device details page, view the deployment status in the Modules tab. Three modules should be listed: $edgeAgent, $edgeHub, and SimulatedTemperatureSensor. Jeśli co najmniej jeden z modułów jest wyświetlany jako określony we wdrożeniu, ale nie jako zgłaszany przez urządzenie, to urządzenie usługi IoT Edge nadal go uruchamia.If one or more of the modules are listed as specified in deployment but not reported by device, your IoT Edge device is still starting them. Poczekaj chwilę, a następnie wybierz pozycję Odśwież w górnej części strony.Wait a few moments and select Refresh at the top of the page.

    Wyświetlanie modułu SimulatedTemperatureSensor na liście wdrożonych modułów

Wyświetlanie wygenerowanych danychView generated data

W tym przewodniku Szybki start utworzono nowe urządzenie usługi IoT Edge i zainstalowano na nim środowisko uruchomieniowe usługi IoT Edge.In this quickstart, you created a new IoT Edge device and installed the IoT Edge runtime on it. Następnie użyto witryny Azure Portal do wdrożenia modułu usługi IoT Edge w celu uruchomienia go na urządzeniu bez konieczności wprowadzenia zmian na samym urządzeniu.Then, you used the Azure portal to deploy an IoT Edge module to run on the device without having to make changes to the device itself.

W takim przypadku moduł, który wypychał, generuje przykładowe dane środowiska, których można użyć do testowania później.In this case, the module that you pushed generates sample environment data that you can use for testing later. Symulowany czujnik monitoruje maszynę i środowisko wokół maszyny.The simulated sensor is monitoring both a machine and the environment around the machine. Na przykład ten czujnik może być umieszczony w serwerowni, w hali fabrycznej lub na turbinie wiatrowej.For example, this sensor might be in a server room, on a factory floor, or on a wind turbine. Komunikat zawiera temperaturę i wilgotność otoczenia, temperaturę maszyny, ciśnienie oraz znacznik czasu.The message includes ambient temperature and humidity, machine temperature and pressure, and a timestamp. W samouczkach usługi IoT Edge dane utworzone przez ten moduł są używane jako dane testowe do analizy.The IoT Edge tutorials use the data created by this module as test data for analytics.

Upewnij się, że moduł wdrożony z chmury jest uruchomiony na urządzeniu usługi IoT Edge.Confirm that the module deployed from the cloud is running on your IoT Edge device.

iotedge list

Wyświetlanie trzech modułów na urządzeniu

Wyświetl komunikaty wysyłane z modułu czujnika temperatury do chmury.View the messages being sent from the temperature sensor module to the cloud.

iotedge logs SimulatedTemperatureSensor -f

Porada

Przy odwoływaniu się do nazw modułów w poleceniach usługi IoT Edge jest rozróżniana wielkość liter.IoT Edge commands are case-sensitive when referring to module names.

Wyświetlanie danych z modułu

Możesz również obejrzeć komunikaty docierające do centrum IoT Hub przy użyciu rozszerzenia IoT Hub platformy Azure dla Visual Studio Code.You can also watch the messages arrive at your IoT hub by using the Azure IoT Hub extension for Visual Studio Code.

Czyszczenie zasobówClean up resources

Jeśli chcesz przejść do samouczków dotyczących usługi IoT Edge, możesz użyć urządzenia, które zostało zarejestrowane i skonfigurowane w ramach tego przewodnika Szybki start.If you want to continue on to the IoT Edge tutorials, you can use the device that you registered and set up in this quickstart. W przeciwnym razie możesz usunąć utworzone zasoby platformy Azure, aby uniknąć naliczania opłat.Otherwise, you can delete the Azure resources that you created to avoid charges.

Jeśli maszyna wirtualna i centrum IoT Hub zostały utworzone w nowej grupie zasobów, możesz usunąć tę grupę i wszystkie powiązane zasoby.If you created your virtual machine and IoT hub in a new resource group, you can delete that group and all the associated resources. Sprawdź dokładnie zawartość grupy zasobów, aby się upewnić, że nie ma w niej żadnych elementów, które chcesz zachować.Double check the contents of the resource group to make sure that there's nothing you want to keep. Jeśli nie chcesz usuwać całej grupy, możesz usunąć poszczególne zasoby.If you don't want to delete the whole group, you can delete individual resources instead.

Ważne

Usunięcie grupy zasobów jest nieodwracalne.Deleting a resource group is irreversible.

Usuń grupę IoTEdgeResources.Remove the IoTEdgeResources group. Usunięcie grupy zasobów może potrwać kilka minut.It might take a few minutes to delete a resource group.

az group delete --name IoTEdgeResources

Można potwierdzić, że grupa zasobów zostanie usunięta, wyświetlając listę grup zasobów.You can confirm the resource group is removed by viewing the list of resource groups.

az group list

Następne krokiNext steps

W tym przewodniku Szybki start utworzono urządzenie usługi IoT Edge i wdrożono na nim kod przy użyciu interfejsu usługi Azure IoT Edge w chmurze.In this quickstart, you created an IoT Edge device and used the Azure IoT Edge cloud interface to deploy code onto the device. Masz teraz urządzenie testowe generujące dane pierwotne dotyczące jego otoczenia.Now, you have a test device generating raw data about its environment.

Następnym krokiem jest skonfigurowanie lokalnego środowiska programistycznego, aby można było rozpocząć tworzenie modułów IoT Edge, które uruchamiają logikę biznesową.The next step is to set up your local development environment so that you can start creating IoT Edge modules that run your business logic.