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.

Requisitos previos

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

• CLI de Azure instalada en la máquina de desarrollo. Este escenario requiere la versión 2.64.0 o posterior de la CLI de Azure. Use az --version para comprobar la versión y az upgrade para actualizarla si es necesario. Para obtener más información, consulte Cómo instalar la CLI de Azure.

• Extensión Operaciones de IoT de Azure para la 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
  

Administración

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

Enumerar instancias.

Azure Portal

1. En Azure Portal, busque y seleccione Azure IoT Operations.
2. Use los filtros para ver las instancias de Azure IoT Operations en función de la suscripción, el grupo de recursos y mucho más.

CLI de Azure

Use el comando az iot ops list para ver todas las instancias de Azure IoT Operations en su suscripción o grupo de recursos.

El comando básico devuelve todas las instancias de la suscripción.

az iot ops list

Para filtrar los resultados por grupo de recursos, agregue el parámetro --resource-group.

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

Visualización de la instancia

Azure Portal

Puede ver la instancia de Azure IoT Operations en Azure Portal.

1. En el Azure Portal, vaya al grupo de recursos que contiene la instancia de Azure IoT Operations o busque y seleccione Azure IoT Operations.

2. Seleccione el nombre de la instancia de Azure IoT Operations.

3. En la página Información general de la instancia, la tabla Extensiones de Arc muestra los recursos que se implementaron en el clúster.

   

CLI de Azure

Use el comando az iot ops show para ver las propiedades de una instancia.

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

También puede usar el comando az iot ops show para ver los recursos de la implementación de Azure IoT Operations en la CLI de Azure. Agregue la marca --tree para mostrar una vista de árbol de la implementación que incluye la instancia de Azure IoT Operations especificada.

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

La vista de árbol de una implementación tiene el siguiente aspecto:

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

Puede ejecutar az iot ops check en el clúster para evaluar el estado y las configuraciones de los componentes individuales de Azure IoT Operations. De forma predeterminada, el comando comprueba MQ, pero puede especificar el servicio con --ops-service el parámetro.

Actualización de etiquetas de instancia y descripción

Azure Portal

1. En el Azure Portal, vaya al grupo de recursos que contiene la instancia de Azure IoT Operations o busque y seleccione Azure IoT Operations.

2. Seleccione el nombre de la instancia de Azure IoT Operations.

3. En la página Información general de la instancia, seleccione Agregar etiquetas o editar para modificar etiquetas en la instancia.

CLI de Azure

Use el comando az iot ops update para editar las etiquetas y los parámetros de descripción de la instancia de Azure IoT Operations. Los valores proporcionados en el comando update reemplazan las etiquetas o la descripción existentes

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

Para eliminar todas las etiquetas de una instancia, establezca el parámetro tags en un valor NULL. Por ejemplo:

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

Administración de componentes

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.

(Versión preliminar) Administración de componentes mediante manifiestos de implementación de Kubernetes

En general, Operaciones de IoT de Azure usa la plataforma Azure Arc para proporcionar una experiencia de nube híbrida donde puede administrar la configuración a través de Azure Resource Manager (ARM) y herramientas de front-end como Azure Portal, Bicep y la CLI de Azure.

Sin embargo, también puede administrar los componentes de Operaciones de IoT de Azure mediante manifiestos de implementación de Kubernetes de YAML. Esto significa que puede usar herramientas como kubectl para administrar algunos componentes de Operaciones de IoT de Azure. Esta funcionalidad actualmente está en versión preliminar tiene algunas limitaciones:

• Solo algunos componentes admiten el uso de manifiestos de implementación de Kubernetes. Estos componentes son el corredor MQTT y los flujos de datos. Otros componentes como el conector para OPC UA y los servicios de Akri no admiten esta característica.
• A menos que Azure IoT Operations se implemente con la sincronización de recursos habilitada mediante az iot ops create --enable-rsync, los cambios realizados en los recursos mediante manifiestos de implementación de Kubernetes no se sincronizan con Azure. Para más información sobre la sincronización de recursos, consulte Sincronización de recursos.
• Incluso aunque la sincronización de recursos esté habilitada, los nuevos recursos creados con manifiestos de implementación de Kubernetes no se sincronizan con Azure. Solo se sincronizan los cambios en los recursos existentes.

Desinstalar

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

Los pasos de Azure Portal pueden eliminar una instancia de Operaciones de IoT de Azure, pero no pueden afectar a los recursos relacionados de la implementación. Si desea eliminar toda la implementación, use la CLI de Azure.

Azure Portal

1. En el Azure Portal, vaya al grupo de recursos que contiene la instancia de Azure IoT Operations o busque y seleccione Azure IoT Operations.

2. Seleccione el nombre de la instancia de Azure IoT Operations.

3. En la página Información general de la instancia, seleccione Eliminar.

4. Revise la lista de recursos que son y no se eliminan como parte de esta operación y escriba el nombre de la instancia y seleccione Eliminar para confirmar.

   

CLI de Azure

Use el comando az iot ops delete para eliminar toda la implementación de operaciones de Azure IoT de un clúster. El comando delete evalúa los recursos relacionados con Operaciones de IoT de Azure en el clúster y presenta una vista de árbol de los recursos que se van a eliminar. El clúster debe estar en línea al ejecutar este comando.

El comando delete simplifica la reimplementación de operaciones de Azure IoT en el mismo clúster. Deshace el comando create para que pueda ejecutar create, delete, create de nuevo sin tener que volver a ejecutar init.

El comando delete quita lo siguiente:

• Instancia de Azure IoT Operations
• Extensiones de Arc
• Ubicaciones personalizadas
• Reglas de sincronización de recursos
• Recursos que puede configurar en la solución de operaciones de Azure IoT, como recursos, agente MQTT y flujos de datos.

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

Para eliminar la instancia y también quitar las dependencias de Operaciones de IoT de Azure (la salida de init), agregue la marca --include-deps.

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