Udostępnij za pomocą

Wdrażanie modułów usługi Azure IoT Edge przy użyciu interfejsu wiersza polecenia platformy Azure

Dotyczy:Znacznik wyboru usługi IoT Edge 1.5 IoT Edge 1.5

Ważne

Obsługiwana wersja usługi IoT Edge 1.5 LTS. Usługa IoT Edge 1.4 LTS kończy się od 12 listopada 2024 r. Jeśli korzystasz z wcześniejszej wersji, zobacz aktualizację Azure IoT Edge.

Po utworzeniu modułów usługi Azure IoT Edge przy użyciu logiki biznesowej wdróż je na urządzeniach, aby działały na brzegu sieci. Jeśli wiele modułów współpracuje ze sobą w celu zbierania i przetwarzania danych, wdróż je wszystkie jednocześnie. Zadeklaruj również reguły routingu, które je łączą.

Interfejs wiersza polecenia platformy Azure to wieloplatformowe narzędzie wiersza polecenia typu open source do zarządzania zasobami platformy Azure, takimi jak IoT Edge. Umożliwia zarządzanie zasobami usługi Azure IoT Hub, instancjami usługi aprowizacji urządzeń oraz powiązanymi koncentratorami. Nowe rozszerzenie IoT wzbogaca interfejs wiersza polecenia platformy Azure o funkcje, takie jak zarządzanie urządzeniami i pełne możliwości usługi IoT Edge.

W tym artykule wyjaśniono, jak utworzyć manifest wdrożenia JSON i użyć tego pliku, aby wypchnąć wdrożenie na urządzenie usługi IoT Edge. Aby uzyskać informacje na temat tworzenia wdrożenia przeznaczonego dla wielu urządzeń na podstawie ich udostępnionych tagów, zobacz Wdrażanie i monitorowanie modułów usługi IoT Edge na dużą skalę.

Wymagania wstępne

Konfigurowanie manifestu wdrożenia

Manifest wdrożenia to dokument JSON opisujący moduły do wdrożenia, sposób przepływu danych między modułami i żądane właściwości bliźniaczych reprezentacji modułu. Aby uzyskać więcej informacji na temat sposobu działania manifestów wdrażania i sposobu ich tworzenia, zobacz opis sposobu używania, konfigurowania i ponownego używania modułów usługi IoT Edge.

Aby wdrożyć moduły przy użyciu interfejsu wiersza polecenia platformy Azure, zapisz manifest wdrożenia lokalnie jako plik .json. Użyj ścieżki pliku w następnej sekcji, aby uruchomić polecenie i zastosować konfigurację do urządzenia.

Oto podstawowy manifest wdrożenia z jednym modułem jako przykład:

Uwaga

Ten przykładowy manifest wdrożenia używa schematu w wersji 1.1 dla agenta i centrum usługi IoT Edge. Wersja schematu 1.1 jest dołączona do usługi IoT Edge w wersji 1.0.10 i włącza funkcje, takie jak kolejność uruchamiania modułu i priorytetyzacja tras.

{
  "content": {
    "modulesContent": {
      "$edgeAgent": {
        "properties.desired": {
          "schemaVersion": "1.1",
          "runtime": {
            "type": "docker",
            "settings": {
              "minDockerVersion": "v1.25",
              "loggingOptions": "",
              "registryCredentials": {}
            }
          },
          "systemModules": {
            "edgeAgent": {
              "type": "docker",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-agent:1.5",
                "createOptions": "{}"
              }
            },
            "edgeHub": {
              "type": "docker",
              "status": "running",
              "restartPolicy": "always",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-hub:1.5",
                "createOptions": "{\"HostConfig\":{\"PortBindings\":{\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}],\"443/tcp\":[{\"HostPort\":\"443\"}]}}}"
              }
            }
          },
          "modules": {
            "SimulatedTemperatureSensor": {
              "version": "1.0",
              "type": "docker",
              "status": "running",
              "restartPolicy": "always",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.5",
                "createOptions": "{}"
              }
            }
          }
        }
      },
      "$edgeHub": {
        "properties.desired": {
          "schemaVersion": "1.1",
          "routes": {
            "upstream": "FROM /messages/* INTO $upstream"
          },
          "storeAndForwardConfiguration": {
            "timeToLiveSecs": 7200
          }
        }
      },
      "SimulatedTemperatureSensor": {
        "properties.desired": {
          "SendData": true,
          "SendInterval": 5
        }
      }
    }
  }
}

Wdrażanie na urządzeniu

Moduły są wdrażane na urządzeniu przez zastosowanie manifestu wdrożenia skonfigurowanego przy użyciu informacji o module.

Zmień katalogi na folder, w którym zapisano manifest wdrożenia. Jeśli użyto jednego z szablonów usługi IoT Edge programu Visual Studio Code, użyj deployment.json pliku w folderze konfiguracji katalogu rozwiązania, a nie deployment.template.json pliku.

Użyj następującego polecenia, aby zastosować konfigurację do urządzenia usługi IoT Edge:

az iot edge set-modules --device-id [device id] --hub-name [hub name] --content [file path]

Parametr identyfikatora urządzenia uwzględnia wielkość liter. Parametr zawartości wskazuje zapisany plik manifestu wdrożenia.

Zrzut ekranu przedstawiający dane wyjściowe wiersza polecenia az iot edge set-modules.

Wyświetlanie modułów na urządzeniu

Po wdrożeniu modułów na urządzeniu można wyświetlić je za pomocą następującego polecenia:

Wyświetl moduły znajdujące się na urządzeniu usługi IoT Edge:

az iot hub module-identity list --device-id [device id] --hub-name [hub name]

Parametr identyfikatora urządzenia uwzględnia wielkość liter.

Zrzut ekranu przedstawiający dane wyjściowe polecenia az iot hub module-identity list.

Następne kroki

Dowiedz się, jak wdrażać i monitorować moduły usługi IoT Edge na dużą skalę

  • Last updated on