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.

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:

1. Crie uma pasta chamada modelos em sua máquina local.

2. Clique com o botão direito do mouse em TemperatureController.json e salve o arquivo JSON na pasta models .

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