Tutorial: Configuración del entorno para los tutoriales y las guías de inicio rápido de IoT Plug and Play
Antes de poder completar cualquiera de los tutoriales y las guías de inicio rápido de IoT Plug and Play, debe configurar un centro de IoT y el servicio Device Provisioning (DPS) en la suscripción de Azure. También necesitará copias locales de los archivos de modelo utilizados por las aplicaciones de ejemplo y la herramienta Azure IoT Explorer.
Importante
En este artículo se incluyen los pasos para conectarse a un servicio mediante una firma de acceso compartido. Este método de autenticación es cómodo para las pruebas y la evaluación, pero la autenticación en un servicio con el Microsoft Entra ID o las identidades administradas es un enfoque más seguro. Para obtener más información, consulte Procedimientos recomendados de seguridad> Seguridad en la nube.
Requisitos previos
Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
Preparación del entorno para la CLI de Azure
Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.
Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.
Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.
En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.
Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.
Creación de los recursos
Cree un grupo de recursos de Azure para los recursos:
az group create --name my-pnp-resourcegroup --location centralus
Cree un Centro de IoT. El siguiente comando usa el nombre my-pnp-hub como ejemplo del nombre del centro de IoT que se va a crear. Elija un nombre único para el centro de IoT que se usará en lugar de my-pnp-hub:
az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2
Cree una instancia de DPS. El siguiente comando usa el nombre my-pnp-dps como ejemplo del nombre de la instancia de DPS que se va a crear. Elija un nombre único para la instancia de DPS que se usará en lugar de my-pnp-dps:
az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup
Para vincular la instancia de DPS a su centro de IoT, use los comandos siguientes. Reemplace my-pnp-dps y my-pnp-hub por los nombres únicos que eligió previamente:
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
Recuperación de la configuración
En algunos tutoriales y guías de inicio rápido se usa la cadena de conexión del centro de IoT. También necesita la cadena de conexión al configurar la herramienta Azure IoT Explorer. Recupere la cadena de conexión y tome nota de ella ahora. Reemplace my-pnp-hub por el nombre único que ha elegido para el centro de IoT:
az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString
La mayoría de las guías de inicio rápido y los tutoriales usan el ámbito de identificador de la configuración de DPS. Recupere el ámbito de identificador y tome nota de él ahora. Reemplace my-pnp-dps por el nombre único que ha elegido para la instancia de DPS:
az iot dps show --name my-pnp-dps --query properties.idScope
Todas las guías de inicio rápido y los tutoriales usan una inscripción de dispositivos de DPS. Use el comando siguiente para crear una inscripción de dispositivo individual my-pnp-device en la instancia de DPS. Reemplace my-pnp-dps por el nombre único que ha elegido para la instancia de DPS. Anote el identificador de registro y los valores de clave principal que se usarán en las guías de inicio rápido y los tutoriales:
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}'
Creación de variables de entorno
Cree cinco variables de entorno para configurar los ejemplos en las guías de inicio rápido y los tutoriales, a fin de usar el servicio Device Provisioning (DPS) para conectarse al centro de IoT:
- IOTHUB_DEVICE_SECURITY_TYPE: el valor
DPS. - IOTHUB_DEVICE_DPS_ID_SCOPE: el ámbito de identificador de DPS del que tomó nota anteriormente.
- IOTHUB_DEVICE_DPS_DEVICE_ID: el valor
my-pnp-device. - IOTHUB_DEVICE_DPS_DEVICE_KEY: clave principal de inscripción de la que tomó nota anteriormente.
- IOTHUB_DEVICE_DPS_ENDPOINT: el valor
global.azure-devices-provisioning.net.
Los ejemplos del servicio necesitan las siguientes variables de entorno para identificar el centro y el dispositivo con los que se establecerá la conexión:
- IOTHUB_CONNECTION_STRING: la cadena de conexión de IoT Hub que anotó anteriormente.
- IOTHUB_DEVICE_ID:
my-pnp-device.
Por ejemplo, en un shell con Bash de 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 ejemplo, en la línea de comandos de 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
Descarga de los archivos de modelo
En las guías de inicio rápido y los tutoriales se usan archivos de modelo de ejemplo para el controlador de temperatura y los dispositivos de termostato. Para descargar los archivos de modelo de ejemplo:
Cree una carpeta denominada models en la máquina local.
Haga clic con el botón derecho en TemperatureController.json y guarde el archivo JSON en la carpeta models.
Haga clic con el botón derecho en Thermostat.json y guarde el archivo JSON en la carpeta models.
Instalación de Azure IoT Explorer
En las guías de inicio rápido y los tutoriales se usa la herramienta Azure IoT Explorer. Vaya a las versiones de Azure IoT Explorer y expanda la lista de recursos de la versión más reciente. Descargue e instale la última versión de la aplicación para el sistema operativo.
La primera vez que ejecute la herramienta, se le solicitará la cadena de conexión del centro de IoT. Use la cadena de conexión que anotó anteriormente.
Configure la herramienta para usar los archivos de modelo que descargó anteriormente. En la página principal de la herramienta, seleccione IoT Plug and Play Settings (Configuración de IoT Plug and Play) y, a continuación, + Add > Local folder (Agregar > Carpeta local). Seleccione la carpeta models que creó anteriormente. A continuación, seleccione Guardar para guardar la configuración.
Para obtener más información, consulte Instalación y uso del explorador de Azure IoT.
Limpieza de recursos
Puede usar el centro de IoT y la instancia de DPS para todos los tutoriales y las guías de inicio rápido de IoT Plug and Play, por lo que solo necesita completar los pasos de este artículo una vez. Cuando haya terminado, puede quitarlos de la suscripción con el siguiente comando:
az group delete --name my-pnp-resourcegroup
Pasos siguientes
Ahora que ha configurado el entorno, puede probar una de las guías de inicio rápido o tutoriales, como: