Развертывание обновления с помощью службы "Обновление устройств для Центра Интернета вещей Azure"

Сведения о том, как развернуть обновление на устройстве Интернета вещей с помощью службы "Обновление устройств для Центра Интернета вещей Azure".

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

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

Портал 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

1. Найдите нужный Центр Интернета вещей на портале Azure.

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

   

3. Щелкните вкладку Группы и Развертывания в верхней части страницы. Дополнительные сведения см. в разделе "Группы устройств".

   

4. Просмотр диаграммы соответствия обновлений и списка групп. Вы увидите новое обновление, доступное для группы тегов или по умолчанию. Возможно, потребуется выполнить обновление один раз. Дополнительные сведения см. в разделе "Соответствие обновлению устройств".

5. Выберите "Развернуть рядом с одним или несколькими доступными обновлениями" и убедитесь, что описательная метка, которую вы добавили при импорте, и выглядит правильно.

6. Убедитесь, что правильная группа выбрана в качестве целевой группы и выберите "Развернуть".

7. Чтобы начать развертывание, перейдите на вкладку "Текущее развертывание ". Щелкните ссылку "Развернуть " рядом с нужным обновлением из раздела "Доступные обновления ". Наилучшее доступное обновление для указанной группы обозначается как Лучшее.

   

8. Запланируйте запуск развертывания немедленно или в будущем.

   Совет

   По умолчанию для даты и времени начала задано значение "Немедленно". Если вы хотите начать развертывание, обязательно выберите другую дату и время.

   

9. При необходимости создайте политику автоматического отката. Затем выберите Создать.

10. В сведениях о развертывании состояние становится активным. Развернутое обновление помечается как (развертывается).

    

11. Просмотрите схему соответствия, чтобы убедиться, что обновление выполняется.

    

12. После успешного обновления устройства схема соответствия и сведения о развертывании должны измениться, отражая одну и ту же информацию.

    

Azure CLI

Проверка az iot du device group list наилучшего доступного обновления для вашей группы. Команда принимает следующие аргументы:

• --account: имя учетной записи обновления устройства.
• --instance: имя экземпляра обновления устройства.
• --group-id: идентификатор группы устройств, предназначенный для этого развертывания. Этот идентификатор является значением тега ADUGroup или $default для устройств без тега.
• --best-updates: этот флаг указывает, что команда должна получить наилучшие доступные обновления для группы устройств, включая количество устройств, требующих каждого обновления.
• "-resource-group -g": имя группы ресурсов обновления устройства.
• "--update-compliance": этот флаг указывает, что команда должна получить сведения о соответствии группы устройств, например количество устройств в последнем обновлении, сколько требуется новых обновлений и сколько выполняется при получении нового обновления.

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>\
    --gid <device group id>\
    --best-updates {false, true}

Используйте az iot du device deployment create для создания развертывания для группы устройств.

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

• --account: имя учетной записи обновления устройства.
• --instance: имя экземпляра обновления устройства.
• --group-id: идентификатор группы устройств, предназначенный для этого развертывания. Этот идентификатор является значением тега ADUGroup или $default для устройств без тега.
• --deployment-id: идентификатор для идентификации этого развертывания.
• --update-name, --update-providerи --update-version: эти три параметра определяют объект updateId , который является уникальным идентификатором для обновления, используемого в этом развертывании.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version>

Необязательные аргументы позволяют настроить развертывание. Полный список см. в разделе "Необязательные параметры"

Если вы хотите создать политику автоматического отката, добавьте следующие параметры:

• --failed-count: количество неудачных устройств в развертывании, которое активирует откат.
• --failed-percentage: процент неудачных устройств в развертывании, который активирует откат.
• --rollback-update-name, : --rollback-update-provider--rollback-update-versionupdateID для обновления, которое группа устройств будет использовать при запуске отката.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --failed-count 10 \
    --failed-percentage 5 \
    --rollback-update-name <rollback update name> \
    --rollback-update-provider <rollback update provider> \
    --rollback-update-version <rollback update version>

Если вы хотите, чтобы развертывание началось в будущем, используйте --start-time параметр, чтобы предоставить целевое время даты и времени развертывания.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --start-time "2022-12-20T01:00:00"

Слежение за развертыванием обновления

Портал Azure

1. Выберите группу, в которую вы развернули, и перейдите на вкладку "Текущие обновления " или "Журнал развертывания", чтобы убедиться, что развертывание выполняется.

   

2. Выберите Сведения рядом с созданным развертыванием. Здесь можно просмотреть сведения о развертывании, сведения об обновлении и сведения о целевом классе устройств. При необходимости можно добавить понятное имя для класса устройства.

   

3. Щелкните Обновить, чтобы просмотреть последние данные о состоянии.

4. Вы можете перейти в представление "Основы группы", чтобы искать состояние определенного устройства или фильтровать для просмотра устройств, которые завершились сбоем развертывания.

Azure CLI

Используйте az iot du device deployment list для просмотра всего развертывания для группы устройств.

az iot du device deployment list \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id>

Используйте az iot du device deployment show для просмотра сведений о конкретном развертывании.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID>

--status Добавьте флаг для возврата сведений о том, сколько устройств в развертывании выполняется, завершено или завершилось сбоем.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --status

Повторная попытка развертывания обновления

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

Портал Azure

1. Перейдите на вкладку Текущее развертывание на экране Сведения о группе .

   

2. Выберите Повторить попытку для устройств в состоянии сбоя и подтвердите уведомление.

Azure CLI

Используйте az iot du device deployment retry , чтобы повторить развертывание для целевой подгруппы устройств.

Эта команда принимает --class-id аргумент, который создается из идентификатора модели и свойств совместимости, сообщаемых агентом обновления устройства.

az iot du device deployment retry \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --deployment-id <deployment ID> \
    --group-id <device group ID> \
    --class-id <device class ID>

Следующие шаги

Устранение общих проблем