Implementación de operaciones de Azure IoT en un clúster de prueba

Aprenda a implementar Operaciones de IoT de Azure en un clúster de prueba, que es un clúster de Kubernetes habilitado para Arc que puede usar para escenarios de prueba y evaluación.

Si desea implementar Operaciones de IoT de Azure en un clúster de producción, consulte Deploy Operaciones de IoT de Azure en un clúster de producción.

Antes de empezar

En este artículo se describe Operaciones de IoT de Azure deployments y instances, que son dos conceptos diferentes:

• Un Operaciones de IoT de Azure deployment describe todos los componentes y recursos que habilitan el escenario de Operaciones de IoT de Azure. Estos componentes y recursos incluyen:

  • Una instancia de Operaciones de IoT de Azure
  • Extensiones de Arc
  • Ubicaciones personalizadas
  • Recursos que puede configurar en la solución de Operaciones de IoT de Azure, como recursos y dispositivos.

• Un Operaciones de IoT de Azure instance es el recurso primario que agrupa el conjunto de servicios definidos en ¿Qué es Operaciones de IoT de Azure? como el agente MQTT, los flujos de datos y el conector para OPC UA.

Cuando hablamos sobre la implementación de Operaciones de IoT de Azure, significamos el conjunto completo de componentes que componen un deployment. Una vez que exista la implementación, puede ver, administrar y actualizar la instancia.

Prerrequisitos

Recursos en la nube:

• Una suscripción Azure. Si no tiene una suscripción de Azure, cree una gratuita antes de comenzar.

• Los permisos de acceso de Azure. Para obtener más información, consulte Introducción a la implementación > Permisos necesarios.

Recursos de desarrollo:

• CLI de Azure está instalado en la máquina de desarrollo. Consulta las extensiones disponibles de CLI de Azure para la versión mínima requerida para usar la extensión azure-iot-ops. 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
  

Un host de clúster:

• Tener un clúster de Kubernetes habilitado con Azure Arc, con las características de ubicación personalizada e identidad de trabajo habilitadas. Si no tiene ninguno, siga los pasos descritos en Prepare el clúster de Kubernetes habilitado para Azure Arc.

  Si implementó Operaciones de IoT de Azure en el clúster anteriormente, desinstale esos recursos antes de continuar. Para obtener más información, vea Update Operaciones de IoT de Azure.

Cardinalidad automática

Para determinar automáticamente la cardinalidad inicial durante la implementación, omita el cardinality campo en el recurso broker. El operador del broker MQTT despliega la cantidad adecuada de pods en función del número de nodos disponibles en el momento del despliegue. Esta funcionalidad es útil para escenarios que no son de producción en los que no es necesario ajustar la alta disponibilidad ni la configuración de escalado.

Para usar la cardinalidad automática, prepare un archivo de configuración de Broker en formato JSON que omita el cardinality campo. Por ejemplo, establezca solo el perfil de memoria:

{
  "memoryProfile": "Medium"
}

A continuación, implemente con la --broker-config-file marca (se omiten otros parámetros para mayor brevedad):

az iot ops create ... --broker-config-file <FILE>.json

Para obtener más información, consulte la sección sobre la compatibilidad del CLI de Azure con la configuración avanzada del agente MQTT.

Implementación en Azure portal

Aspectos básicos

La experiencia de implementación del portal de Azure es una herramienta auxiliar que genera un comando de implementación basado en los recursos y la configuración. El último paso es ejecutar un comando CLI de Azure, por lo que todavía necesita los requisitos previos CLI de Azure descritos en la sección anterior.

1. Inicie sesión en Azure portal.

2. En el cuadro de búsqueda, busque y seleccione Operaciones de IoT de Azure.

3. Selecciona Crear.

4. En la pestaña Básico, especifique la siguiente información:

   Parámetro	Importancia
   Suscripción	Seleccione la suscripción que contiene el clúster habilitado para Arc.
   Grupo de recursos	Seleccione el grupo de recursos que contiene el clúster habilitado para Arc.
   Nombre del clúster	Seleccione el clúster en el que desea implementar Operaciones de IoT de Azure.
   Nombre de ubicación personalizada	Opcional: Reemplace el nombre predeterminado de la ubicación personalizada.
   Versión de implementación	Seleccione la versión 1.2 (más reciente). Para más información, consulte Versiones de operaciones de IoT.
   Despliegue de componentes opcionales > conector OPC UA	Elija implementar el conector opcional para el componente OPC UA.

5. Seleccione Siguiente: Configuración.

Configuration

1. En la pestaña Configuración, proporcione la siguiente información:

   Parámetro	Importancia
   Nombre de Operaciones de IoT de Azure	Optional: reemplace el nombre predeterminado de la instancia de Operaciones de IoT de Azure.
   Configuración del agente MQTT	Opcional: edite la configuración predeterminada para el corredor MQTT. En Azure portal, es posible configurar cardinality y memory profile. Para configurar otras opciones, como el búfer de mensajes con respaldo en disco y las opciones avanzadas del cliente MQTT, consulte la documentación de CLI de Azure para la configuración avanzada del agente MQTT.
   Configuración del perfil de flujo de datos	Opcional: edite la configuración predeterminada para los flujos de datos. Para más información, consulte Configuración del perfil de flujo de datos.

   

2. Seleccione Siguiente: Administración de dependencias.

Administración de dependencias

1. En la pestaña Administración de dependencias, seleccione un registro de esquemas existente o siga estos pasos para crear uno:

   1. Seleccione Crear nuevo.

   2. Introduzca un nombre del registro de esquemas y un espacio de nombres del registro de esquemas.

   3. Seleccione Seleccionar Azure Storage contenedor.

   4. Elija una cuenta de almacenamiento en la lista de cuentas de espacio de nombres jerárquico o seleccione Crear para crear una.

      El registro de esquema requiere una cuenta de Azure Storage con el espacio de nombres jerárquico y el acceso a la red pública habilitados. Al crear una nueva cuenta de almacenamiento, elija un tipo de cuenta de almacenamiento de Propósito general v2 y establezca Espacio de nombres jerárquico en Habilitado.

      Para más información sobre cómo configurar la cuenta de almacenamiento, consulte Directrices de implementación de producción.

   5. Seleccione un contenedor en la cuenta de almacenamiento o seleccione Contenedor para crear uno.

   6. Seleccione Aplicar para confirmar las configuraciones del registro de esquema.

2. Operaciones de IoT de Azure usa namespaces para organizar recursos y dispositivos. Cada instancia de Operaciones de IoT de Azure usa un único espacio de nombres para sus recursos y dispositivos. En la pestaña Administración de dependencias, seleccione un espacio de nombres Azure Registro de dispositivos existente o siga estos pasos para crear uno:

   1. Seleccione Crear nuevo.

   2. En la pestaña Básico, especifique la siguiente información:

      Parámetro	Importancia
      Suscripción	Seleccione su suscripción.
      Grupo de recursos	Seleccione el grupo de recursos que contiene la instancia de Operaciones de IoT de Azure.
      Nombre	Escriba un nombre único para el espacio de nombres.
      Region	Seleccione la región de Azure para almacenar el espacio de nombres.

      Seleccione Next (Siguiente) para continuar.

   3. En la pestaña Etiquetas , puede agregar etiquetas opcionalmente al espacio de nombres. Seleccione Next (Siguiente) para continuar.

   4. En la pestaña Revisar y crear , revise las configuraciones y seleccione Crear para crear el espacio de nombres.

   5. De nuevo en la pestaña Administración de dependencias , seleccione el espacio de nombres recién creado en la lista.

Opciones de implementación

1. En la pestaña Administración de dependencias , seleccione la opción Implementación de configuración de pruebas . Esta opción usa la configuración predeterminada que se recomienda para realizar pruebas.

   captura de pantalla

2. Seleccione Siguiente: Automatización.

Ejecución de comandos de CLI de Azure

El último paso de la experiencia de implementación del portal de Azure consiste en ejecutar un conjunto de comandos de CLI de Azure para implementar Operaciones de IoT de Azure en el clúster. El portal genera estos comandos en función de la información que proporcione en los pasos anteriores.

De uno en uno, ejecute cada comando CLI de Azure en la pestaña Automation en un terminal:

1. Inicie sesión en CLI de Azure interactivamente con un explorador aunque ya haya iniciado sesión antes. Si no inicia sesión de forma interactiva, es posible que reciba un error que indica Que el dispositivo debe administrarse para acceder al recurso.

   az login
   

2. Instale la extensión de la CLI de Operaciones de IoT de Azure más reciente si aún no lo ha hecho.

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

3. Copie y ejecute el comando proporcionado az iot ops schema registry create para crear un registro de esquema que es utilizado por los componentes de Operaciones de IoT de Azure. Si decide usar un registro de esquema existente, este comando no se muestra en la pestaña Automatización.

4. Prepare el clúster para la implementación de Operaciones de IoT de Azure. Copie y ejecute el comando az iot ops init proporcionado.

   Sugerencia

   El comando init solo debe ejecutarse una vez por clúster. Si ha seguido el requisito opcional previo para configurar su propia autoridad certificadora, siga los pasos descritos en Usar su propio emisor.

   Este comando puede tardar varios minutos en completarse. Puede ver el progreso en la pantalla de progreso de implementación en el terminal.

5. Para implementar Operaciones de IoT de Azure, copie y ejecute el comando az iot ops create proporcionado. Este comando puede tardar varios minutos en completarse. Puede ver el progreso en la pantalla de progreso de implementación en el terminal.

6. Una vez que todos los comandos de CLI de Azure se completen correctamente, puede cerrar el asistente Install Operaciones de IoT de Azure.

Una vez que el comando create se completa correctamente, tiene una instancia de Operaciones de IoT de Azure en funcionamiento que se ejecuta en el clúster. En este momento, la instancia está configurada para la mayoría de los escenarios de prueba y evaluación.

Comprobación de la implementación

Una vez finalizada la implementación, use az iot ops check para evaluar la implementación del servicio IoT Operations para el estado, la configuración y la facilidad de uso. El check comando le ayuda a encontrar problemas en la implementación y configuración.

az iot ops check

El check comando informa que las comprobaciones de flujo de datos se han omitido cuando aún no hay flujos de datos, lo cual es normal y esperado hasta que creas un flujo de datos. Para más información, consulte Procesamiento y enrutamiento de datos con flujos de datos.

Para comprobar la configuración de los mapas de temas, la QoS y las rutas de mensajes, agregue el parámetro --detail-level 2 al comando check para obtener una salida detallada.

Para ver todas las versiones de la extensión de la CLI de Operaciones de IoT de Azure que están disponibles, ejecute el siguiente comando:

az iot ops get-versions

Pasos siguientes

• Configura la observabilidad para habilitar la monitorización y los paneles.
• La instancia de Operaciones de IoT de Azure que implementó está configurada para escenarios de prueba. Si desea habilitar la configuración segura y preparar la instancia para escenarios de producción, siga los pasos descritos en Habilitación de la configuración segura en una instancia de Operaciones de IoT de Azure existente.