Criar Atualização de Dispositivo do Azure para recursos do Hub IoT

Para começar a usar a Atualização de Dispositivo do Azure para o Hub IoT, crie uma conta e uma instância da Atualização de Dispositivo e, em seguida , atribua funções de controle de acesso e permissões necessárias para usar esses recursos. Este artigo descreve como criar e configurar os recursos de Atualização de Dispositivo usando o portal do Azure ou a CLI do Azure.

Uma conta de Atualização de Dispositivo é um recurso em sua assinatura do Azure. Uma instância de Atualização de Dispositivo é um contêiner lógico dentro da conta associado a um hub IoT específico. Você pode criar várias instâncias de Atualização de Dispositivo em uma conta.

Uma instância de Atualização de Dispositivo contém atualizações e implantações associadas ao seu hub IoT. Para obter mais informações, consulte Recursos de atualização de dispositivo.

Pré-requisitos

Portal do Azure

• Uma instância Standard (S1) ou superior do Hub IoT do Azure.
• Se você optar por armazenar logs de diagnóstico, uma conta de Armazenamento do Azure para armazenar logs de diagnóstico para sua instância de Atualização de Dispositivo.

CLI do Azure

• Uma instância Standard (S1) ou superior do Hub IoT do Azure.

• O ambiente Bash no Azure Cloud Shell para executar comandos da CLI do Azure. Selecione Iniciar o Cloud Shell para abrir o Cloud Shell agora ou selecione o ícone do Cloud Shell na barra de ferramentas superior do portal do Azure.

  

  Se preferir, você pode executar os comandos da CLI do Azure localmente:

  1. Instalar a CLI do Azure. Execute az version para ver a versão instalada da CLI do Azure e as bibliotecas dependentes e execute az upgrade para instalar a versão mais recente.
  2. Entre no Azure executando az login.
  3. Instale a azure-iot extensão quando solicitado na primeira utilização. Para se certificar de que está a utilizar a versão mais recente da extensão, execute az extension update --name azure-iot.

Criar uma conta e uma instância de Atualização de Dispositivo

Portal do Azure

1. No portal do Azure, procure e selecione Atualização de Dispositivo para Hubs IoT.

2. Na tela Atualização de Dispositivo para Hubs IoT, selecione Criar ou Criar Atualização de Dispositivo para Hub IoT.

   

3. Na guia Noções básicas da tela Criar atualização de dispositivo, forneça as seguintes informações:

   • Assinatura: selecione o nome da assinatura do Azure para sua conta de Atualização de Dispositivo.
   • Grupo de recursos: selecione um grupo de recursos existente ou crie um novo.
   • Nome: forneça um nome para a sua conta de Atualização de Dispositivo.
   • Local: selecione a região do Azure para sua conta. Para obter mais informações, veja Produtos disponíveis por região.
   • SKU: Selecione Padrão.
   • Conceder acesso à conta
     • Se você tiver permissões de Proprietário ou Administrador de Acesso de Usuário em sua assinatura do Azure, poderá marcar a caixa de seleção Atribuir função de Administrador de Atualização de Dispositivo para atribuir a si mesmo a função de Administrador de Atualização de Dispositivo para essa conta.
     • Se você não tiver essas permissões, entre em contato com o administrador após a criação do recurso para obter as permissões necessárias para trabalhar com esses recursos. Para obter mais informações, consulte Configurar funções de controle de acesso para recursos de Atualização de Dispositivo.
   • Nome da instância: forneça um nome para sua instância de Atualização de Dispositivo.
   • Nome do Hub IoT: selecione o Hub IoT que você deseja vincular à sua instância de Atualização de Dispositivo.
   • Conceder acesso ao Hub IoT: a configuração da Atualização de Dispositivo atribui automaticamente a função de Colaborador de Dados do Hub IoT à entidade de serviço de Atualização de Dispositivo.

   

4. Opcionalmente, selecione Avançar: Diagnóstico ou a guia Diagnóstico para configurar o log de diagnóstico como parte do processo de criação da instância. A habilitação do diagnóstico da Microsoft permite que a Microsoft colete, armazene e analise arquivos de log de diagnóstico de seus dispositivos se eles encontrarem uma falha de atualização.

   Se você não quiser habilitar o log de diagnóstico agora, selecione a guia Rede .

5. Para configurar o log de diagnóstico, na guia Diagnóstico , deslize o botão para Log de diagnóstico da Microsoft Habilitado.

6. Selecione Selecionar Conta de Armazenamento do Azure e, em seguida, selecione uma conta de armazenamento de Blob do Azure para vincular à sua instância de Atualização de Dispositivo para coleta de log de diagnóstico remoto. Os detalhes da conta de armazenamento são atualizados automaticamente.

   

7. Selecione a guia Rede ou Avançar: Rede.

8. Na guia Rede, você pode escolher os pontos de extremidade que os dispositivos usam para se conectar à sua instância de Atualização de Dispositivo. Para este exemplo, selecione Acesso público. O acesso público é aceitável para fins de desenvolvimento e teste, mas para cenários de produção, você deve escolher Acesso privado e configurar conexões de ponto de extremidade privadas.

9. Selecionar Rever.

   

10. Na guia Revisão, revise os detalhes e, quando a validação for aprovada, selecione Criar.

    

11. A tela é alterada para mostrar que sua implantação está em andamento. Quando a implantação for concluída, selecione Ir para o recurso.

CLI do Azure

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

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

   No comando, substitua os seguintes espaços reservados por suas próprias informações:

   • <resource_group>: Um grupo de recursos existente na sua subscrição.

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

   • <region>: A região do Azure para sua conta. Para obter mais informações, veja Produtos disponíveis por região. Se você não fornecer uma região, a instalação usará o local do grupo de recursos.

     Nota

     Sua conta de Atualização de Dispositivo não precisa estar na mesma região que seu hub IoT, mas para um melhor desempenho ela deve estar geograficamente próxima.

2. Se solicitado, responda y para instalar a extensão da CLI do azure-iot Azure.

3. Uma instância de Atualização de Dispositivo está associada a um único hub IoT. Execute az iot du instance create para criar uma instância de Atualização de Dispositivo e especifique o hub IoT a ser usado com a instância.

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

   No comando, substitua os seguintes espaços reservados por suas próprias informações:

   • <account_name>: O nome da conta de Atualização de Dispositivo para esta instância.

   • <instance_name>: Um nome para este exemplo.

   • <iothub_id>: O ID de recurso totalmente qualificado para o hub IoT a ser vinculado a esta instância, como "/subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.Devices/IotHubs/<iothub_name>".

     Para obter seu ID de recurso do hub IoT, execute az iot hub show e consulte o valor do ID.

     az iot hub show -n <iothub_name> --query id
     

Você também pode configurar o log de diagnóstico como parte do processo de criação da instância. Você deve ter uma conta de Armazenamento de Blob do Azure para armazenar os logs de diagnóstico. Para obter mais informações, consulte Coletar remotamente logs de diagnóstico de dispositivos.

Próximos passos

A configuração da Atualização de Dispositivo atribui automaticamente a função de Colaborador de Dados do Hub IoT à entidade de serviço de Atualização de Dispositivo. Essa função permite que apenas essa instância de Atualização de Dispositivo se conecte e grave no hub IoT vinculado para executar a implantação de atualização, o gerenciamento de dispositivos e as operações de diagnóstico.

Se você tiver permissões de Proprietário ou Administrador de Acesso de Usuário em sua assinatura do Azure, poderá configurar o controle de acesso fornecendo aos usuários e aplicativos o nível necessário de acesso aos recursos de Atualização de Dispositivo que você criou. Se não tiver permissões de Proprietário ou Administrador de Acesso de Utilizador, peça ao administrador de Atualização de Dispositivo para lhe conceder o acesso e as permissões de que necessita para executar operações de atualização, gestão e diagnóstico da Atualização de Dispositivo . Para obter mais informações, consulte Configurar funções de controle de acesso para recursos de Atualização de Dispositivo.

Conteúdos relacionados

• Contas e instâncias de Atualização de Dispositivo
• Funções de controle de acesso de Atualização de Dispositivo