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

Aby wdrożyć aktualizację na urządzeniach przy użyciu usługi Azure Device Update dla usługi IoT Hub, najpierw zaimportuj pliki aktualizacji do usługi Device Update, która przechowuje zaimportowaną aktualizację do wdrożenia na urządzeniach. Z tego artykułu dowiesz się, jak zaimportować aktualizację do usługi Device Update przy użyciu witryny Azure Portal, interfejsu wiersza polecenia platformy Azure lub interfejsów API aktualizacji urządzeń.

Wymagania wstępne

• Konto i wystąpienie usługi Device Update skonfigurowane za pomocą centrum IoT Hub.

• Urządzenie IoT lub symulator aprowizowany na potrzeby aktualizacji urządzenia w centrum IoT.

• Zaktualizuj pliki dla urządzenia i skojarzony plik manifestu importu utworzony zgodnie z instrukcjami w temacie Przygotowywanie aktualizacji do zaimportowania do usługi Device Update.

• Konto usługi Azure Storage i kontener do przechowywania zaimportowanych plików. Możesz też utworzyć nowe konto magazynu i kontener w ramach procesu importowania opartego na witrynie Azure Portal.

  Ważne

  Upewnij się, że używane konto magazynu lub utworzone nie ma włączonych prywatnych punktów końcowych. Aby sprawdzić, czy prywatne punkty końcowe są włączone, możesz sprawdzić nazwę konta usługi Azure Storage w obszarze Prywatne punkty końcowe w Centrum usługi Private Link.

Witryna Azure Portal

• Obsługiwane przeglądarki Microsoft Edge lub Google Chrome.

Interfejs wiersza polecenia platformy Azure

• Środowisko powłoki Bash.

  Aby uruchomić polecenia w tym artykule, możesz użyć środowiska powłoki Bash w usłudze Azure Cloud Shell . Wybierz pozycję Uruchom usługę Cloud Shell, aby otworzyć usługę Cloud Shell , lub wybierz ikonę usługi Cloud Shell na górnym pasku narzędzi witryny Azure Portal.

  

  Jeśli wolisz, możesz uruchamiać polecenia interfejsu wiersza polecenia platformy Azure lokalnie:

  1. Zainstaluj interfejs wiersza polecenia platformy Azure. Uruchom polecenie az version , aby wyświetlić zainstalowaną wersję interfejsu wiersza polecenia platformy Azure i biblioteki zależne, a następnie uruchom polecenie az upgrade , aby zainstalować najnowszą wersję.
  2. Zaloguj się na platformie Azure, uruchamiając polecenie az login.
  3. azure-iot Zainstaluj rozszerzenie po wyświetleniu monitu o pierwsze użycie. Aby upewnić się, że używasz najnowszej wersji rozszerzenia, uruchom polecenie az extension update --name azure-iot.

Napiwek

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

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ż zaimportować aktualizację przy użyciu interfejsów API aktualizacji urządzeń.

Aby zaimportować aktualizację, należy najpierw przekazać aktualizacje i zaimportować pliki manifestu 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, która przechowuje ją do wdrożenia na urządzeniach.

Witryna Azure Portal

1. W witrynie Azure Portal na stronie centrum IoT Hub dla wystąpienia usługi Device Update wybierz pozycję Aktualizacje zarządzania urządzeniami>w obszarze nawigacji po lewej stronie.

   

2. Na stronie Aktualizacje wybierz pozycję Importuj nową aktualizację.

   

3. Na stronie Importowanie aktualizacji wybierz pozycję Wybierz z kontenera magazynu.

4. Na stronie Konta magazynu wybierz istniejące konto magazynu lub utwórz nowe konto, wybierając pozycję Konto magazynu. Konto magazynu dla kontenera służy do przygotowania plików aktualizacji.

5. Na stronie Kontenery wybierz istniejący kontener lub utwórz nowy kontener, wybierając pozycję Kontener. Kontener służy do przygotowania plików aktualizacji do importowania.

   

   Napiwek

   Użycie nowego kontenera za każdym razem, gdy importujesz aktualizację, pomaga zapobiec przypadkowemu zaimportowaniu plików z poprzednich aktualizacji. Jeśli nie używasz nowego kontenera, usuń wszystkie poprzednie pliki z istniejącego kontenera.

6. Na stronie kontenera wybierz pozycję Przekaż.

   

7. Na ekranie Przekazywanie obiektu blob wybierz ikonę folderu obok pozycji Pliki. Użyj selektora plików, aby przejść do lokalizacji aktualizacji i zaimportować pliki manifestu, wybrać pliki, a następnie wybrać pozycję Otwórz. Możesz użyć Shift, aby wybrać wiele plików.

   

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

   

9. Po przekazaniu pliki są wyświetlane na stronie kontenera. Na stronie kontenera przejrzyj i wybierz pliki do zaimportowania, a następnie wybierz pozycję Wybierz.

   

10. Na ekranie Importowanie aktualizacji wybierz pozycję Importuj aktualizację.

    

Rozpoczyna się proces importowania, a ekran przechodzi do ekranu Aktualizacje . Po pomyślnym zakończeniu importowania zostanie wyświetlony na karcie Aktualizacje . Aby rozwiązać problemy z błędami, zobacz Rozwiązywanie problemów z aktualizacją serwera proxy.

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 do etapu.
• --storage-account: nazwa konta magazynu do przygotowania aktualizacji do.
• --storage-container: nazwa kontenera na wybranym koncie magazynu do przygotowania aktualizacji do.
• --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 należy zaimportować aktualizację do usługi Device Update po jej przejściu.

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

W jednym poleceniu można uwzględnić wiele manifestów importu. 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 z wstępnie wypełnionymi argumentami.

Użyj polecenia az iot du update list , aby sprawdzić, czy 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

Importowanie przy użyciu interfejsów API aktualizacji urządzeń

Aktualizację można również zaimportować programowo przy użyciu dowolnej z następujących metod:

• Interfejsy API aktualizacji urządzeń w zestawach AZURE SDK dla platformy .NET, Java, JavaScript lub Python
• Interfejs API REST usługi Device Update Import Update
• Przykładowe moduły programu PowerShell (wymaga programu PowerShell 5 lub nowszego dla systemów Linux, macOS lub Windows)

Uwaga

Zobacz Role użytkownika aktualizacji urządzeń i dostęp, aby uzyskać wymagane uprawnienia interfejsu API.

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. W przypadku korzystania z 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ć jednej z następujących metod w celu uzyskania lepszej wydajności:

• AzCopy
• Eksplorator usługi Azure Storage

Powiązana zawartość

• Grupy urządzeń
• Manifest importu usługi Device Update