Řešení potíží s cloudem a nasazením
Důležité
Toto je dokumentace k Azure Sphere (starší verze). Azure Sphere (starší verze) se vyřazuje 27. září 2027 a uživatelé musí do této doby migrovat do Azure Sphere (integrované). K zobrazení dokumentace k Azure Sphere (integrované) použijte selektor verzí umístěný nad obsahem.
Existují dva hlavní typy potenciálních problémů spojených s cloudem a nasazeními: problémy při interakci s příkazy azsphere závislými na cloudu a problémy se zařízeními, která se neaktualizuje.
Řešení potíží s příkazy cloudových rozhraní příkazového řádku
Pokud používáte příkazy azsphere závislé na cloudu, služba zabezpečení Azure Sphere provádí operace jménem rozhraní příkazového řádku (CLI). Aby se v některých případech zabránilo zveřejnění informací o jednotlivých tenantech, uživatelích nebo zařízeních a riskování úniku informací, vrátí služba zabezpečení v některých případech obecnou chybovou zprávu, kterou vám příkaz azsphere projde.
Tady je několik obecných tipů pro řešení potíží pro diagnostiku a řešení těchto chyb.
Pokud ve Windows dochází k přerušovaným chybám přihlášení, zejména u osobního účtu Microsoft, zkuste použít --use-device-code
možnost při přihlášení a postupujte podle pokynů v výzev:
azsphere login --use-device-code
Tato možnost je podporována v sadě Windows SDK verze 20.04 Update 2 a novější.
Pokud příkaz závislý na cloudu selže, nejprve zkontrolujte samotný příkaz:
- Zadali jste správné parametry?
- Pokud příkaz obsahuje ID zařízení, skupiny zařízení nebo jiné položky, jste si jistí, že se jedná o správné ID?
- Pokoušíte se vytvořit skupinu zařízení, produkt nebo jinou položku, která už existuje? Názvy produktů musí být v rámci tenanta jedinečné. Názvy skupin zařízení musí být jedinečné v rámci produktu a nerozlišují malá a velká písmena.
Dále zkontrolujte svou přihlašovací identitu a tenanta:
- Jste přihlášení k Azure Sphere pomocí platné přihlašovací identity?
- Přistupujete ke správnému tenantovi?
- Změnili jste svoji přihlašovací identitu? Každá identita musí být zaregistrovaná v Azure Sphere a musí mít přiřazenou roli v rámci tenanta. Pokud změníte své přihlašovací jméno – například změnou e-mailové adresy – musíte nejen zaregistrovat novou identitu, ale také zajistit, aby nová identita byla přiřazena roli.
Zkontrolujte zařízení:
- Některé příkazy vyžadují, aby bylo zařízení připojené k počítači.
Nakonec se ujistěte, že vaše role uživatele v tenantovi uděluje oprávnění k provedení operace:
- Pokud příkaz zapisuje nějaká data, musíte být přispěvatelem nebo správcem. Čtenáři nemůžou zapisovat data, takže nemůžou vytvářet tenanty, skupiny zařízení ani produkty, přidávat nebo odstraňovat funkce zařízení, nahrávat balíčky obrázků nebo provádět jakoukoli jinou akci, která změní informace uložené v tenantovi nebo na zařízení.
Chyba registrace uživatele
Pokud se pokoušíte použít příkaz azsphere register-user, zobrazí se chybová zpráva, protože tento příkaz je zastaralý. K registraci uživatele byste měli použít alternativní mechanismy.
Řešení potíží s aktualizacemi zařízení
Aktualizace nad vzduchem jsou důležitou součástí modelu zabezpečení Azure Sphere. Problémy můžou nastat s aktualizacemi operačního systému i aktualizacemi nasazení.
Řešení potíží s aktualizacemi operačního systému
Aby zařízení přijímalo aktualizace operačního systému, musí být zařízení připojené k internetu. Pokud se zdá, že vaše zařízení používá zastaralou verzi operačního systému Azure Sphere, ověřte připojení k internetu, jak je popsáno v tématu Řešení potíží se sítí.
Pokud zařízení používá operační systém starší než 21.04, musí být všechny konfigurační image panelu načtené do zařízení také načtené do cloudového účtu tenanta, na který je zařízení nárokované.
Zkušební načtení konfigurace desky na zařízení umožňuje počáteční konfiguraci ethernetu. U zařízení s operačním systémem před verzí 21.01 však v případě, že tato image konfigurace panelu nebyla součástí nasazení, zabránilo se zařízení v provádění jakýchkoli aktualizací. Důvodem je to, že tato konfigurace by vedlo k odebrání konfigurace panelu ze zařízení a potenciálně ke ztrátě připojení k internetu. Pokud k tomu došlo u některého z vašich zařízení, musíte nahrát původní konfigurační image panelu do cloudového účtu tenanta, na který je zařízení nárokované.
Řešení potíží s aktualizacemi nasazení
Aby zařízení získalo aktualizace nasazení , musí být splněné všechny následující podmínky:
- Musí být připojen k internetu. Pokud máte podezření, že vaše zařízení není připojené k internetu, přečtěte si téma Řešení potíží se sítí.
- Nesmí mít schopnost vývoje aplikací.
- Musí být nárokované do tenanta.
- Musí patřit do skupiny zařízení.
- Skupina zařízení, do které patří, musí být cílem nasazení.
- Nasazení musí obsahovat image aplikací (a volitelně image konfigurace panelu) vytvořené vaší organizací nebo jménem vaší organizace.
- Skupina zařízení musí mít zásadu aktualizace UpdateAll.
Azure Sphere podporuje jednoho tenanta na zařízení. To znamená, že vaše organizace řídí všechny image zákazníků nasazené na vaše zařízení.
Odebráním funkce vývoje aplikace se odeberou všechny image s zkušebním načtením, které nejsou podepsané v produkčním prostředí.
Problémy s deklarací zařízení
Zařízení lze nárokovat pouze jednou. Po deklarace je zařízení trvale přidružené k tenantovi Azure Sphere. Pokud se při deklaraci zařízení do tenanta zobrazí chyba, může to být jedna z následujících příčin:
- Zkontrolujte, že používáte nezařazené zařízení, které nebylo dříve použito k vytvoření tenanta.
- Zkontrolujte, jestli máte správná oprávnění ke spuštění příkazu azsphere device claim ve vybraném tenantovi Azure Sphere.
- Ve výjimečných událostech, kdy vaše zařízení Azure Sphere nebylo během výroby zaregistrované, obraťte se na zástupce Microsoftu a požádejte ho, aby se správně zaregistroval. Další informace najdete v tématu Deklarace čipu.