Tutorial: Configurar seu ambiente para os tutoriais e inícios rápidos do IoT Plug and Play
Antes de concluir qualquer um dos tutoriais e inícios rápidos do IoT Plug and Play, você precisa configurar um hub IoT e o Serviço de Provisionamento de Dispositivo (DPS) em sua assinatura do Azure. Você também precisará de cópias locais dos arquivos de modelo usados pelos aplicativos de exemplo e pela ferramenta Azure IoT Explorer.
Importante
Este artigo inclui etapas para se conectar a um serviço usando uma assinatura de acesso compartilhado. Esse método de autenticação é conveniente para teste e avaliação, mas autenticar em um serviço com ID do Microsoft Entra ou identidades gerenciadas é uma abordagem mais segura. Para saber mais, consulte Práticas > recomendadas de segurança Segurança na nuvem.
Pré-requisitos
Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.
Prepare o seu ambiente para o CLI do Azure
Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.
Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.
Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.
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.
Criar os recursos
Crie um grupo de recursos do Azure para os recursos:
az group create --name my-pnp-resourcegroup --location centralus
Crie um hub IoT. O comando a seguir usa o nome my-pnp-hub como um exemplo para o nome do hub IoT a ser criado. Escolha um nome exclusivo para seu hub IoT para usar no lugar de my-pnp-hub:
az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2
Crie uma instância do DPS. O comando a seguir usa o nome my-pnp-dps como um exemplo para o nome da instância do DPS a ser criada. Escolha um nome exclusivo para sua instância DPS para usar no lugar de my-pnp-dps:
az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup
Para vincular a instância do DPS ao seu hub IoT, use os comandos a seguir. Substitua my-pnp-dps e my-pnp-hub pelos nomes exclusivos que você escolheu anteriormente:
hubConnectionString=$(az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString -o tsv)
az iot dps linked-hub create --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --location centralus --connection-string $hubConnectionString
Recuperar as configurações
Alguns guias de início rápido e tutoriais usam a cadeia de conexão para seu hub IoT. Você também precisa da cadeia de conexão ao configurar a ferramenta Azure IoT explorer. Recupere a cadeia de conexão e anote-a agora. Substitua my-pnp-hub pelo nome exclusivo que você escolheu para seu hub IoT:
az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString
A maioria dos guias de início rápido e tutoriais usa o escopo de ID da configuração do DPS. Recupere o escopo do ID e anote-o agora. Substitua my-pnp-dps pelo nome exclusivo que você escolheu para sua instância DPS:
az iot dps show --name my-pnp-dps --query properties.idScope
Todos os guias de início rápido e tutoriais usam um registro de dispositivo DPS. Use o comando a seguir para criar um registro de my-pnp-device dispositivo individual em sua instância do DPS. Substitua my-pnp-dps pelo nome exclusivo que você escolheu para sua instância DPS. Anote o ID de registro e os valores de chave primária para usar nos guias de início rápido e tutoriais:
az iot dps enrollment create --attestation-type symmetrickey --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --enrollment-id my-pnp-device --device-id my-pnp-device --query '{registrationID:registrationId,primaryKey:attestation.symmetricKey.primaryKey}'
Criar variáveis de ambiente
Crie cinco variáveis de ambiente para configurar os exemplos nos inícios rápidos e tutoriais para usar o Device Provisioning Service (DPS) para se conectar ao seu hub IoT:
- IOTHUB_DEVICE_SECURITY_TYPE: o valor
DPS. - IOTHUB_DEVICE_DPS_ID_SCOPE: o escopo da ID do DPS que você anotou anteriormente.
- IOTHUB_DEVICE_DPS_DEVICE_ID: o valor
my-pnp-device. - IOTHUB_DEVICE_DPS_DEVICE_KEY: a chave primária de inscrição que você anotou anteriormente.
- IOTHUB_DEVICE_DPS_ENDPOINT: o valor
global.azure-devices-provisioning.net
Os exemplos de serviço precisam das seguintes variáveis de ambiente para identificar o hub e o dispositivo aos quais se conectar:
- IOTHUB_CONNECTION_STRING: a cadeia de conexão do hub IoT que você anotou anteriormente.
- IOTHUB_DEVICE_ID:
my-pnp-device.
Por exemplo, em um shell bash do Linux:
export IOTHUB_DEVICE_SECURITY_TYPE="DPS"
export IOTHUB_DEVICE_DPS_ID_SCOPE="<Your ID scope>"
export IOTHUB_DEVICE_DPS_DEVICE_ID="my-pnp-device"
export IOTHUB_DEVICE_DPS_DEVICE_KEY="<Your enrolment primary key>"
export IOTHUB_DEVICE_DPS_ENDPOINT="global.azure-devices-provisioning.net"
export IOTHUB_CONNECTION_STRING="<Your IoT hub connection string>"
export IOTHUB_DEVICE_ID="my-pnp-device"
Por exemplo, na linha de comando do Windows:
set IOTHUB_DEVICE_SECURITY_TYPE=DPS
set IOTHUB_DEVICE_DPS_ID_SCOPE=<Your ID scope>
set IOTHUB_DEVICE_DPS_DEVICE_ID=my-pnp-device
set IOTHUB_DEVICE_DPS_DEVICE_KEY=<Your enrolment primary key>
set IOTHUB_DEVICE_DPS_ENDPOINT=global.azure-devices-provisioning.net
set IOTHUB_CONNECTION_STRING=<Your IoT hub connection string>
set IOTHUB_DEVICE_ID=my-pnp-device
Baixe os arquivos do modelo
Os guias de início rápido e tutoriais usam arquivos de modelo de exemplo para o controlador de temperatura e dispositivos de termostato. Para baixar os arquivos de modelo de exemplo:
Crie uma pasta chamada modelos em sua máquina local.
Clique com o botão direito do mouse em TemperatureController.json e salve o arquivo JSON na pasta models .
Clique com o botão direito do mouse em Thermostat.json e salve o arquivo JSON na pasta models .
Instalar o explorador do Azure IoT
Os guias de início rápido e tutoriais usam a ferramenta Azure IoT explorer . Vá para Versões do Azure IoT Explorer e expanda a lista de ativos para a versão mais recente. Transfira e instale a versão mais recente da aplicação para o seu sistema operativo.
Na primeira vez que você executar a ferramenta, será solicitada a cadeia de conexão do hub IoT. Use a cadeia de conexão que você anotou anteriormente.
Configure a ferramenta para usar os arquivos de modelo baixados anteriormente. Na página inicial da ferramenta, selecione Configurações Plug and Play da IoT e, em seguida , + Adicionar > pasta Local. Selecione a pasta de modelos que você criou anteriormente. Em seguida, selecione Salvar para salvar as configurações.
Para saber mais, consulte Instalar e usar o Azure IoT explorer.
Clean up resources (Limpar recursos)
Você pode usar o hub IoT e a instância DPS para todos os tutoriais e inícios rápidos do IoT Plug and Play, portanto, só precisa concluir as etapas neste artigo uma vez. Quando terminar, pode removê-los da sua subscrição com o seguinte comando:
az group delete --name my-pnp-resourcegroup
Próximos passos
Agora que você configurou seu ambiente, pode experimentar um dos guias de início rápido ou tutoriais, como: