Introducción
Usa Ejecutar shell en otro dispositivo para ejecutar un script de shell en línea en un dispositivo ejecutor seleccionado en lugar del dispositivo que avanza por la automatización. Esto es útil cuando un comando necesita herramientas, acceso a la red o recursos disponibles en un dispositivo dedicado.
La automatización mantiene el contexto del dispositivo que entró en el flujo de trabajo. Las variables del sistema, los campos personalizados y las variables de automatización se resuelven desde ese dispositivo del flujo de trabajo antes de que el script de shell se ejecute en el ejecutor.
Agregar la Acción
Abre la automatización y selecciona Editar.
Selecciona + donde deseas agregar la acción.
En la Sistema categoría, selecciona Ejecutar shell en otro dispositivo.
En Dispositivo ejecutor, busca y selecciona el dispositivo que ejecutará el script de shell.
Selecciona el lenguaje, el tiempo de espera y el contexto de Ejecutar como contexto.
Ingresa el script en el editor.
Configura las condiciones y opciones adicionales, luego selecciona Guardar.
El ejecutor forma parte de la configuración de la acción. Cada dispositivo del flujo de trabajo que llega a esta acción envía su script de shell renderizado al ejecutor seleccionado.
Contexto del Dispositivo del Flujo de Trabajo y del Dispositivo Ejecutor
La ejecución remota separa el dispositivo que se administra del dispositivo que realiza el trabajo.
Contexto | Dispositivo utilizado |
Condiciones de activación y de acción | Dispositivo del flujo de trabajo |
Variables del sistema como | Dispositivo del flujo de trabajo |
Valores de campos personalizados | Dispositivo del flujo de trabajo |
Variables de automatización | Ejecución de automatización actual para el dispositivo del flujo de trabajo |
Ejecución de shell, sistema operativo, herramientas instaladas y acceso a la red | Dispositivo ejecutor |
Ejecutar como contexto de usuario | Dispositivo ejecutor |
ℹ️ NOTA: Una referencia como {{ level_device_hostname }} devuelve el nombre de host del dispositivo del flujo de trabajo, no el del ejecutor. Usa el ejecutor solo como el lugar donde se ejecuta el script de shell.
Ejemplo
Una automatización se ejecuta para una estación de trabajo que no puede llegar directamente a un sistema de administración interno. Se selecciona como ejecutor un servidor con las herramientas y el acceso a la red necesarios. El comando se ejecuta en el servidor mientras que una variable como {{ level_device_hostname }} sigue identificando la estación de trabajo que avanza por la automatización.
Configurar el Script de Shell
Elige el lenguaje, el tiempo de espera y el contexto de Ejecutar como contexto para el dispositivo ejecutor, luego ingresa tu script en el editor. Inserta variables del sistema, variables de automatización y campos personalizados con el selector de variables. Level renderiza esos valores desde el dispositivo del flujo de trabajo antes de enviar el script al ejecutor.
Consulta Acción de Shell para obtener detalles sobre lenguaje, editor, salida, código de salida, condición y opciones adicionales que también aplican aquí.
Capturar Salida
Usa Asignar salida de acción a variable para almacenar la salida estándar del ejecutor en una variable de automatización. El valor queda disponible para las acciones posteriores en la ejecución de automatización del dispositivo del flujo de trabajo.
Disponibilidad del Ejecutor y Fallos
El ejecutor debe estar disponible para recibir y ejecutar la acción. Si no responde, Level reintenta antes de que la acción agote el tiempo de espera y se marque como fallida. La configuración de En caso de fallo de la acción, reintento y configuración de tiempo de espera determinan qué hace la automatización a continuación.
El código de salida del script de shell se evalúa según su ejecución en el ejecutor:
Código de salida | Resultado |
0 | Acción marcada como exitosa |
Distinto de cero | Acción marcada como fallida |
Uso del Dispositivo Ejecutor
Level registra cuándo un dispositivo se usa como ejecutor de automatización. Un ejecutor referenciado por una automatización activa no puede eliminarse hasta que se elimine o reemplace ese uso de automatización.
⚠️ ADVERTENCIA: Antes de cambiar o eliminar un ejecutor, revisa todas las automatizaciones que lo utilizan. Esas automatizaciones dependen de la disponibilidad del ejecutor, sus herramientas, sistema operativo y acceso a la red.
Preguntas frecuentes
¿El script de shell se ejecuta en ambos dispositivos? No. El ejecutor ejecuta el script. El dispositivo del flujo de trabajo proporciona el contexto de automatización y los valores de las variables.
¿Qué dispositivo describen las variables del sistema? Describen el dispositivo del flujo de trabajo que avanza por la automatización.
¿Qué sistema operativo y contexto de usuario aplican? El sistema operativo del dispositivo ejecutor y la configuración de Ejecutar como configuración seleccionada para la acción.
¿Dónde se almacena la salida capturada? Se almacena en la ejecución de automatización del dispositivo del flujo de trabajo y puede ser utilizada por acciones posteriores.
¿Por qué no puedo eliminar el dispositivo ejecutor? Una automatización activa todavía lo referencia. Abre el uso de automatización del dispositivo, luego elimina o reemplaza el ejecutor en esas automatizaciones.
Para detalles sobre variables, consulta Variables del Sistema y Variables de Automatización.