Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Durante o ciclo de vida de uma solução IoT, é comum mover dispositivos entre os Hubs IoT. Este artigo é escrito para ajudar os operadores de solução que configuram políticas de reprovisionamento.
Para obter uma visão geral mais detalhada dos cenários de reprovisionamento, confira Conceitos de reprovisionamento de dispositivos do Hub IoT.
Definir a política de reaprovisionamento
As etapas a seguir configuram a política de reaprovisionamento para um grupo de registros ou registro individual:
Entre no portal do Azure e navegue até instância do Serviço de Provisionamento de Dispositivos.
Selecione Gerenciar registros e, em seguida, selecione a guia Grupos de registros ou Registros individuais.
Selecione o nome do grupo de registros ou registro individual que você quer configurar para reaprovisionamento.
Use o menu suspenso na guia Política de reaprovisionamento para escolher uma das seguintes políticas de reaprovisionamento:
Nunca reaprovisionar o dispositivo.
Reaprovisionar o dispositivo e redefinir o estado inicial: essa política entra em ação quando os dispositivos associados à entrada do registro enviam uma nova solicitação de provisionamento. Dependendo da configuração de entrada de registro, o dispositivo pode ser reatribuído para outro hub IoT. Se o dispositivo estiver alterando os hubs IoT, o registro do dispositivo com o hub IoT inicial será removido. Os dados de configuração inicial que a instância de serviço de provisionamento recebeu quando o dispositivo foi provisionado são fornecidos ao novo Hub IoT. Durante a migração, o status do dispositivo é relatado como Atribuição.
Reaprovisionar o dispositivo e migrar o estado atual: essa política entra em ação quando os dispositivos associados com a entrada do registro enviam uma nova solicitação de provisionamento. Dependendo da configuração de entrada de registro, o dispositivo pode ser reatribuído para outro hub IoT. Se o dispositivo estiver alterando os hubs IoT, o registro do dispositivo com o hub IoT inicial será removido. Todas as informações de estado do dispositivo desse hub IoT inicial são migradas para o novo hub IoT. Durante a migração, o status do dispositivo é relatado como Atribuição
Selecione Salvar para habilitar o reprovisionamento do dispositivo com base em suas alterações.
Configurar a política de alocação de registro
A política de alocação determina como os dispositivos associados ao registro são alocados ou atribuídos a um hub IoT uma vez reprovisionados. Para saber mais sobre as políticas de alocação, consulte Como usar políticas de alocação para provisionar dispositivos em hubs IoT.
As seguintes etapas configuram a política de alocação para o registro do dispositivo:
Entre no portal do Azure e navegue até instância do Serviço de Provisionamento de Dispositivos.
Selecione Gerenciar registros e, em seguida, selecione a guia Grupos de registros ou Registros individuais.
Selecione o nome do grupo de registros ou registro individual que você quer configurar para reaprovisionamento.
Na página Detalhes do registro, selecione a guia Hubs IoT.
Selecione uma das seguintes políticas de alocação:
Estática: essa política requer que um hub IoT desejado seja listado na entrada do registro de um dispositivo a ser provisionado. Essa política permite que você designe um único Hub IoT ao qual deseja atribuir dispositivos.
Distribuição uniformemente ponderada: esta política distribui os dispositivos entre os hubs IoT com base no peso de alocação configurado em cada hub IoT. Hubs IoT com maior peso de alocação são mais propensos a serem atribuídos. Se estiver provisionando dispositivos para apenas um Hub IoT, recomendamos essa configuração. Esta é a configuração padrão.
Menor latência: essa política atribui dispositivos ao hub IoT que resulta nas comunicações de latência mais baixas entre o dispositivo e o Hub IoT. Essa opção permite que o dispositivo se comunique com o Hub IoT mais próximo no local.
Personalizada (usar a Função do Azure): essa política usa um webhook personalizado hospedado no Azure Functions para atribuir dispositivos a um ou mais hubs IoT. Políticas de alocação personalizada proporcionam a você mais controle sobre como os dispositivos são atribuídos a seus hubs IoT. Para saber mais, confira Noções básicas sobre políticas de alocação personalizadas com o Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.
Em Hubs IoT de destino, selecione os hubs IoT vinculados que você quer incluir na sua política de alocação. Opcionalmente, adicione um novo hub IoT vinculado usando o botão Adicionar link para o hub IoT.
Com a política de alocação Configuração estática, selecione o Hub IoT ao qual deseja atribuir dispositivos.
Com a política de alocação Distribuição uniformemente ponderada, os dispositivos serão distribuídos por hash entre os hubs IoT selecionados com base nos pesos de alocação configurados deles.
Com a política de alocação de latência mais baixa, os hubs IoT selecionados são incluídos na avaliação de latência, que determina qual é o hub IoT mais próximo para a atribuição dos dispositivos.
Com a política de alocação Personalizada, selecione os hubs IoT que deseja avaliar para atribuição pelo webhook de alocação personalizado.
Clique em Salvar.
Enviar uma solicitação de provisionamento do dispositivo
Para que os dispositivos sejam reprovisionados com base nas alterações de configuração feitas nas seções anteriores, esses dispositivos devem solicitar o reprovisionamento.
A frequência com que um dispositivo envia uma solicitação de provisionamento depende do cenário. Ao projetar sua solução e definir uma lógica de reprovisionamento, há algumas coisas a serem consideradas. Por exemplo:
- Com que frequência você espera que seus dispositivos sejam reiniciados
- Cotas e limites do DPS
- Tempo de implantação esperado para sua frota (distribuição em fases versus tudo de uma vez)
- Recurso de repetição implementado no código do cliente, conforme descrito nas diretrizes de tratamento de falhas transitórias no Centro de Arquitetura do Azure
Dica
Recomendamos não provisionar em cada reinicialização do dispositivo, pois essa ação pode atingir os limites de limitação de serviço, especialmente ao reprovisionar milhares ou milhões de dispositivos ao mesmo tempo. Em vez disso, tente usar a API de Pesquisa do status de registro do dispositivo e se conectar ao Hub IoT com essas informações. Se isso falhar, tente repetir o provisionamento, pois as informações do Hub IoT podem ter sido alteradas. Tenha em mente que a consulta para o estado de registro conta como um novo registro de dispositivo, portanto, você deve considerar o limite de registro do dispositivo. Considere também implementar uma lógica de repetição apropriada, como retirada exponencial com randomização, conforme descrito nas diretrizes sobre tratamento de falhas transitórias no Centro de Arquitetura do Azure. Em alguns casos, dependendo dos recursos do dispositivo, é possível salvar as informações do Hub IoT diretamente no dispositivo para se conectar diretamente ao Hub IoT após o primeiro provisionamento usando o DPS. Se você optar por salvar diretamente no dispositivo, certifique-se de implementar um mecanismo de fallback caso ocorram erros específicos do Hub IoT. Por exemplo, considere os seguintes cenários:
- Repita a operação do Hub IoT se o código de resultado for 429 (Solicitações Demais) ou um erro no intervalo de 5xx. Não tente novamente em caso de quaisquer outros erros.
- Para erros 429, tente novamente após o tempo indicado no cabeçalho Retry-After.
- Para erros 5xx, use uma nova retirada exponencial, com a repetição pelo menos cinco segundos após a resposta.
- Em erros diferentes de 429 e 5xx, registre-se novamente por meio do DPS
- O ideal é que você também dê suporte a um método direto para disparar manualmente o provisionamento sob demanda.
Também recomendamos levar em consideração os limites de serviço ao planejar atividades como o envio de atualizações para a frota. Por exemplo, atualizar a frota de uma só vez pode fazer com que todos os dispositivos se registrem novamente por meio do DPS (que poderia facilmente estar acima do limite de cota de registro).) Para esses cenários, considere o planejamento de atualizações de dispositivo em fases em vez de atualizar toda a frota ao mesmo tempo.
Próximas etapas
- Para saber mais sobre o reprovisionamento, consulte os conceitos de reprovisionamento de dispositivos do Hub IoT.
- Para saber mais sobre desprovisionamento, confira Como desprovisionar dispositivos que foram provisionados automaticamente anteriormente.