Solucionar problemas de nuvem e implantação
Há dois tipos main de possíveis problemas associados à nuvem e implantações: problemas de interação com comandos de azsphere dependentes da nuvem e problemas com dispositivos que não são atualizados.
Solucionar problemas de comandos da CLI de nuvem
Quando você usa comandos azsphere dependentes de nuvem, o Serviço de Segurança do Azure Sphere executa operações em nome da CLI (interface de linha de comando). Para evitar expor informações sobre locatários, usuários ou dispositivos individuais e, portanto, arriscar um vazamento de informações, o Serviço de Segurança, em alguns casos, retorna uma mensagem de erro geral, que o comando azsphere passa para você.
Aqui estão algumas dicas gerais de solução de problemas para diagnosticar e resolver esses erros.
Se você tiver erros de logon intermitente no Windows, especialmente com uma conta pessoal da Microsoft, tente usar a opção --use-device-code no logon e siga as instruções nos prompts:
azsphere login --use-device-code
Essa opção tem suporte no SDK do Windows, versão 20.04 Atualização 2 e posterior.
Se um comando dependente de nuvem falhar, primeiro marcar o comando em si:
- Você especificou os parâmetros certos?
- Se o comando incluir a ID de um dispositivo, grupo de dispositivos ou outro item, você tem certeza de que é a id correta?
- Você está tentando criar um grupo de dispositivos, um produto ou outro item que já existe? Os nomes de produtos devem ser exclusivos dentro de um locatário. Os nomes de grupo de dispositivos devem ser exclusivos dentro de um produto e não são confidenciais para maiúsculas de minúsculas.
Em seguida, marcar sua identidade de logon e locatário:
- Você entrou no Azure Sphere com uma identidade de logon válida?
- Você está acessando o locatário correto?
- Você alterou sua identidade de logon? Cada identidade deve ser registrada no Azure Sphere e deve ter uma função atribuída no locatário. Se você alterar seu logon, por exemplo, alterando seu endereço de email, você não deve usar apenas o registro do azsphere --novo usuário para registrar a nova identidade de logon, você também deve garantir que a nova identidade seja atribuída a uma função.
Verifique seu dispositivo:
- Alguns comandos exigem que um dispositivo esteja conectado ao computador.
Por fim, verifique se sua função de usuário no locatário concede permissão para executar a operação:
- Se o comando gravar qualquer dado, você deverá ser um Colaborador ou Administrador. Os leitores não podem gravar dados, portanto, não podem criar locatários, grupos de dispositivos ou produtos, adicionar ou excluir recursos do dispositivo, carregar pacotes de imagem ou executar qualquer outra ação que altere as informações armazenadas no locatário ou no dispositivo.
Solucionar problemas de atualizações de dispositivo
As atualizações no ar são uma parte importante do modelo de segurança do Azure Sphere. Problemas podem surgir com atualizações de sistema operacional e atualizações de implantação.
Solucionar problemas de atualizações do sistema operacional
Para que um dispositivo receba atualizações do sistema operacional, o dispositivo deve estar conectado à Internet. Se seu dispositivo parece estar executando uma versão desatualizada do sistema operacional do Azure Sphere, verifique sua conexão com a Internet conforme descrito em Solucionar problemas de rede.
Se o dispositivo estiver executando um sistema operacional anterior a 21.04, todas as imagens de configuração de placa carregadas no dispositivo também deverão ser carregadas na conta de nuvem do locatário ao qual o dispositivo é reivindicado.
O sideload de uma configuração de placa em um dispositivo permite a configuração inicial da ethernet. No entanto, para dispositivos que executam um sistema operacional pré-21.01, se essa imagem de configuração de placa não estiver incluída na implantação, o dispositivo será impedido de executar quaisquer atualizações. Isso ocorre porque essa configuração resultaria em remover a configuração do painel do dispositivo e potencialmente perder a conectividade com a Internet. Se isso ocorreu em um de seus dispositivos, você deve carregar a imagem de configuração do quadro original para a conta de nuvem do locatário ao qual o dispositivo é reivindicado.
Solucionar problemas de atualizações de implantação
Para que um dispositivo obtenha atualizações de implantação , tudo isso deve ser verdadeiro:
- Ele deve estar conectado à Internet. Se você suspeitar que seu dispositivo não está conectado à Internet, confira Solucionar problemas de rede.
- Ele não deve ter a funcionalidade de desenvolvimento do aplicativo.
- Ele deve ser reivindicado em um locatário.
- Ele deve pertencer a um grupo de dispositivos.
- O grupo de dispositivos ao qual ele pertence deve ser direcionado por uma implantação.
- A implantação deve conter imagens de aplicativo (e, opcionalmente, uma imagem de configuração de quadro) criada por ou em nome de sua organização.
- O grupo de dispositivos deve ter a política UpdateAll update.
O Azure Sphere dá suporte a um único locatário por dispositivo. Isso significa que sua organização controla todas as imagens do cliente implantadas em seus dispositivos.
A remoção do recurso de desenvolvimento do aplicativo remove todas as imagens sideload que não estão assinadas pela produção.
Problemas ao reivindicar um dispositivo
Um dispositivo pode ser reivindicado apenas uma vez. Uma vez reivindicado, o dispositivo está permanentemente associado ao locatário do Azure Sphere. Se um erro for relatado ao reivindicar seu dispositivo para um locatário, um dos seguintes pode ser a causa:
- Verifique se você está usando um dispositivo não reclamado que não foi usado anteriormente para criar um locatário.
- Verifique se você tem as permissões certas para executar o comando de declaração de dispositivo do azsphere no locatário selecionado do Azure Sphere.
- No caso raro de o dispositivo do Azure Sphere não ter sido registrado durante a fabricação, entre em contato com seu representante da Microsoft para registrá-lo corretamente. Para obter mais informações, consulte Reivindicar o chip.