Udostępnij za pośrednictwem


Zarządzanie manifestami wdrażania usługi IoT Edge w aplikacji usługi IoT Central

Manifest wdrożenia umożliwia określenie modułów, które środowisko uruchomieniowe usługi IoT Edge powinno pobrać i skonfigurować. Urządzenie usługi IoT Edge może pobrać manifest wdrożenia po pierwszym połączeniu z aplikacją usługi IoT Central. W tym artykule opisano sposób zarządzania manifestami wdrażania w aplikacji usługi IoT Central.

Aby dowiedzieć się więcej na temat usług IoT Edge i IoT Central, zobacz Połączenie urządzeniach usługi Azure IoT Edge do aplikacji usługi Azure IoT Central.

Aby dowiedzieć się, jak zarządzać manifestami wdrażania przy użyciu interfejsu API REST usługi IoT Central, zobacz How to use the IoT Central REST API to manage deployment manifests (Jak zarządzać manifestami wdrażania przy użyciu interfejsu API REST usługi IoT Central).

Zarządzanie manifestami wdrażania

Strona Manifesty przeglądarki Edge umożliwia zarządzanie manifestami wdrażania w aplikacji. Na tej stronie można wykonywać następujące czynności:

  • Przekazywanie lub tworzenie manifestów wdrożenia
  • Modyfikowanie istniejących manifestów wdrażania
  • Usuwanie manifestów wdrożenia

Przekazywanie i tworzenie manifestów wdrożenia

Podczas tworzenia nowego manifestu wdrożenia można przekazać plik JSON manifestu wdrożenia lub rozpocząć od istniejącego manifestu:

  1. Na stronie Manifesty przeglądarki Edge wybierz pozycję + Nowy.

  2. Wprowadź nazwę manifestu wdrożenia.

  3. Jeśli aplikacja używa organizacji, wybierz organizację do skojarzenia manifestu wdrożenia.

  4. Wyszukaj plik manifestu wdrożenia, aby przekazać lub wybrać istniejący manifest wdrożenia jako punkt początkowy dla nowego. Usługa IoT Central weryfikuje wszystkie przekazane pliki.

    Screenshot that shows an uploaded and validated deployment manifest.

  5. Wybierz Dalej. Na stronie Przeglądanie i kończenie są wyświetlane informacje o manifeście wdrożenia oraz zdefiniowane przez niego moduły. Możesz również wyświetlić nieprzetworzone dane JSON.

  6. Wybierz pozycję Utwórz. Strona Manifesty usługi Edge zawiera teraz nowy manifest wdrożenia.

Napiwek

Jeśli masz dużą liczbę manifestu wdrożenia, możesz sortować i filtrować listę wyświetlaną na stronie manifestów usługi Edge.

Edytowanie źródła JSON manifestu wdrożenia

Aby zmodyfikować manifest wdrożenia, edytując bezpośrednio kod JSON:

  1. Przejdź do strony Manifesty przeglądarki Edge.

  2. Wybierz pozycję Edytuj kod JSON w menu kontekstowym manifestu wdrożenia, który chcesz zmodyfikować.

  3. Użyj edytora JSON, aby wprowadzić wymagane zmiany. Następnie wybierz opcję Zapisz.

Zastępowanie zawartości manifestu wdrożenia

Aby całkowicie zastąpić zawartość manifestu wdrożenia:

  1. Przejdź do strony Manifesty przeglądarki Edge.

  2. Wybierz manifest wdrożenia, który chcesz zamienić.

  3. W oknie dialogowym Dostosowywanie przejdź do nowego pliku manifestu wdrożenia, aby przekazać lub wybrać istniejący manifest wdrożenia jako punkt początkowy. Usługa IoT Central weryfikuje wszystkie przekazane pliki.

  4. Wybierz Dalej. Na stronie Przeglądanie i kończenie są wyświetlane informacje o nowym manifeście wdrożenia i zdefiniowane przez niego moduły. Możesz również wyświetlić nieprzetworzone dane JSON.

  5. Wybierz pozycję Zapisz. Strona Manifesty usługi Edge zawiera teraz zaktualizowany manifest wdrożenia.

Zarządzanie urządzeniami usługi IoT Edge

Po dodaniu urządzenia usługi IoT Edge na stronie urządzeń można wybrać manifest wdrożenia dla urządzenia. W oknie dialogowym Tworzenie nowego urządzenia możesz wybrać z listy wcześniej przekazanych manifestów urządzeń na stronie Manifesty przeglądarki Edge. Istnieje również możliwość dodania manifestu wdrożenia bezpośrednio do urządzenia po utworzeniu urządzenia.

Jeśli dodasz urządzenie usługi IoT Edge, które nie jest przypisane do szablonu urządzenia, okno dialogowe Tworzenie nowego urządzenia będzie wyglądać jak na poniższym zrzucie ekranu:

Screenshot that shows adding an unassigned device to your application.

Aby wybrać manifest wdrożenia dla urządzenia:

  1. Przełącz urządzenie usługi Azure IoT Edge na wartość Tak.

  2. Wybierz manifest wdrożenia usługi IoT Edge do użycia. Możesz również przypisać manifest wdrożenia po utworzeniu urządzenia.

  3. Wybierz pozycję Utwórz.

Jeśli dodasz urządzenie usługi IoT Edge przypisane do szablonu urządzenia, okno dialogowe Tworzenie nowego urządzenia będzie wyglądać jak na poniższym zrzucie ekranu:

Screenshot that shows adding an assigned device to your application.

Aby wybrać manifest wdrożenia dla urządzenia:

  1. Przełącznik Azure IoT Edge jest już ustawiony na Wartość Tak , ponieważ usługa IoT Central rozpoznaje, że używasz szablonu urządzenia usługi IoT Edge.

  2. Wybierz manifest wdrożenia usługi IoT Edge do użycia. Możesz również przypisać manifest wdrożenia po utworzeniu urządzenia.

  3. Wybierz pozycję Utwórz.

Gdy urządzenie usługi IoT Edge łączy się z aplikacją po raz pierwszy, pobiera manifest wdrożenia, konfiguruje moduły określone w manifeście wdrożenia i uruchamia moduły.

Jeśli nie wybierzesz manifestu wdrożenia podczas tworzenia urządzenia usługi IoT Edge, możesz przypisać jeden później lub do wielu urządzeń przy użyciu zadania.

Aktualizowanie manifestu wdrożenia używanego przez urządzenie

Manifest wdrożenia dla istniejącego urządzenia można zarządzać:

Screenshot that shows the options to manage a deployment manifest on a device.

Użyj opcji Przypisz manifest krawędzi, aby wybrać wcześniej przekazany manifest wdrożenia ze strony manifestów usługi Edge. Możesz również użyć tej opcji, aby ręcznie powiadomić urządzenie, jeśli zmodyfikujesz manifest wdrożenia na stronie manifestów usługi Edge.

Użyj manifestu edycji, aby zmodyfikować manifest wdrożenia dla tego urządzenia. Wprowadzone tutaj zmiany nie mają wpływu na manifest wdrożenia na stronie manifestów przeglądarki Edge.

Stanowiska

Aby przypisać lub zaktualizować manifest wdrożenia dla wielu urządzeń, użyj zadania. Użyj typu zadania manifestu wdrożenia usługi Change edge:

Screenshot that shows the deployment manifest job type.

Dodawanie modułów i właściwości do szablonów urządzeń

Manifest wdrożenia definiuje moduły do uruchamiania na urządzeniu i opcjonalnie zapisywalne właściwości , których można użyć do konfigurowania modułów.

Jeśli przypisujesz szablon urządzenia do urządzenia usługi IoT Edge, możesz zdefiniować moduły i właściwości możliwe do zapisu w szablonie urządzenia. Aby dodać moduły i definicje właściwości do szablonu urządzenia:

  1. Przejdź do strony Podsumowanie modułów szablonu urządzenia usługi IoT Edge.
  2. Wybierz pozycję Importuj moduły z manifestu.
  3. Wybierz z listy odpowiedni manifest wdrożenia.
  4. Wybierz Importuj. Usługa IoT Central dodaje niestandardowe moduły zdefiniowane w manifeście wdrożenia do szablonu urządzenia. Nazwy modułów w szablonie urządzenia są zgodne z nazwami modułów niestandardowych w manifeście wdrożenia. Wygenerowany interfejs zawiera definicje właściwości dla właściwości zdefiniowanych dla modułu niestandardowego w manifeście wdrożenia:

Screenshot the shows importing module definitions to a device template.