Устранение проблем с облаком и развертыванием
Внимание
Это документация по Azure Sphere (устаревшая версия). Служба Azure Sphere (устаревшая версия) выходит на пенсию 27 сентября 2027 г., и к этому времени пользователи должны перейти в Azure Sphere (интегрированная). Используйте селектор версий, расположенный над toC, чтобы просмотреть документацию по Azure Sphere (интегрированная).
Существует два основных типа потенциальных проблем, связанных с облаком и развертываниями: проблемы, взаимодействующие с облачными командами azsphere и проблемами с устройствами, которые не обновляются.
Устранение неполадок с командами cloud CLI
При использовании команд azsphere, зависящих от облака, служба безопасности Azure Sphere выполняет операции от имени интерфейса командной строки (CLI). Чтобы не передавать сведений об отдельных клиентах, пользователях и (или) устройствах и, соответственно, снизить вероятность утечки информации, служба безопасности в некоторых случаях возвращает общее сообщение об ошибке, которое команда azsphere передает вам.
Ниже приведены некоторые общие советы по устранению неполадок, позволяющие диагностировать и устранять такие ошибки.
Если в Windows возникают периодические ошибки входа, особенно с личной учетной записью Майкрософт, попробуйте использовать --use-device-code
параметр для входа и следуйте инструкциям в запросах:
azsphere login --use-device-code
Этот параметр поддерживает Windows SDK версии 20.04 с обновлением 2 и более поздних версий.
В случае сбоя команды, связанной с облаком, прежде всего проверьте саму команду:
- Правильно ли указаны параметры команды?
- Если команда содержит идентификатор устройства, группы устройств или другого элемента, правильно ли указан этот идентификатор?
- Возможно, вы пытаетесь создать уже существующую группу устройств, продукт или другой элемент? Имена продуктов должны быть уникальными в пределах клиента. Имена групп устройств обрабатываются без учета регистра и должны быть уникальными в пределах клиента.
Затем проверьте идентификатор входа и клиент:
- Выполнен ли вход в Azure Sphere, и правильно ли указан идентификатор?
- Правильно ли указан клиент для обращения?
- Не изменялся ли недавно идентификатор входа? Каждый идентификатор должен быть зарегистрирован в Azure Sphere, и вам должна быть назначена роль в клиенте. Если изменить имя входа (например, изменив адрес электронной почты), необходимо не только зарегистрировать новое удостоверение, то необходимо также убедиться, что новое удостоверение назначено роли.
Теперь проверьте устройство.
- Для некоторых команд необходимо, чтобы устройство было подключено к компьютеру.
Наконец, убедитесь, что ваша роль пользователя в клиенте дает права на выполнение нужной операции.
- Если при использовании команды записываются какие-либо данные, вам нужна роль участника или администратора. Читатели не могут записывать данные, а значит, не могут создавать клиенты, группы устройств или продукты, добавлять или удалять возможности устройства, отправлять пакеты образов и выполнять любые другие действия, которые изменяют данные, хранящиеся в клиенте или на устройстве.
Ошибка регистрации пользователя
Если вы пытаетесь использовать команду azsphere register-user, вы увидите сообщение об ошибке, так как эта команда устарела. Для регистрации пользователя следует использовать альтернативные механизмы.
Устранение неполадок с обновлениями устройств
Обновления через воздух являются важной частью модели безопасности Azure Sphere. Проблемы могут возникнуть как с обновлениями ОС, так и с обновлениями развертывания.
Устранение неполадок с обновлениями ОС
Для получения обновлений ОС устройство должно быть подключено к Интернету. Если ваше устройство, как представляется, работает устаревшая версия ОС Azure Sphere, проверьте подключение к Интернету, как описано в разделе "Устранение проблем с сетью".
Если устройство работает с ОС ранее 21.04, все образы конфигурации доски, загруженные на устройство, также должны быть загружены в облачную учетную запись клиента, на которое утверждается устройство.
Загрузка неопубликованной конфигурации платы на устройство позволяет начальной конфигурации Ethernet. Однако для устройств, работающих до версии 21.01, если этот образ конфигурации платы не был включен в развертывание, устройство было запрещено выполнять какие-либо обновления. Это связано с тем, что эта конфигурация приведет к удалению конфигурации платы с устройства и потенциально потеряет подключение к Интернету. Если это произошло на одном из ваших устройств, необходимо передать исходный образ конфигурации доски в облачную учетную запись клиента, к которой утверждается устройство.
Устранение неполадок с обновлениями развертывания
Для получения обновлений развертывания устройство должно иметь значение true:
- Он должен быть подключен к Интернету. Если вы подозреваете, что устройство не подключено к Интернету, см. статью "Устранение неполадок сети".
- У него не должна быть возможность разработки приложений.
- Его необходимо запросить в клиенте.
- Он должен принадлежать группе устройств.
- Группа устройств, к которой она принадлежит, должна быть нацелена на развертывание.
- Развертывание должно содержать образы приложений (и при необходимости образ конфигурации платы), созданные или от имени вашей организации.
- Группа устройств должна иметь политику обновления UpdateAll.
Azure Sphere поддерживает один клиент на каждое устройство. Это означает, что ваша организация управляет всеми образами клиентов, развернутыми на ваших устройствах.
При удалении возможности разработки приложений удаляются все неопубликованные образы, которые не подписаны в рабочей среде.
Проблемы с утверждением устройства
Устройство можно запросить только один раз. После утверждения устройство связанно с клиентом Azure Sphere на постоянной основе. Если при утверждении устройства клиенту сообщается об ошибке, одна из следующих причин может быть причиной:
- Убедитесь, что вы используете неисключаемое устройство, которое ранее не использовалось для создания клиента.
- Убедитесь, что у вас есть правильные разрешения на выполнение команды утверждения azsphere device в выбранном клиенте Azure Sphere.
- В редких случаях, когда устройство Azure Sphere не зарегистрировано во время производства, обратитесь к представителю Майкрософт, чтобы правильно зарегистрировать устройство. Дополнительные сведения см. в разделе "Утверждение микросхемы".