Administración de recursos de Device Update para IoT Hub

Para empezar a trabajar con Device Update, deberá crear una cuenta en este servicio y una instancia, para luego establecer roles de control de acceso.

Requisitos previos

Azure Portal

Una instancia de IoT Hub. Se recomienda usar el nivel S1 (Estándar) o superior.

CLI de Azure

• Una instancia de IoT Hub. Se recomienda usar el nivel S1 (Estándar) o superior.

• Un entorno de la CLI de Azure:

  • Use el entorno de Bash en Azure Cloud Shell.

    

  • O bien, si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure.

    • Inicie sesión en la CLI de Azure mediante el comando az login.

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

    • Cuando se le solicite, instale las extensiones de la CLI de Azure la primera vez que lo use. Los comandos de este artículo usan la extensión azure-iot. Ejecute az extension update --name azure-iot para asegurarse de usar la versión más reciente de la extensión.

Creación de una instancia y cuenta de Device Update

Azure Portal

1. En el Azure Portal, seleccione Crear un recurso y busque "Device Update for IoT Hub"

   

2. Seleccione Crear>Device Update for IoT Hub.

3. En la pestaña Básico, especifique la siguiente información para su Cuenta de Device Update:

   • Suscripción: la suscripción de Azure que se va a asociar a la cuenta de Device Update.
   • Grupo de recursos: un grupo de recursos existente o nuevo.
   • Nombre: nombre de la cuenta.
   • Ubicación: la región de Azure donde se ubicará la cuenta. Para obtener información sobre qué regiones admiten Device Update para IoT Hub, consulte la página Productos por región de Azure.

   Nota

   La cuenta de Device Update no necesita estar en la misma región que los centros de IoT, pero, para mejorar el rendimiento, se recomienda mantenerlos geográficamente cerca.

   

4. Opcionalmente, puede seleccionar la casilla para asignarse el rol Administrador de Device Update a sí mismo. También puede usar los pasos enumerados en la sección Configuración de los roles de control de acceso para proporcionar una combinación de roles a usuarios y aplicaciones para el nivel de acceso correcto.

   Debe tener permisos de propietario o administrador de acceso de usuario en la suscripción para administrar roles.

5. Seleccione Siguiente: Instancia

   Una instancia de Device Update se asocia con un único centro de IoT. Seleccione el centro de IoT Hub que se usará con Device Update. Al vincular un centro de IoT a una instancia de Device Update, se crea automáticamente una nueva directiva de acceso compartido para que Device Update funcione con IoT Hub (escritura del Registro y conexión de servicio). Esta directiva garantiza que el acceso solo se limita a Device Update.

6. En la pestaña Instancia, proporcione la siguiente información para la instancia de Device Update:

   • Nombre: nombre de la instancia.
   • IoT Hub details: seleccione un centro de IoT para vincular a esta instancia.

   

7. Seleccione Siguiente: Revisar y crear. Después de la validación, seleccione Crear.

   

8. Verá la implementación en curso. El estado de la implementación cambiará a "Finalizado" en unos minutos. Cuando finalice, seleccione Ir al recurso.

   

CLI de Azure

Use el comando az iot device-update account create para crear una nueva cuenta de Device Update.

Reemplace los marcadores de posición siguientes por su propia información:

• <resource_group>: un grupo de recursos existente en la suscripción.

• <account_name>: un nombre para la cuenta de Device Update.

• <region>: la región de Azure donde se ubicará la cuenta. Para obtener información sobre qué regiones admiten Device Update para IoT Hub, consulte la página Productos por región de Azure. Si no se proporciona ninguna región, se usará la ubicación del grupo de recursos.

  Nota

  La cuenta de Device Update no necesita estar en la misma región que los centros de IoT, pero, para mejorar el rendimiento, se recomienda mantenerlos geográficamente cerca.

az iot device-update account create --resource-group <resource_group> --account <account_name> --location <region>

Use el comando az iot device-update instance create para crear una instancia de Device Update.

Una instancia de Device Update se asocia con un único centro de IoT. Seleccione el centro de IoT Hub que se usará con Device Update. Al vincular un centro de IoT a una instancia de Device Update, se crea automáticamente una nueva directiva de acceso compartido para que Device Update funcione con IoT Hub (escritura del Registro y conexión de servicio). Esta directiva garantiza que el acceso solo se limita a Device Update.

Reemplace los marcadores de posición siguientes por su propia información:

• <account_name>: nombre de la cuenta de Device Update a la que se asociará esta instancia.
• <instance_name>: un nombre para esta instancia.
• <iothub_id>: el identificador de recurso del centro de IoT que se vinculará a esta instancia. Puede recuperar el identificador de recurso de IoT Hub mediante el comando az iot hub show y la consulta del valor de identificador: 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>

Sugerencia

Como parte del proceso de creación de instancias, también puede configurar el registro de diagnóstico. Para obtener más información, consulte Recopilación remota de registros de diagnóstico de dispositivos.

Configuración de roles de control de acceso para Device Update

Para que otros puedan tener acceso a Device Update, se les debe conceder acceso a este recurso. Puede omitir este paso si se asignó el rol Administrador de Device Update durante la creación de la cuenta y no tiene que proporcionar acceso a otros usuarios o aplicaciones.

Azure Portal

1. En la cuenta de Device Update, seleccione Control de acceso (IAM) en el menú de navegación.

   

2. Seleccione Agregar asignación de roles.

3. En la pestaña Rol, seleccione un rol de Device Update entre las opciones disponibles:

   • Device Update Administrator (Administrador de Device Update)
   • Device Update Reader (Lector de Device Update)
   • Device Update Content Administrator (Administrador de contenido de Device Update)
   • Device Update Content Reader (Lector de contenido de Device Update)
   • Device Update Deployments Administrator (Administrador de implementaciones de Device Update)
   • Device Update Deployments Reader (Lector de implementaciones de Device Update)

   Más información sobre el Control de acceso basado en roles en Device Update para IoT Hub.

   

4. Seleccione Siguiente.

5. En la pestaña Miembros, seleccione el usuario o grupos a los que quiera asignar el rol.

   

6. Seleccione Revisar y asignar

7. Revise las nuevas asignaciones de roles y vuelva a seleccionar Revisar y asignar.

8. Ahora está listo para usar Device Update desde el centro de IoT.

CLI de Azure

Los siguientes roles están disponibles para asignar acceso a Device Update:

• Device Update Administrator (Administrador de Device Update)
• Device Update Reader (Lector de Device Update)
• Device Update Content Administrator (Administrador de contenido de Device Update)
• Device Update Content Reader (Lector de contenido de Device Update)
• Device Update Deployments Administrator (Administrador de implementaciones de Device Update)
• Device Update Deployments Reader (Lector de implementaciones de Device Update)

Más información sobre el Control de acceso basado en roles en Device Update para IoT Hub.

Use el comando az role assignment create para configurar el control de acceso para la cuenta de Device Update.

Reemplace los marcadores de posición siguientes por su propia información:

• <role>: el rol Device Update que va a asignar.
• <user_group>: usuario o grupo al que desea asignar el rol.
• <account_id>: el identificador de recurso de la cuenta de Device Update a la que accederá el usuario o grupo. Puede recuperar el identificador de recurso mediante el comando az iot device-update account show y la consulta del valor de identificador: az iot device-update account show -n <account_name> --query id.

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

Configuración de roles de control de acceso para IoT Hub

Device Update for IoT Hub se comunica con IoT Hub para administrar implementaciones y actualizaciones y obtener información sobre los dispositivos. Para habilitar el acceso, debe conceder acceso a la entidad de servicio de Azure Device Update con el rol Colaborador de datos de IoT Hub.

Azure Portal

1. En Azure Portal, vaya al centro de IoT conectado a la instancia de Device Update.
2. Seleccione Control de acceso (IAM) en el menú de navegación.
3. Seleccione Agregar>Agregar asignación de roles.
4. En la pestaña Rol, seleccione Colaborador de datos de IoT Hub. Seleccione Next (Siguiente).
5. En Asignar acceso a, seleccione User, group, or service principle (Usuario, grupo o entidad de servicio).
6. Elija Seleccionar miembros y busque "Azure Device Update".
7. Seleccione Siguiente>Revisar y asignar.

Para validar que ha establecido los permisos correctamente:

1. En Azure Portal, vaya al centro de IoT conectado a la instancia de Device Update.
2. Seleccione Control de acceso (IAM) en el menú de navegación.
3. Seleccione Comprobar acceso.
4. Seleccione Usuario, grupo o entidad de servicio y busque "Azure Device Update"
5. Después de hacer clic en Azure Device Update, compruebe que el rol Colaborador de datos de IoT Hub aparece en Asignaciones de roles.

CLI de Azure

Use el comando az role assignment create para crear una asignación de roles para la entidad de servicio de Azure Device Update.

Reemplace <resource_id> por el identificador de recurso del centro de IoT. Puede recuperar el identificador de recurso mediante el comando az iot hub show y la consulta del valor de identificador: 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>

Visualización y consulta de cuentas o instancias

Puede ver, ordenar y consultar todas las cuentas y instancias de Device Update.

Azure Portal

1. Para ver todas las cuentas de Device Update, use el Azure Portal para buscar el servicio Device Update para IoT Hubs.

   • Use el menú desplegable Agrupación para agrupar la cuenta por suscripción, grupo de recursos, ubicación y otras condiciones.
   • Seleccione Agregar filtro para filtrar la lista de cuentas por grupo de recursos, ubicación, etiquetas y otras condiciones.

2. Para ver todas las instancias de una cuenta, vaya a esa cuenta en el Azure Portal. Seleccione Instancias en la sección Administración de instancias del menú.

   • Use el cuadro de búsqueda para filtrar las instancias.

CLI de Azure

Para ver todas las cuentas de Device Update, use el comando az iot device-update account list.

az iot device-update account list 

Para ver todas las instancias de una cuenta, use el comando az iot device-update instance list.

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

Ambos comandos list admiten operaciones adicionales de agrupación y filtro. Use el argumento --query para buscar cuentas o instancias basadas en condiciones como etiquetas. Por ejemplo, --query "[?tags.env == 'test']". Use el argumento --output para dar formato a los resultados. Por ejemplo, --output table.

Pasos siguientes

Intente actualizar un dispositivo con uno de los siguientes tutoriales rápidos:

• Actualización de un dispositivo de IoT Edge simulado
• Actualización de Raspberry Pi
• Actualización de un agente de Ubuntu Server 18.04 x64 Package agent

Consulte más información sobre la cuenta y la instancia de Device Update.

Consulte más información sobre los roles de control de acceso de Device Update