Importowanie aktualizacji do usługi Device Update dla usługi IoT Hub

Dowiedz się, jak uzyskać nową aktualizację i zaimportować ją do usługi Device Update dla usługi IoT Hub. Jeśli jeszcze tego nie zrobiono, zapoznaj się z kluczowymi pojęciami dotyczącymi importu i sposobami przygotowania aktualizacji do zaimportowania.

Wymagania wstępne

• Dostęp do usługi IoT Hub z włączoną aktualizacją urządzenia dla usługi IoT Hub.

• Kontener usługi Azure Storage bez włączonego prywatnego punktu końcowego.

  • Jeśli nie masz pewności, czy prywatny punkt końcowy jest włączony, przejdź do centrum usługi Private Link, wybierz pozycję "Prywatne punkty końcowe" po lewej stronie, a następnie wyszukaj nazwę konta usługi Azure Storage w kolumnie "Zasoby".

• Urządzenie IoT (lub symulator) aprowizowane na potrzeby aktualizacji urządzenia w usłudze IoT Hub.

• Wykonaj kroki opisane w temacie Przygotowywanie aktualizacji do zaimportowania do usługi Device Update for IoT Hub , aby utworzyć manifest importu dla plików aktualizacji.

Witryna Azure Portal

Obsługiwane przeglądarki:

• Microsoft Edge
• Google Chrome

Interfejs wiersza polecenia platformy Azure

Środowisko interfejsu wiersza polecenia platformy Azure:

• Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell.

  

• Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure

  1. Zaloguj się do interfejsu wiersza polecenia platformy Azure przy użyciu polecenia az login .
  2. Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.
  3. Po wyświetleniu monitu zainstaluj rozszerzenia interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Polecenia w tym artykule używają rozszerzenia azure-iot . Uruchom polecenie az extension update --name azure-iot , aby upewnić się, że używasz najnowszej wersji rozszerzenia.

Napiwek

Polecenia interfejsu wiersza polecenia platformy Azure w tym artykule używają znaku ukośnika \ odwrotnego do kontynuacji wiersza, dzięki czemu argumenty poleceń są łatwiejsze do odczytania. Ta składnia działa w środowiskach powłoki Bash. Jeśli uruchamiasz te polecenia w programie PowerShell, zastąp każdy ukośnik odwrotny tekstem "" lub usuń je całkowicie.

Importowanie aktualizacji

W tej sekcji pokazano, jak zaimportować aktualizację przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure. Możesz również użyć aktualizacji urządzenia dla interfejsów API usługi IoT Hub, aby zaimportować aktualizację.

Aby zaimportować aktualizację, należy najpierw przekazać pliki aktualizacji i zaimportować manifest do kontenera usługi Azure Storage. Następnie zaimportujesz aktualizację z usługi Azure Storage do usługi Device Update dla usługi IoT Hub, gdzie będzie ona przechowywana do wdrożenia na urządzeniach.

Witryna Azure Portal

1. W witrynie Azure Portal przejdź do centrum IoT Hub za pomocą usługi Device Update.

2. Po lewej stronie wybierz pozycję Aktualizacje w obszarze Zarządzanie urządzeniami.

   

3. Wybierz kartę Aktualizacje z listy kart w górnej części ekranu.

   

4. Wybierz pozycję + Zaimportuj nową aktualizację poniżej nagłówka Dostępne aktualizacje .

   

5. Wybierz pozycję + Wybierz z kontenera magazynu. Zostanie wyświetlony interfejs użytkownika kont magazynu. Wybierz istniejące konto lub utwórz konto przy użyciu konta + Storage. To konto jest używane dla kontenera do przygotowania aktualizacji do importowania. Konto nie powinno mieć jednocześnie włączonych publicznych i prywatnych punktów końcowych.

   

6. Po wybraniu konta magazynu zostanie wyświetlony interfejs użytkownika kontenerów. Wybierz istniejący kontener lub utwórz kontener przy użyciu polecenia + Kontener. Ten kontener służy do przygotowania plików aktualizacji do importowania

   Zalecamy używanie nowego kontenera za każdym razem, gdy importujesz aktualizację. Zawsze używaj nowych kontenerów, aby uniknąć przypadkowego importowania plików z poprzednich aktualizacji. Jeśli nie używasz nowego kontenera, przed wykonaniem tego kroku usuń wszystkie pliki z istniejącego kontenera.

   

7. W kontenerze wybierz pozycję Przekaż. Zostanie wyświetlony interfejs użytkownika przekazywania.

   

8. Wybierz ikonę folderu po prawej stronie sekcji Pliki w nagłówku Przekaż obiekt blob . Użyj selektora plików, aby przejść do lokalizacji plików aktualizacji i zaimportować manifest, wybrać wszystkie pliki, a następnie wybrać pozycję Otwórz. Możesz trzymać Shift i kliknąć, aby wybrać wiele plików.

   

9. Po wybraniu wszystkich plików aktualizacji wybierz pozycję Przekaż.

   

10. Wybierz przekazane pliki, aby wyznaczyć je do zaimportowania. Następnie wybierz przycisk Wybierz, aby powrócić do strony Importuj aktualizację.

    

11. Na stronie Importowanie aktualizacji przejrzyj pliki do zaimportowania. Następnie wybierz pozycję Importuj aktualizację , aby rozpocząć proces importowania. Aby rozwiązać problemy z błędami, zobacz Rozwiązywanie problemów z aktualizacją serwera proxy.

    

12. Rozpoczyna się proces importowania, a ekran przechodzi do sekcji Historia importu. Wybierz pozycję Odśwież , aby wyświetlić postęp do momentu zakończenia procesu importowania (w zależności od rozmiaru aktualizacji proces może zakończyć się w ciągu kilku minut, ale może potrwać dłużej).

    

13. Gdy kolumna Stan wskazuje, że importowanie zakończyło się pomyślnie, wybierz nagłówek Dostępne aktualizacje . Zaimportowana aktualizacja powinna być teraz widoczna na liście.

    

Interfejs wiersza polecenia platformy Azure

Polecenie az iot du update stage obsługuje kroki wymagań wstępnych importowania aktualizacji, w tym przekazywanie plików aktualizacji do docelowego kontenera magazynu. Opcjonalna flaga umożliwia również automatyczne importowanie plików po ich przygotowaniu. W przeciwnym razie polecenie az iot du update import kończy proces.

Polecenie stage przyjmuje następujące argumenty:

• --account: Nazwa konta usługi Device Update.
• --instance: nazwa wystąpienia usługi Device Update.
• --manifest-path: ścieżka pliku do manifestu importu, który powinien zostać przygotowany.
• --storage-account: nazwa konta magazynu do przygotowania aktualizacji.
• --storage-container: nazwa kontenera na wybranym koncie magazynu do przygotowania aktualizacji.
• --overwrite: opcjonalna flaga wskazująca, czy zastąpić istniejące obiekty blob w kontenerze magazynu, jeśli wystąpi konflikt.
• --then-import: opcjonalna flaga wskazująca, czy aktualizacja powinna zostać zaimportowana do usługi Device Update po jej przeprowadzeniu.

az iot du update stage \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    --manifest-path <Replace with the full path to your import manifest> \
    --storage-account <Replace with your Storage account name> \
    --storage-container <Replace with your container name> \
    --overwrite --then-import

Na przykład:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/file.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Jeśli masz wiele manifestów importu, możesz uwzględnić je wszystkie w jednym poleceniu. Na przykład:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/parent.importmanifest.json \
    --manifest-path /my/apt/manifest/child1.importmanifest.json \
    --manifest-path /my/apt/manifest/child2.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Jeśli nie używasz flagi --then-import , dane wyjściowe stage polecenia zawierają monit o uruchomienie polecenia az iot du update import, w tym wstępnie wypełnionych argumentów.

Użyj polecenia az iot du update list , aby sprawdzić, czy aktualizacja lub aktualizacje zostały pomyślnie zaimportowane.

az iot du update list \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    -o table

W przypadku importowania przy użyciu interfejsów API

Aktualizację można również zaimportować programowo, wykonując następujące czynności:

• Używanie Azure SDK dla platform .NET, Java, JavaScript lub Python
• Korzystanie z interfejsu API REST importu aktualizacji
• Korzystanie z przykładowych modułów programu PowerShell
  • Wymaga programu PowerShell 5 lub nowszego (w tym instalacji systemu Linux, macOS i Windows)

Uwaga

Aby uzyskać wymagane uprawnienia interfejsu API, zapoznaj się z artykułem Device update user roles and access (Aktualizowanie urządzeń i uzyskiwanie dostępu do użytkowników).

Pliki aktualizacji i manifest importu muszą zostać przekazane do kontenera obiektów blob usługi Azure Storage na potrzeby przemieszczania. Aby zaimportować pliki etapowe, podaj adres URL obiektu blob lub sygnaturę dostępu współdzielonego (SAS) dla prywatnych obiektów blob do interfejsu API aktualizacji urządzenia. Jeśli używasz sygnatury dostępu współdzielonego, upewnij się, że w oknie wygaśnięcia jest co najmniej trzy godziny

Napiwek

Aby przekazać duże pliki aktualizacji do kontenera obiektów blob usługi Azure Storage, możesz użyć jednego z następujących elementów w celu uzyskania lepszej wydajności:

• AzCopy
• Eksplorator usługi Azure Storage

Następne kroki

• Tworzenie grup
• Dowiedz się więcej o pojęciach dotyczących importowania