Administrar configuraciones de recursos de forma remota
Importante
Operaciones de IoT de Azure, habilitado 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.
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.
Un recurso en la versión preliminar de Operaciones de IoT de Azure es una entidad lógica que se crea para representar un recurso real. Un recurso de Operaciones de IoT de Azure puede tener propiedades, etiquetas y eventos que describen su comportamiento y características.
Los servidores OPC UA son aplicaciones de software que se comunican con recursos. Los servidores de OPC UA exponen etiquetas de OPC UA que representan puntos de datos. Las etiquetas de OPC UA proporcionan datos históricos o en tiempo real acerca del estado, rendimiento, la calidad o la condición de los recursos.
Un punto de conexión de recurso es un recurso personalizado en el clúster de Kubernetes que conecta los servidores de OPC UA a los módulos del conector de OPC UA. Esta conexión permite que un conector de OPC UA acceda a los puntos de datos de un recurso. Sin un punto de conexión de recurso, los datos no pueden fluir desde un servidor OPC UA a la instancia de Azure IoT OPC UA Broker (versión preliminar) y a la instancia de Azure IoT MQ (versión preliminar). Después de configurar los recursos personalizados en el clúster, se establece una conexión al servidor OPC UA de bajada y el servidor reenvía la telemetría a la instancia de OPC UA Broker.
Un sitio es una colección de instancias de Operaciones de IoT de Azure. Los sitios le ayudan a organizar las instancias y administrar el control de acceso. El administrador de TI crea sitios, les asigna instancias y concede acceso a los usuarios de OT de la organización.
En el portal de Operaciones de IoT de Azure (versión preliminar), una instancia representa un clúster de Operaciones de IoT de Azure. Una instancia puede tener uno o varios puntos de conexión de recursos.
En este artículo, se describe cómo usar el portal de Operaciones de IoT de Azure (versión preliminar) y la CLI de Azure para:
- Definición de puntos de conexión de recursos
- Agregar recursos y definir etiquetas y eventos
Estos recursos, etiquetas y eventos asignan datos entrantes de servidores de OPC UA a nombres descriptivos que puede usar en las canalizaciones MQ broker y Azure IoT Data Processor (versión preliminar).
Requisitos previos
Para configurar un punto de conexión de recursos, necesita una instancia en ejecución de Operaciones de IoT de Azure.
Iniciar sesión
Para iniciar sesión en el portal de Operaciones de IoT de Azure (versión preliminar), vaya al portal Operaciones de IoT de Azure (versión preliminar) en el explorador e inicie sesión con sus credenciales de Microsoft Entra ID.
Selección del sitio
Después de iniciar sesión, en el portal se muestra una lista de sitios a los que tiene acceso. Cada sitio es una colección de instancias de Operaciones de IoT de Azure en las que puede configurar los recursos. El administrador de TI es responsable de organizar las instancias en los sitios y de conceder acceso a los usuarios de OT de la organización. Las instancias que no forman parte de un sitio aparecen en el nodo Instancias sin asignar. Seleccione el sitio que quiera usar:
Sugerencia
Puede usar el cuadro de filtro para buscar sitios.
Si no ve ningún sitio, es posible que no esté en el inquilino de Azure Active Directory correcto. Puede cambiar el inquilino en el menú superior derecho del portal. Si todavía no ve ningún sitio, significa que aún no se le ha agregado a ninguno. Póngase en contacto con el administrador de TI para solicitar acceso.
Selección de la instancia
Después de seleccionar un sitio, en el portal se muestra una lista de las instancias de Operaciones de IoT de Azure que forman parte del sitio. Seleccione la instancia que quiera usar:
Sugerencia
Puede usar el cuadro de filtro para buscar instancias.
Creación de un punto de conexión de recurso
De forma predeterminada, una implementación de Operaciones de IoT de Azure incluye un simulador OPC PLC integrado. Para crear un punto de conexión de recurso que use el simulador integrado de OPC PLC:
Seleccione Puntos de conexión de recursos y, a continuación, Crear punto de conexión de recurso:
Sugerencia
Puede usar el cuadro de filtro para buscar puntos de conexión de recursos.
Escriba la siguiente información del punto de conexión:
Campo Valor Nombre opc-ua-connector-0Dirección URL del agente de OPC UA opc.tcp://opcplc-000000:50000Autenticación de usuarios AnonymousAutenticación de transporte Do not use transport authentication certificatePara guardar la definición, seleccione Crear.
Con esta configuración, se implementa un nuevo recurso assetendpointprofile denominado opc-ua-connector-0 en el clúster. Después de definir un recurso, un pod del conector de OPC UA lo detecta. El pod usa el punto de conexión de recurso que se especifica en la definición de recurso para conectarse a un servidor de OPC UA.
Cuando el simulador de OPC PLC está en ejecución, los datos fluyen desde el simulador hasta el conector, el agente de OPC UA y, finalmente, el agente MQ.
Configuración de un punto de conexión de recurso para usar un nombre de usuario y una contraseña
En el ejemplo anterior se usa el modo de autenticación Anonymous. Este modo no requiere un nombre de usuario ni una contraseña.
Para usar el modo de autenticación UsernamePassword, complete los pasos siguientes:
- Siga los pasos descritos en Configuración de la autenticación de usuario de OPC UA con un nombre de usuario y contraseña para agregar secretos para el nombre de usuario y la contraseña en Azure Key Vault y proyectarlos en el clúster de Kubernetes.
- En el portal Operaciones de IoT de Azure (versión preliminar), seleccione Nombre de usuario y contraseña para el campo Autenticación de usuario a fin de configurar el punto de conexión del recurso para usar estos secretos. A continuación, escriba los siguientes valores para los campos Referencia de nombre de usuario y Referencia de contraseña:
| Campo | Value |
|---|---|
| Referencia de nombre de usuario | aio-opc-ua-broker-user-authentication/username |
| Referencia de contraseña | aio-opc-ua-broker-user-authentication/password |
Configuración de un punto de conexión de recurso para usar un certificado de autenticación de transporte
Para configurar el punto de conexión del recurso para usar un certificado de autenticación de transporte, siga estos pasos:
- Siga los pasos descritos en cómo configurar la confianza mutua para agregar un certificado de transporte y una clave privada a Azure Key Vault y proyectarlos en el clúster de Kubernetes.
- En el portal Operaciones de IoT de Azure (versión preliminar), seleccione Usar certificado de autenticación de transporte para el campo Autenticación de transporte y escriba la huella digital del certificado.
Agregar un recurso, etiquetas y eventos
Para agregar un recurso en el portal Operaciones de IoT de Azure (versión preliminar):
Seleccione la pestaña Recursos . Antes de crear cualquier recurso, verá la siguiente pantalla:
Sugerencia
Puede usar el cuadro de filtro para buscar recursos.
Seleccione Crear recurso.
En la pantalla de detalles del recurso, escriba la siguiente información del recurso:
- Nombre de activo
- Punto de conexión del recurso. Seleccione el punto de conexión del recurso en la lista.
- Descripción
Configure el conjunto de propiedades que desea asociar al recurso. Puede aceptar la lista predeterminada de propiedades o agregar su propia lista. Las siguientes propiedades están disponibles de forma predeterminada:
- Fabricante
- URI del fabricante
- Modelo
- Código del producto
- Versión de hardware
- Versión del software
- Número de serie
- URI de la documentación
Seleccione Siguiente para ir a la página Agregar etiquetas.
Adición de etiquetas individuales a un recurso
Ahora puede definir las etiquetas asociadas al recurso. Para agregar etiquetas de OPC UA:
Seleccione Agregar etiqueta o CSV > Agregar etiqueta.
Escriba los detalles de la etiqueta:
- Id. de nodo. Este valor es el identificador de nodo del servidor OPC UA.
- Nombre de etiqueta (opcional). Este valor es el nombre descriptivo que desea usar para la etiqueta. Si no especifica un nombre de etiqueta, el identificador de nodo se usa como nombre de etiqueta.
- Modo de observabilidad (opcional) con las siguientes opciones:
- Ninguno
- Indicador
- Contador
- Histograma
- Registro
- Intervalo de muestreo (milisegundos). Puede invalidar el valor predeterminado de esta etiqueta.
- Tamaño de cola. Puede invalidar el valor predeterminado de esta etiqueta.
En la tabla siguiente, se muestran algunos valores de etiqueta de ejemplo que puede usar con el simulador integrado de OPC PLC:
Id. de nodo Nombre de etiqueta Modo de observabilidad ns=3;s=FastUInt10 temperatura None ns=3;s=FastUInt100 Etiqueta 10 None Seleccione Administrar la configuración predeterminada para configurar los valores de telemetría predeterminados para el recurso. Esta configuración se aplica a todas las etiquetas de OPC UA que pertenecen al recurso. Puede invalidar esta configuración para cada etiqueta que agregue. La configuración de telemetría predeterminada incluye:
- intervalo de muestreo (milisegundos): el intervalo de muestreo indica la velocidad más rápida a la que el servidor OPC UA debe muestrear su origen subyacente para los cambios de datos.
- Intervalo de publicación (milisegundos):velocidad a la que el servidor OPC UA debe publicar datos.
- Tamaño de cola: la profundidad de la cola que contiene los datos de muestreo antes de publicarlos.
Agregue etiquetas de forma masiva a un recurso
Puede importar hasta 1000 etiquetas de OPC UA a la vez desde un archivo CSV:
Cree un archivo CSV similar al ejemplo siguiente:
NodeID TagName Milisegundos de intervalo de muestreo QueueSize ObservabilityMode ns=3; s=FastUInt1000 Etiqueta 1000 1 000 5 None ns=3; s=FastUInt1001 Etiqueta 1001 1 000 5 None ns=3; s=FastUInt1002 Etiqueta 1002 5000 10 None Seleccione Agregar etiqueta o CSV > Importar archivo CSV (.csv). Seleccione el archivo CSV que creó y seleccione Abrir. Las etiquetas definidas en el archivo CSV se importan:
Si importa un archivo .csv que contenga etiquetas duplicadas de etiquetas existentes, el portal Operaciones de IoT de Azure (versión preliminar) muestra el mensaje siguiente:
Puede reemplazar las etiquetas duplicadas y agregar nuevas etiquetas desde el archivo de importación, o bien puede cancelar la importación.
Para exportar todas las etiquetas de un recurso a un archivo CSV, seleccione Exportar todo y elija una ubicación para el archivo:
En la página Etiquetas, seleccione Siguiente para ir a la página Agregar eventos.
Sugerencia
Puede usar el cuadro de filtro para buscar etiquetas.
Agregar eventos individuales a un recurso
Ahora puede definir los eventos asociados al recurso. Para agregar eventos de OPC UA:
Seleccione Agregar evento o CSV > Agregar evento.
Escriba los detalles del evento:
- Notificador de eventos. Este valor es el notificador de eventos del servidor OPC UA.
- Nombre del evento (opcional). Este valor es el nombre descriptivo que desea usar para el evento. Si no especifica un nombre de evento, el notificador de eventos se usa como nombre del evento.
- Modo de observabilidad (opcional) con las siguientes opciones:
- Ninguno
- Indicador
- Contador
- Histograma
- Registro
- Tamaño de cola. Puede invalidar el valor predeterminado de esta etiqueta.
Seleccione Administrar la configuración predeterminada para configurar los valores de eventos predeterminados para el recurso. Esta configuración se aplica a todos los eventos de OPC UA que pertenecen al recurso. Puede invalidar esta configuración para cada evento que agregue. La configuración de eventos predeterminada incluye:
- Intervalo de publicación (milisegundos):velocidad a la que el servidor OPC UA debe publicar datos.
- Tamaño de cola: la profundidad de la cola que contiene los datos de muestreo antes de publicarlos.
Agregue eventos de forma masiva a un recurso
Puede importar hasta 1000 eventos de OPC UA a la vez desde un archivo CSV.
Para exportar todos los eventos de un recurso a un archivo CSV, seleccione Exportar todo y elija una ubicación para el archivo.
En la página Eventos, seleccione Siguiente para ir a la página Revisar.
Sugerencia
Puede usar el cuadro de filtro para buscar eventos.
Revisar los cambios
Revise el recurso y los detalles del evento y la etiqueta OPC UA y realice los ajustes que necesite:
Actualización de un recurso
Busque y seleccione el recurso que creó anteriormente. Use las pestañas Detalles del recurso, Etiquetas y Eventos para realizar cualquier cambio:
En la pestaña Etiquetas, puede agregar etiquetas, actualizar etiquetas existentes o quitar etiquetas.
Para actualizar una etiqueta, seleccione una etiqueta existente y actualice la información de la etiqueta. A continuación, seleccione Actualizar:
Para quitar etiquetas, seleccione una o varias etiquetas y, a continuación, seleccione Quitar etiquetas:
También puede agregar, actualizar y eliminar eventos y propiedades de la misma manera.
Cuando haya terminado de realizar cambios, seleccione Guardar para guardar los cambios.
Eliminación de un recurso
Para eliminar un recurso, seleccione el recurso que desea eliminar. En la página Detalles del recurso, seleccione Eliminar. Confirme los cambios para eliminar el recurso:
Notificaciones
Cada vez que realice un cambio en el recurso en el portal Operaciones de IoT de Azure (versión preliminar), verá una notificación informando del estado de la operación:
