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

Para começar a usar a Atualização de Dispositivo, você precisará criar uma conta e uma instância de Atualização de Dispositivo e, em seguida, definir funções de controle de acesso.

Pré-requisitos

Azure portal

Um hub IoT. É recomendável usar uma camada S1 (Standard) ou posterior.

CLI do Azure

• Um hub IoT. É recomendável 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 conta e instância da Atualização de Dispositivo

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 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.

   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.

   

4. Opcionalmente, você pode marcar 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.

5. Selecione Próximo: instância

   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.

6. Na guia Instância, forneça as seguintes informações para a instância de Atualização de Dispositivo:

   • Nome: um nome para sua instância.
   • Detalhes do Hub IoT: selecione um hub IoT para vincular a essa instância.

   

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

   

8. 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 device-update account create para criar uma 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 device-update account create --resource-group <resource_group> --account <account_name> --location <region>

Use o comando az iot device-update 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 device-update 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.

Configurar funções de controle de acesso para Atualização de Dispositivo

Para que outros usuários tenham acesso à Atualização de Dispositivo, é necessário conceder acesso a esse recurso a eles. Ignore esta etapa se tiver atribuído a função Administrador da Atualização de Dispositivo a si mesmo durante a criação da conta e não precisar fornecer acesso a outros usuários ou aplicativos.

Azure portal

1. Em sua conta de Atualização de Dispositivo, selecione Controle de acesso (IAM) no menu de navegação.

   

2. Selecione Adicionar atribuições de função.

3. Na guia Função, selecione uma função da Atualização de Dispositivo entre as opções disponíveis:

   • Administrador de Atualização de Dispositivo
   • Leitor de Atualização de Dispositivo
   • Administrador de Conteúdo de Atualização de Dispositivo
   • Leitor de Conteúdo de Atualização de Dispositivo
   • Administrador de Implantações de Atualização de Dispositivo
   • Leitor de Implantações de Atualização de Dispositivo

   Para obter mais informações, Saiba mais sobre o controle de acesso baseado em função na Atualização de Dispositivo para Hub IoT.

   

4. Selecione Avançar

5. Na guia Membros, selecione os usuários ou grupos aos quais você quer atribuir a função de proprietário.

   

6. Selecionar Revisar + atribuir

7. Examine as novas atribuições de função e selecione Examinar + atribuir novamente

8. Agora você está pronto para usar a Atualização de Dispositivo no Hub IoT

CLI do Azure

As seguintes funções estão disponíveis para atribuição de acesso à Atualização de Dispositivo:

• Administrador de Atualização de Dispositivo
• Leitor de Atualização de Dispositivo
• Administrador de Conteúdo de Atualização de Dispositivo
• Leitor de Conteúdo de Atualização de Dispositivo
• Administrador de Implantações de Atualização de Dispositivo
• Leitor de Implantações de Atualização de Dispositivo

Para obter mais informações, Saiba mais sobre o controle de acesso baseado em função na Atualização de Dispositivo para Hub IoT.

Use o comando az role assignment create para configurar o controle de acesso da sua conta de Atualização de Dispositivo.

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

• <role>: a função da Atualização de Dispositivo sendo atribuída.
• <user_group>: o usuário ou grupo ao qual você deseja atribuir a função.
• <account_id>: a ID do recurso da conta de Atualização de Dispositivo à qual o usuário ou grupo terá acesso. Você pode recuperar a ID do recurso usando o comando az iot device-update account show e consultando o valor da ID: az iot device-update account show -n <account_name> --query id.

az role assignment create --role '<role>' --assignee <user_group> --scope <account_id>

Configurar funções de controle de acesso para Hub IoT

A Atualização de Dispositivo para Hub IoT se comunica com Hub IoT para gerenciar implantações e atualizações e obter informações sobre dispositivos. Para habilitar o acesso, você precisa conceder acesso à entidade de serviço de Atualização de Dispositivo do Azure com a função Colaborador de Dados do Hub IoT.

Portal do Azure

1. No portal do Azure, navegue até o hub IoT conectado à instância de Atualização de Dispositivo.
2. Escolha Controle de Acesso (IAM) no menu de navegação.
3. Selecione Adicionar>Adicionar atribuição de função.
4. Na guia Função, selecione Colaborador de Dados do Hub IoT. Selecione Avançar.
5. Em Atribuir acesso a, selecione Usuário, grupo ou entidade de serviço.
6. Escolha Selecionar Membros e pesquise por "Atualização de Dispositivo do Azure"
7. Selecione Avançar>Examinar + Atribuir

Para validar se você definiu as permissões corretamente:

1. No portal do Azure, navegue até o hub IoT conectado à instância de Atualização de Dispositivo.
2. Escolha Controle de Acesso (IAM) no menu de navegação.
3. Selecione Verificar acesso.
4. Selecione Usuário, grupo ou entidade de serviço e pesquise "Atualização de Dispositivo do Azure"
5. Depois de clicar em Atualização de Dispositivo do Azure, verifique se a função Colaborador de Dados do Hub IoT está listada em Atribuições de função

CLI do Azure

Use o comando az role assignment create para criar uma atribuição de função para a entidade de serviço de Atualização de Dispositivo do Azure.

Substitua <resource_id> pela ID do recurso do hub IoT. Você pode recuperar a ID do recurso usando o comando az iot hub show e consultando o valor da ID: az iot hub show -n <hub_name> --query id.

az role assignment create --role "IoT Hub Data Contributor" --assignee https://api.adu.microsoft.com/ --scope <resource_id>

Exibir e consultar contas ou instâncias

Você pode exibir, classificar e consultar todas as suas contas e instâncias da Atualização de Dispositivo.

Azure portal

1. Para exibir todas as contas da Atualização de Dispositivo, use o portal do Azure para pesquisar o serviço Atualização de Dispositivo para Hub IoT.

   • Use o menu suspenso Agrupamento para agrupar contas por assinatura, grupo de recursos, local e outras condições.
   • Selecione Adicionar filtro para filtrar a lista de contas por grupo de recursos, local, marcações e outras condições.

2. Para exibir todas as instâncias em uma conta, navegue até essa conta no portal do Azure. Selecionar Instâncias na seção Gerenciamento de instâncias do menu

   • Use a caixa de pesquisa para filtrar instâncias.

CLI do Azure

Para exibir todas as contas de Atualização de Dispositivo, use o comando az iot device-update account list.

az iot device-update account list 

Para exibir todas as instâncias em uma conta, use o comando az iot device-update instance list.

az iot device-update instance list --account <account_name>

Ambos os comandos list dão suporte a operações adicionais de agrupamento e filtro. Use o argumento --query para localizar contas ou instâncias com base em condições como marcações. Por exemplo, --query "[?tags.env == 'test']". Use o argumento --output para formatar os resultados. Por exemplo, --output table.

Próximas etapas

Tente atualizar um dispositivo seguindo um dos seguintes tutoriais rápidos:

• Atualizar um dispositivo de IoT Edge simulado
• Atualizar um Raspberry Pi
• Atualizar um agente de pacote do Ubuntu Server 18.04 x64

Saiba mais sobre conta e instância de Atualização de Dispositivo.

Saiba mais sobre as funções de controle de acesso de Atualização de Dispositivo