Создание развертывания
Внимание
Это документация по Azure Sphere (устаревшая версия). Служба Azure Sphere (устаревшая версия) выходит на пенсию 27 сентября 2027 г., и к этому времени пользователи должны перейти в Azure Sphere (интегрированная). Используйте селектор версий, расположенный над toC, чтобы просмотреть документацию по Azure Sphere (интегрированная).
Чтобы развернуть приложения из облака, отправьте образы этих приложений в клиент Azure Sphere и создайте развертывание, которое распространит эти образы на устройствах Azure Sphere. Чтобы создать развертывание, необходимо войти в Azure Sphere от имени администратора. Кроме того, устройства должны быть подготовлены к получению облачных развертываний.
Примечание.
У каждого компонента в развертывании должен быть уникальный идентификатор GUID. Если приложение основано на примере Azure Sphere, перед созданием развертывания обязательно создайте для своего приложения уникальный идентификатор GUID, чтобы избежать возможных конфликтов.
Подготовка устройств
Прежде чем устройства смогут получать приложения из облака, им нужно присвоить продукт и внести их в группу устройств, а компонент AppDevelopment должен отсутствовать.
Если вы еще не создали продукт для своих устройств, это необходимо сделать перед созданием развертывания. Чтобы создать продукт, сделайте следующее.
azsphere product create --name <product-name>
Замените <имя продукта именем> вашего продукта, например DW100. См. дополнительные сведения о команде azsphere product.
Развертывание нацеливается на группы устройств, поэтому вам потребуется назначить устройства в группу устройств, в которой разрешены обновления из облака, чтобы устройства смогли получить развернутые приложения. По умолчанию каждый продукт имеет пять групп устройств: рабочая, рабочая, проверка полей, разработка, оценка ОС для тестирования полей и оценка рабочей ОС. Вы можете использовать любую из этих групп устройств или создать собственную. Чтобы узнать, поддерживает ли конкретная группа устройств облачные обновления, используйте команду azsphere device-group show.
Кроме того, устройства должны быть подготовлены для загрузки из облака, а значит на них должен отсутствовать компонент appDevelopment. При отгрузке с завода устройства не содержат этот компонент. Но если вы ранее использовали устройство для разработки приложений, скорее всего, вы добавили эту возможность с помощью команды azsphere device enable-development (в более ранних выпусках пакета SDK — azsphere device prep-debug).
Чтобы удалить этот компонент, выполните команду azsphere device enable-cloud-test.
azsphere device enable-cloud-test --device-group <device-group-ID> or '<product-name>/<device-group-name>'
Параметр --device-group определяет группу устройств. Идентификатор группы устройств предоставляет GUID, который однозначно определяет группу устройств во всех продуктах. Кроме того, можно использовать пару имен продукта и группы устройств в <формате product-name>/<device-group-name> . Эта пара имен однозначно определяет группу устройств для конкретного продукта. Дополнительные сведения см. в разделе "Создание развертывания".
Создание развертывания для группы устройств
Развертывания могут содержать как приложения, так и конфигурации плат, и оба этих варианта при создании развертывания обрабатываются одинаково. Развертывания представляют собой наборы образов, которые будут распространяться на все устройства в группе устройств. Каждое развертывание связано с определенной группой устройств в пределах определенного продукта. При создании развертывания нужно указать имя продукта и группы устройств (как показано в следующем примере) или идентификатор группы устройств.
Чтобы создать развертывание, выполните приведенные действия.
Отправьте пакет образа:
azsphere image add --image <path-to-image> --regional-data-boundary <value>Создайте новое развертывание для группы устройств:
azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>or
azsphere device-group deployment create '<product-name>/<device-group-name>' --images <image-ID>
Чтобы указать несколько значений для ввода списка значений, --images разделенных пробелами.
Параметр --device-group определяет группу устройств. Идентификатор группы устройств предоставляет GUID, который однозначно определяет группу устройств во всех продуктах. Кроме того, можно использовать пару имен продукта и группы устройств в <формате product-name>/<device-group-name> . Эта пара имен однозначно определяет группу устройств для конкретного продукта.
Параметр --images предоставляет идентификатор образа файла пакета образа для приложения. Этот образ загружается в текущий клиент.
Параметр --regional-data-boundary задает границу региональных данных для этого изображения. Допустимые значения — EU и None. Значение по умолчанию — None. Если значение не указано, будет использоваться значение по умолчанию.
Например:
azsphere image add --image my-app.imagepackage --regional-data-boundary "None"
azsphere device-group deployment create --device-group "DW100/Field Test" --images e3769536-dc4b-48d9-afd4-22ed321ba4bc
Правила для допустимого развертывания
Чтобы быть допустимым, развертывание должно соответствовать следующим правилам:
- Общий размер развертывания должен быть меньше 1 МиБ.
- Развертывание может иметь не более одного файла конфигурации платы.
Обновление развертывания
Чтобы обновить развертывание, используйте команду azsphere image add и azsphere device-group deployment create commands, как описано в предыдущем разделе, и укажите путь к обновленному файлу приложения.