Partilhar via

Solucionar problemas de nuvem e implantação

  • Artigo

Importante

Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (Integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).

Existem dois tipos principais de problemas potenciais associados à nuvem e às implantações: problemas de interação com comandos azsphere dependentes da nuvem e problemas com dispositivos que não são atualizados.

Solucionar problemas de comandos da CLI na nuvem

Quando você usa comandos azsphere dependentes da nuvem, o Serviço de Segurança do Azure Sphere executa operações em nome da interface de linha de comando (CLI). Para evitar expor informações sobre locatários, usuários ou dispositivos individuais e, assim, 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 login intermitentes no Windows, especialmente com uma conta pessoal da Microsoft, tente usar a --use-device-code opção no login e siga as instruções nos prompts:

azsphere login --use-device-code

Esta opção é suportada no SDK do Windows, versão 20.04 Update 2 e posterior.

Se um comando dependente da nuvem falhar, primeiro verifique o próprio comando:

  • Especificaram 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, produto ou outro item que já existe? Os nomes dos produtos devem ser exclusivos dentro de um locatário. Os nomes de grupos de dispositivos devem ser exclusivos dentro de um produto e não diferenciam maiúsculas de minúsculas.

Em seguida, verifique sua identidade de login e locatário:

  • Você está conectado ao Azure Sphere com uma identidade de logon válida?
  • Você está acessando o locatário correto?
  • Alterou a sua identidade de login? Cada identidade deve ser registrada no Azure Sphere e deve ter uma função atribuída dentro do locatário. Se alterar o seu início de sessão, por exemplo, alterando o seu endereço de e-mail, deve não só registar a nova identidade, mas também garantir que lhe é atribuída uma função.

Verifique o seu dispositivo:

  • Alguns comandos requerem que um dispositivo esteja ligado ao computador.

Por fim, certifique-se de que sua função de usuário no locatário conceda permissão para executar a operação:

  • Se o comando gravar quaisquer dados, 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 imagens ou executar qualquer outra ação que altere as informações armazenadas no locatário ou no dispositivo.

Erro de registro-usuário

Se você estiver tentando usar o comando azsphere register-user, verá uma mensagem de erro, pois esse comando foi preterido. Deve utilizar mecanismos alternativos para registar um utilizador.

Solucionar problemas de atualizações de dispositivos

As atualizações over-the-air são uma parte importante do modelo de segurança do Azure Sphere. Podem surgir problemas com as atualizações do SO e com as atualizações de implementação.

Solucionar problemas de atualizações do sistema operacional

Para que um dispositivo receba atualizações do SO, tem de estar ligado à Internet. Se o seu dispositivo parecer estar executando uma versão desatualizada do sistema operacional 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 à 21.04, todas as imagens de configuração da placa carregadas no dispositivo também devem ser carregadas na conta na nuvem do locatário ao qual o dispositivo é reivindicado.

O sideloading 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 da placa não foi incluída na implantação, o dispositivo foi impedido de executar quaisquer atualizações. Isso ocorre porque essa configuração resultaria na remoção da configuração da placa do dispositivo e potencialmente perderia a conectividade com a Internet. Se isso tiver ocorrido em um de seus dispositivos, você deverá carregar a imagem de configuração original da placa para a conta na 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 , todos os itens a seguir devem ser verdadeiros:

  • Deve estar conectado à internet. Se suspeitar que o seu dispositivo não está ligado à Internet, consulte Resolução de problemas de rede.
  • Ele não deve ter a capacidade de desenvolvimento de aplicativos.
  • Deve ser reclamado a um inquilino.
  • 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 aplicativos (e, opcionalmente, uma imagem de configuração de quadro) criadas por ou em nome da sua organização.
  • O grupo de dispositivos deve ter a política de atualização UpdateAll.

O Azure Sphere dá suporte a um único locatário por dispositivo. Isso significa que sua organização controla todas as imagens de clientes que são implantadas em seus dispositivos.

A remoção do recurso de desenvolvimento de aplicativos remove todas as imagens de sideload que não são assinadas de produção.

Problemas ao reivindicar um dispositivo

Um dispositivo só pode ser reivindicado uma vez. Uma vez reivindicado, o dispositivo é permanentemente associado ao locatário do Azure Sphere. Se for reportado um erro ao reclamar o seu dispositivo a um inquilino, uma das seguintes situações poderá ser a causa:

  • Verifique se você está usando um dispositivo não reivindicado que não foi usado anteriormente para criar um locatário.
  • Verifique se você tem as permissões certas para executar o comando azsphere device claim no locatário selecionado do Azure Sphere.
  • No caso raro de seu dispositivo 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.