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

Importante

Versión preliminar de operaciones de Azure IoT: habilitada por Azure Arc está actualmente en versión preliminar. No se debería usar este software en versión preliminar en entornos de producción.

Deberá implementar una nueva instalación de Azure IoT Operations cuando esté disponible una versión general. No podrá actualizar una instalación de versión preliminar.

Consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure para conocer los términos legales que se aplican a las características de Azure que se encuentran en la versión beta, en versión preliminar o que todavía no se han publicado para que estén disponibles con carácter general.

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.

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>

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.

Visualización de la instancia

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.

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.

   

Actualización de etiquetas de instancia y descripción

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 ""

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.

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.

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

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 la instancia.

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.

   

Actualizar

Actualmente no se admite la actualización de implementaciones de Operaciones de IoT de Azure existentes. En su lugar, desinstale y vuelva a implementar una nueva versión de Operaciones de IoT de Azure.

1. Use el comando az iot ops delete para eliminar la implementación de Operaciones de IoT de Azure en el clúster.

   az iot ops delete --cluster <CLUSTER_NAME> --resource-group <RESOURCE_GROUP>
   

2. Actualice la extensión de la CLI para obtener la versión más reciente de Operaciones de IoT de Azure.

   az extension update --name azure-iot-ops
   

3. Siga los pasos de este artículo para implementar la versión más reciente de Operaciones de IoT de Azure en el clúster.

   Sugerencia

   Agregue la marca --ensure-latest al comando az iot ops init para comprobar que está instalada la versión más reciente de la CLI de Operaciones de IoT de Azure y generar un error si hay disponible una actualización.