Criar atualização de dispositivo para recursos do Hub IoT

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

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 de uma conta associada a um hub IoT específico. Uma instância contém atualizações e implantações associadas ao seu hub IoT. Você pode criar várias instâncias em uma conta. Para obter mais informações, consulte Recursos de atualização de dispositivo.

Pré-requisitos

Portal do Azure

Um hub IoT. É necessário que você use uma camada S1 (Padrão) ou superior.

CLI do Azure

• Um hub IoT. É necessário que você use uma camada S1 (Padrão) ou superior.

• Um ambiente da CLI do Azure:

  • Use o ambiente Bash no Azure Cloud Shell.

    

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

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

    • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

    • Quando solicitado, instale as extensões da CLI do Azure na primeira utilização. Os comandos neste artigo usam a extensão azure-iot . Execute az extension update --name azure-iot para se certificar de que está a utilizar a versão mais recente da extensão.

Criar uma conta e uma instância

Portal do Azure

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

2. Selecione Criar>atualização de dispositivo para o Hub IoT

   

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

   • Assinatura: a assinatura do Azure a ser associada à sua conta de Atualização de Dispositivo.
   • Grupo de recursos: um grupo de recursos novo ou existente.
   • Nome: um nome para a sua conta.
   • Local: a região do Azure onde sua conta estará localizada. Para obter informações sobre quais regiões oferecem suporte à Atualização de Dispositivo para o Hub IoT, consulte a página Produtos do Azure por região.
   • Marque a caixa para atribuir a função de administrador de Atualização de Dispositivo a si mesmo. Você também pode usar as etapas listadas na seção Configurar funções de controle de acesso para fornecer uma combinação de funções a usuários e aplicativos para o nível certo de acesso. Você precisa ter permissões de Proprietário ou Administrador de Acesso de Usuá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 você deseja vincular à sua instância de Atualização de Dispositivo
   • Marque a caixa para conceder o acesso certo à entidade de serviço de Atualização de Dispositivo do Azure no Hub IoT para configurar e operar o Serviço de Atualização de Dispositivo. Você precisa ter as permissões certas para adicionar acesso.

   Nota

   Se você não conseguir conceder acesso à entidade de serviço de Atualização de Dispositivo do Azure durante a criação de recursos, 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 principal ao serviço de Atualização de Dispositivo do Azure.

   

4. Selecione Next: Diagnostics. Habilitando o diagnóstico da Microsoft, dá à Microsoft permissão para coletar, armazenar e analisar 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 Blob do Azure. Selecionar a conta de Armazenamento do Azure atualizará automaticamente os detalhes do armazenamento.

   

5. Na guia Rede, para continuar criando a conta e a instância da Atualização de Dispositivo. Escolha os pontos de extremidade que os dispositivos podem usar para se conectar à sua instância de Atualização de Dispositivo. Aceite a configuração padrão, Acesso público, para este exemplo.

   

6. Selecione Seguinte: Rever + Criar. Após a validação, selecione Criar.

   

7. Você verá que sua implantação está em andamento. O status da implantação mudará para "concluído" em alguns minutos. Quando isso acontecer, 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 seguintes espaços reservados pelas 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 onde sua conta estará localizada. Para obter informações sobre quais regiões oferecem suporte à Atualização de Dispositivo para o Hub IoT, consulte a página Produtos do Azure por região. Se nenhuma região for fornecida, o local do grupo de recursos será usado.

  Nota

  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 está associada a um único hub IoT. Selecione o hub IoT que será usado com a Atualização de Dispositivo. Quando você vincula um hub IoT a uma instância de Atualização de Dispositivo, uma nova política de acesso compartilhado é criada automaticamente, dando permissões de Atualização de Dispositivo para trabalhar com o Hub IoT (gravação de registro e conexão de serviço). Esta política garante que o acesso seja limitado apenas à Atualização de Dispositivo.

Substitua os seguintes espaços reservados pelas suas próprias informações:

• <account_name>: O nome da conta de Atualização de Dispositivo à qual esta instância será associada.
• <instance_name>: Um nome para este exemplo.
• <iothub_id>: A ID do recurso para o hub IoT que será vinculado a esta instância. Você pode recuperar seu ID de recurso do hub IoT usando o comando az iot hub show e consultando o valor de 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>

Gorjeta

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

Próximos passos

Depois de criar seus recursos de Atualização de Dispositivo, configure o controle de acesso para usuários e a entidade de serviço de 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 de Atualização de Dispositivo.