Criar recursos da Atualização de Dispositivo para Hub IoT

Para começar a usar a Atualização de Dispositivo, crie uma conta e uma instância de Atualização de Dispositivo e depois defina funções de controle de acesso.

Uma conta de Atualização de Dispositivo é um recurso criado na sua assinatura do Azure. Uma instância de Atualização de Dispositivo é um contêiner lógico dentro de uma conta associada a um hub IoT específico. Uma instância contém atualizações e implantações associadas ao respectivo hub IoT. Você pode criar várias instâncias dentro de uma conta. Para obter mais informações, confira a Recursos da Atualização de Dispositivo.

Pré-requisitos

Azure portal

Um hub IoT. É obrigatório usar uma camada S1 (Standard) ou posterior.

CLI do Azure

• Um hub IoT. É obrigatório usar uma camada S1 (Standard) ou posterior.

• Um ambiente da CLI do Azure:

  • Use o ambiente Bash no Azure Cloud Shell.

    

  • Ou, se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure

    • Entre na CLI do Azure usando o comando az login.

    • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

    • Quando solicitado, instale as extensões da CLI do Azure no primeiro uso. Os comandos neste artigo usam a extensão azure-iot. Execute az extension update --name azure-iot para verificar se está usando a versão mais recente da extensão.

Criar uma conta e uma instância

Azure portal

1. No portal do Azure, selecione Criar um recurso e pesquise "Atualização de Dispositivo para Hub IoT"

2. Selecione Criar>Atualização de Dispositivo para Hub IoT

   

3. Na guia Noções básicas, forneça as seguintes informações para a conta e a instância de Atualização de Dispositivo:

   • Assinatura: a assinatura do Azure que será associada à conta de Atualização de Dispositivo.
   • Grupo de recursos: um grupo de recursos existente ou novo.
   • Nome: um nome para sua conta.
   • Local: a região do Azure em que sua conta estará localizada. Para obter informações sobre quais regiões dão suporte à Atualização de Dispositivo para Hub IoT, consulte a página de produtos do Azure por região.
   • Marque a caixa para atribuir a função de administrador da Atualização de Dispositivo a si mesmo. Use também as etapas listadas na seção Configurar funções de controle de acesso a fim de fornecer uma combinação de funções para usuários e aplicativos para o nível certo de acesso. Você precisa de permissões de Administrador de Acesso do Usuário ou Proprietário em sua assinatura para gerenciar funções.
   • Nome da instância: um nome para sua instância.
   • Nome do Hub IoT: selecione o Hub IoT que deseja vincular à instância de Atualização de Dispositivo
   • Marque a caixa para conceder o acesso correto à entidade de serviço de Atualização de Dispositivo do Azure no Hub IoT a fim de configurar e operar o Serviço de Atualização de Dispositivo. Você precisa ter as permissões corretas para adicionar acesso.

   Observação

   Se não conseguir conceder acesso à entidade de serviço de Atualização de Dispositivo do Azure durante a criação do recurso, consulte configurar o controle de acesso para usuários e a entidade de serviço de Atualização de Dispositivo do Azure. Se esse acesso não estiver definido, você não poderá executar operações de implantação, gerenciamento de dispositivos e diagnóstico. Saiba mais sobre o acesso à entidade de serviço da Atualização de Dispositivo do Azure.

   

4. Selecione Avançar: diagnóstico. Habilitar o diagnóstico da Microsoft dá à Microsoft permissão para coletar, armazenar e analisar os arquivos de log de diagnóstico de seus dispositivos quando eles encontrarem uma falha de atualização. Para habilitar a coleta remota de logs para diagnóstico, você precisa vincular sua instância de Atualização de Dispositivo à sua conta de armazenamento de blobs do Azure. A seleção da conta de Armazenamento do Microsoft Azure atualizará automaticamente os detalhes de armazenamento.

   

5. Na guia Sistema de rede, para continuar criando a conta e a instância de Atualização de Dispositivo. Escolha os pontos de extremidade que podem ser usados pelos dispositivos na conexão com sua instância de Atualização de Dispositivo. Aceite a configuração padrão, Acesso público, para esse exemplo.

   

6. Selecione Avançar: Examinar + Criar. Após a validação, selecione Criar.

   

7. Você verá que a implantação está em andamento. O status da implantação mudará para "concluído" em alguns minutos. Quando for concluída, selecione Ir para o recurso

CLI do Azure

Use o comando az iot du account create para criar uma nova conta de Atualização de Dispositivo.

Substitua os espaços reservados a seguir com suas próprias informações:

• <resource_group>: um grupo de recursos existente em sua assinatura.

• <account_name>: um nome para sua conta de Atualização de Dispositivo.

• <region>: a região do Azure em que sua conta estará localizada. Para obter informações sobre quais regiões dão suporte à Atualização de Dispositivo para Hub IoT, consulte a página de produtos do Azure por região. Se nenhuma região for fornecida, o local do grupo de recursos será usado.

  Observação

  Sua conta de Atualização de Dispositivo não precisa estar na mesma região que seus hubs IoT, mas para um melhor desempenho, é recomendável mantê-los geograficamente próximos.

az iot du account create --resource-group <resource_group> --account <account_name> --location <region>

Use o comando az iot du instance create para criar uma instância de Atualização de Dispositivo.

Uma instância de Atualização de Dispositivo é associada a um único hub IoT. Selecione o hub IoT que será usado com Atualização de Dispositivo. Quando você vincula um hub IoT a uma instância da Atualização de Dispositivo, uma nova política de acesso compartilhado é criada automaticamente, fornecendo permissões de Atualização de Dispositivo para trabalhar com Hub IoT (gravação do registro e conexão de serviço). Essa política garante que o acesso seja limitado apenas à Atualização de Dispositivo.

Substitua os espaços reservados a seguir com suas próprias informações:

• <account_name>: o nome da conta de Atualização de Dispositivo à qual essa instância será associada.
• <instance_name>: um nome para esta instância.
• <iothub_id>: a ID do recurso para o hub IoT que será vinculado a essa instância. A ID do recurso do hub IoT pode ser recuperada usando o comando az iot hub show e consultando o valor da ID: az iot hub show -n <iothub_name> --query id.

az iot du instance create --account <account_name> --instance <instance_name> --iothub-ids <iothub_id>

Dica

Como parte do processo de criação da instância, você também pode configurar o log de diagnósticos. Para obter mais informações, consulte Coletar logs de diagnóstico de dispositivos remotamente.

Próximas etapas

Depois de criar o recurso da Atualização de Dispositivo, configure o controle de acesso para usuários e a entidade de serviço da Atualização de Dispositivo do Azure.

Ou saiba mais sobre contas e instâncias de Atualização de Dispositivo ou funções de controle de acesso da Atualização de Dispositivo.