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

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

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

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

Развертывание обновления

В этом разделе описывается развертывание обновления с помощью портал Azure или Azure CLI.

Портал Azure

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

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

   

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

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

   

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

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

7. В списке справа выберите требуемое обновление для развертывания.

   

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

   Совет

   По умолчанию дата и время запуска — это 24 часа начиная от текущего времени. Не забудьте выбрать другую дату и время, если вы хотите, чтобы развертывание началось раньше или позже.

   

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

10. На вкладке "Текущие обновления" можно просмотреть состояние развертывания.

    

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

    После успешного обновления устройства диаграмма соответствия требованиям и сведения о развертывании обновляются, чтобы отразить это состояние.

Azure CLI

Для выполнения следующих команд можно использовать среду 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, замените каждую обратную косую черту обратной чертой или удалите их полностью.

Проверка доступности обновлений

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

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

2. Затем используйте az iot du device group show для отображения наиболее доступных обновлений для группы. Команда принимает следующие аргументы:

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

   Чтобы проверить наилучшее доступное обновление для группы, выполните следующую команду:

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

Создание развертывания

Используется az iot du 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-versionпараметры обновления, используемые при запуске отката.

Выполните следующую команду:

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>

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

• Развертывания обновлений устройств
• Руководство по устранению неполадок с обновлением устройств