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

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

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

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

• Устройство Интернета вещей или симулятор , подготовленный для обновления устройств в Центре Интернета вещей.

• Обновите файлы для устройства и связанный файл манифеста импорта, созданный в соответствии с инструкциями по подготовке обновления для импорта в обновление устройства.

• Учетная запись служба хранилища Azure и контейнер для хранения импортированных файлов. Кроме того, вы можете создать новую учетную запись хранения и контейнер в рамках процесса импорта на основе портал Azure.

  Внимание

  Убедитесь, что используемая или созданная учетная запись хранения не включает частные конечные точки. Чтобы узнать, включены ли частные конечные точки, можно проверить имя учетной записи служба хранилища Azure в частных конечных точках в центре Приватный канал.

Портал Azure

• Поддерживаемые браузеры Microsoft Edge или Google Chrome.

Azure CLI

• Среда Bash.

  Среду Bash в Azure Cloud Shell можно использовать для выполнения команд, приведенных в этой статье. Выберите "Запустить Cloud Shell", чтобы открыть Cloud Shell, или щелкните значок Cloud Shell на верхней панели инструментов портал Azure.

  

  Или, если вы предпочитаете, вы можете выполнять команды Azure CLI локально:

  1. Установка Azure CLI. Запустите az version , чтобы просмотреть установленную версию Azure CLI и зависимые библиотеки, а затем запустите az upgrade , чтобы установить последнюю версию.
  2. Войдите в Azure, выполнив команду az login.
  3. 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. На странице контейнера нажмите кнопку "Отправить".

   

7. На экране "Отправить большой двоичный объект" щелкните значок папки рядом с файлом. Используйте средство выбора файлов для перехода к расположению файлов обновления и импорта файлов манифеста, выберите файлы и нажмите кнопку "Открыть". С помощью клавиши SHIFT можно использовать многопользовательские файлы.

   

8. После выбора всех файлов нажмите кнопку "Отправить".

   

9. После отправки файлы отображаются на странице контейнера. На странице контейнера просмотрите и выберите файлы для импорта, а затем нажмите кнопку "Выбрать".

   

10. На экране "Импорт обновления" выберите "Импортировать обновление".

    

Начинается процесс импорта, а экран переключается на экран "Обновления ". После успешного выполнения импорта на вкладке "Обновления ". Сведения об устранении ошибок см. в разделе "Устранение неполадок с обновлением прокси-сервера".

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 обновления устройства

Вы также можете импортировать обновление программным способом с помощью любого из следующих методов:

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

Примечание.

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

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

Совет

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

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

Связанный контент

• Группы устройств
• Манифест импорта обновления устройства