Импорт обновления в службу Обновления устройств для Центра Интернета вещей

Узнайте, как получить обновление и импортировать его в службу Обновления устройств для Центра Интернета вещей. Если вы этого еще не сделали, обязательно ознакомьтесь с основными понятиями импорта и узнайте, как подготовить обновление к импорту.

Необходимые компоненты

• Доступ к Центр Интернета вещей с обновлением устройства для Центр Интернета вещей включен.
• Устройство Интернета вещей (или симулятор), подготовленное для службы Обновление устройств в Центре Интернета вещей.
• Выполните действия, описанные в разделе "Подготовка обновления для импорта в обновление устройства" для Центр Интернета вещей, чтобы создать манифест импорта для файлов обновления.

Портал Azure

Поддерживаемые браузеры:

• Microsoft Edge
• Google Chrome

Azure CLI

Среда интерфейса командной строки Azure:

• Используйте среду Bash в Azure Cloud Shell.

  

• Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI

  1. Выполните вход в Azure CLI с помощью команды az login.
  2. Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.
  3. При появлении запроса установите расширения Azure CLI при первом использовании. В командах в этой статье используется расширение azure-iot. Запустите az extension update --name azure-iot и убедитесь, что используется последняя версия расширения.

Совет

Команды Azure CLI в этой статье используют символ обратной косой черты \ для продолжения строки, чтобы аргументы команд были проще читать. Этот синтаксис работает в средах Bash. Если вы выполняете эти команды в PowerShell, замените каждую обратную косую черту обратной чертой "", или удалите их полностью.

Импорт обновлений

В этом разделе показано, как импортировать обновление с помощью портал Azure или Azure CLI. Для импорта обновления также можно использовать API-интерфейсы Обновления устройств для Центра Интернета вещей.

Чтобы импортировать обновление, сначала отправьте файлы обновления и импортируйте манифест в контейнер служба хранилища Azure. Затем вы импортируете обновление из служба хранилища Azure в обновление устройства для Центр Интернета вещей, где оно будет храниться для развертывания на устройствах.

Портал Azure

1. В портал Azure перейдите к Центр Интернета вещей с обновлением устройства.

2. В левой части страницы выберите Обновления в Управление устройствами.

   

3. Выберите вкладку Обновления в списке вкладок в верхней части экрана.

   

4. Выберите и импортируйте новое обновление под заголовком "Доступные Обновления".

   

5. Щелкните + Выбрать из контейнера хранилища. Отображается пользовательский интерфейс учетных записей хранения. Выберите существующую учетную запись или создайте учетную запись с помощью +служба хранилища учетной записи. Эта учетная запись используется в контейнере для размещения обновлений для импорта. Учетная запись не должна включать как общедоступные, так и частные конечные точки одновременно.

   

6. После выбора учетной записи хранения отображается пользовательский интерфейс контейнеров. Выберите существующий контейнер или создайте контейнер с помощью +Container. Этот контейнер используется для этапов обновления файлов для импорта

   Рекомендуется использовать новый контейнер при каждом импорте обновления. Всегда использовать новые контейнеры помогает избежать случайного импорта файлов из предыдущих обновлений. Если вы не используете новый контейнер, обязательно удалите файлы из существующего контейнера, прежде чем выполнить этот шаг.

   

7. В контейнере выберите "Отправить". Отобразится пользовательский интерфейс обновления.

   

8. Щелкните значок папки справа от раздела "Файлы " в заголовке "Отправка BLOB-объектов ". Используйте средство выбора файлов для перехода к расположению файлов обновления и манифеста импорта, выберите все файлы, а затем нажмите кнопку "Открыть". Можно выбрать несколько файлов, удерживая клавишу SHIFT.

   

9. Выбрав все файлы обновления, нажмите кнопку "Отправить".

   

10. Выберите отправленные файлы, чтобы указать, что они должны быть импортированы. Затем щелкните Выбрать, чтобы вернуться на страницу Импорт обновления.

    

11. На странице Импорт обновления проверьте импортируемые файлы. Затем щелкните Импорт обновления, чтобы начать процесс импорта. Сведения об устранении ошибок см. в разделе "Устранение неполадок с обновлением прокси-сервера".

    

12. Начнется процесс импорта, а на экране появится раздел Журнал импорта. Выберите "Обновить" , чтобы просмотреть ход выполнения до завершения процесса импорта (в зависимости от размера обновления процесс может завершиться через несколько минут, но может занять больше времени).

    

13. Если столбец "Состояние" указывает, что импорт выполнен успешно, выберите заголовок "Доступный Обновления". Импортированное обновление должно появиться в списке.

    

Azure CLI

Команда az iot du update stage обрабатывает необходимые действия по импорту обновления, включая отправку файлов обновления в целевой контейнер хранилища. Необязательный флаг также позволяет этой команде автоматически импортировать файлы после их подготовки. В противном случае команда импорта az iot du update завершает процесс.

Команда stage принимает следующие аргументы:

• --account: имя учетной записи обновления устройства.
• --instance: имя экземпляра обновления устройства.
• --manifest-path: путь к файлу манифеста импорта, который должен быть этапирован.
• --storage-account: имя учетной записи хранения для этапа обновления.
• --storage-container: имя контейнера в выбранной учетной записи хранения для этапа обновления.
• --overwrite: необязательный флаг, указывающий, следует ли перезаписать существующие большие двоичные объекты в контейнере хранилища, если есть конфликт.
• --then-import: необязательный флаг, указывающий, следует ли импортировать обновление в обновление устройства после его завершения.

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

Например:

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

Если у вас несколько манифестов импорта, их можно включить в одну команду. Например:

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

Если флаг не используется --then-import , выходные данные stage команды содержат запрос на запуск az iot du update import, включая предварительно заполненные аргументы.

Используйте az iot du update list , чтобы убедиться, что обновление или обновления успешно импортированы.

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

При импорте с помощью API вместо этого

Вы также можете импортировать обновление программным способом:

• Используя Azure SDK для .NET, Java, JavaScript или Python.
• Используя REST API импорта обновлений.
• Используя примеры модулей PowerShell.
  • Требуется PowerShell 5 или более поздней версии (включая установки Linux, macOS и Windows)

Примечание.

Сведения о требуемом разрешении API см. в разделе Роли пользователя и доступ к обновлению устройства.

Файлы обновления и манифест импорта должны быть отправлены в контейнер Azure Storage Blob для промежуточного хранения. Чтобы импортировать промежуточные файлы, укажите URL-адрес большого двоичного объекта или подписанный URL-адрес (SAS) для частных больших двоичных объектов в API обновления устройства. Если используется SAS, обязательно предоставьте срок действия в течение трех часов или более

Совет

Чтобы передать большие файлы обновления в контейнер Azure Storage Blob, можно использовать один из следующих способов для повышения производительности:

• AzCopy
• Обозреватель службы хранилища Azure

Next Steps

• Создание групп
• Сведения о понятиях импорта