Administración del ciclo de vida de una instancia de Operaciones de IoT de Azure

Use la CLI de Azure y Azure Portal para administrar, desinstalar o actualizar instancias de Operaciones de IoT de Azure.

Prerequisites

• Una instancia de Operaciones de IoT de Azure implementada en un clúster. Para obtener más información, consulte Deploy Operaciones de IoT de Azure.

• La CLI de Azure versión 2.62.0 o posterior instalada en el equipo de desarrollo. Use az --version para comprobar la versión y az upgrade para actualizarla si es necesario. Para más información, consulte Instalación de la CLI de Azure.

• Extensión Operaciones de IoT de Azure para el CLI de Azure. Use el siguiente comando para agregar la extensión o actualizarla a la versión más reciente:

  az extension add --upgrade --name azure-iot-ops
  

Manage

Después de la implementación, puede usar la CLI de Azure y Azure Portal para ver y administrar la instancia de Operaciones de IoT de Azure.

Enumerar instancias

az iot ops list

az iot ops list --resource-group <RESOURCE_GROUP>

Visualización de la instancia

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --tree

MyCluster
├── extensions
│   ├── akvsecretsprovider
│   ├── azure-iot-operations-ltwgs
│   └── azure-iot-operations-platform-ltwgs
└── customLocations
    └── MyCluster-cl
        ├── resourceSyncRules
        └── resources
            ├── MyCluster-ops-init-instance
            └── MyCluster-observability

Visualización de Azure Device Registry

En Azure Portal, puede ver Azure Device Registry, que es una colección de todos los dispositivos y recursos que están conectados a la instancia de Operaciones de IoT de Azure.

Azure Device Registry usa espacios de nombres para organizar recursos y dispositivos. Cada instancia de Operaciones de IoT de Azure usa un único espacio de nombres para sus recursos y dispositivos. Varias instancias pueden compartir un único espacio de nombres.

Para ver los elementos en Azure Device Registry en Azure Portal:

1. En Azure Portal, busque y seleccione Azure Device Registry. En la página Información general se resume el número de recursos, registros de esquema y espacios de nombres de la suscripción:

   

2. Use la página Activos para ver los activos en el Registro de Dispositivos de Azure. De forma predeterminada, la página Recursos muestra los recursos de todos los espacios de nombres en tu suscripción. Use los filtros para ver un subconjunto de los recursos, como los recursos de un espacio de nombres específico o un grupo de recursos:

   

3. Utilice la página Registros de esquemas para ver los registros de esquemas en Azure Device Registry. De forma predeterminada, la página Registros de esquema muestra los registros de esquema en todos los espacios de nombres de tu suscripción. Use los filtros para ver un subconjunto de los registros de esquema, como los registros de esquema en un espacio de nombres o grupo de recursos específico:

   

4. Use la página Espacios de nombres para ver los espacios de nombres en Azure Device Registry. De forma predeterminada, la página Espacios de nombres muestra los espacios de nombres de tu suscripción. Utiliza los filtros para visualizar un subconjunto de los espacios de nombres, como los espacios de nombres de un grupo de recursos específico. En esta página, puede crear nuevos espacios de nombres o ver los detalles de los espacios de nombres existentes:

   

También puede ver los detalles de un espacio de nombres existente en el grupo de recursos que incluye la instancia de Operaciones de IoT de Azure. Por ejemplo, en la captura de pantalla siguiente se muestra el recurso adr-namespace asociado a la instancia aio-131235032 de Operaciones de IoT de Azure:

En la captura de pantalla anterior también se muestran los demás recursos de Azure Device Registry, como el Registro de esquemas de IoT, los recursos del espacio de nombres de IoT y los dispositivos en el contexto del grupo de recursos que contiene la instancia de Operaciones de IoT de Azure.

Migrar activos (clásico) a activos

Si tiene recursos existentes en la instancia de Operaciones de IoT de Azure que desea mover a un espacio de nombres, puede usar el comando az iot ops migrate-assets. Este comando migra los recursos de nivel raíz (clásico) a los recursos de Azure Device Registry.

El conjunto de recursos de destino (clásico) se convierte en una representación de recurso equivalente y reemplaza el recurso de nivel raíz original (clásico). Durante la migración, los dispositivos se crean en lugar de los perfiles de punto de conexión a los que hacen referencia los recursos raíz. Si varios recursos hacen referencia al mismo perfil de punto de conexión, solo los recursos migrados hacen referencia a un dispositivo.

Para migrar todos los recursos raíz asociados a una instancia, ejecute el siguiente comando:

az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> 

Para migrar recursos raíz específicos asociados a una instancia, ejecute el siguiente comando:

az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --pattern <ASSET_ID_1> <ASSET_ID_2> <ASSET_ID_3>

Para migrar todos los recursos raíz asociados a una instancia que coincida con patrones de estilo global, ejecute el siguiente comando:

az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --pattern asset-pl-* asset-eng?-01

Una vez completada la migración, puede usar los comandos az iot ops ns asset y az iot ops ns device para administrar los recursos y dispositivos en su instancia de Operaciones de IoT de Azure.

Configurar plantillas de conectores

En el portal de Azure o mediante el CLI de Azure, puede configurar conector templates para la instancia de Operaciones de IoT de Azure. Las plantillas de conector definen la configuración de conectores, como el conector de OPC UA, que se implementan en el clúster. Al crear una plantilla de conector, permite a un usuario de OT crear un dispositivo que use el tipo de conector en la interfaz de usuario web de la experiencia de operaciones.

Para más información sobre las plantillas de conector, consulte Creación y administración de instancias de plantilla de conector.

Administración de componentes de instancia

Cada instancia de Operaciones de IoT de Azure incluye varios componentes, como el corredor MQTT, el conector para OPC UA y los flujos de datos. Para obtener más información sobre cómo administrar estos componentes, consulte sus respectivos artículos. Por ejemplo, para administrar el corredor MQTT, comience con Información general del corredor.

Para agregar o quitar el conector de OPC UA de la instancia, vaya a la instancia en Azure Portal y seleccione Editar junto a Componentes opcionales en la página Información general . El panel de configuración Componentes opcionales permite agregar o quitar el conector para OPC UA de la instancia:

También puede usar la CLI de Azure para habilitar o deshabilitar el conector para OPC UA. Para habilitar el conector para OPC UA, ejecute:

az iot ops update --name myinstance -g myresourcegroup --feature opcua.mode=Stable

Para deshabilitar el conector para OPC UA, ejecute:

az iot ops update --name myinstance -g myresourcegroup --feature opcua.mode=Disabled

Actualización de instancias y configuración

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --desc "<INSTANCE_DESCRIPTION>" --tags <TAG_NAME>=<TAG-VALUE> <TAG_NAME>=<TAG-VALUE>

az iot ops update --name <INSTANCE_NAME> --resource-group --tags ""

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --feature connectors.settings.preview=Enabled 

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --feature connectors.settings.preview=Disabled  

Uninstall

La CLI de operaciones de Azure IoT y Azure Portal ofrecen diferentes opciones para desinstalar operaciones de Azure IoT.

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps