Control de Servicios Unix
- Tipo de tarea: ssh_checkservice
Descripción
La tarea Control de Servicios Unix permite gestionar el estado de un servicio o demonio en una máquina local (modo Predeterminado) o en un servidor remoto a través de SSH.
Permite la ejecución de operaciones estándar en los servicios, como inicio, parada y verificación del estado, sin necesidad de especificar manualmente los comandos del sistema operativo.
Configuración
La configuración define la forma de ejecución (local o remota) y el servicio a gestionar. Los campos de configuración de la tarea pueden ser valorizados manualmente o a través de parámetros y variables del flujo de trabajo.
Conexión al Servidor (Conexión al Servidor)
- Modo de conexión: define el origen de las credenciales y el tipo de ejecución. Puede asumir tres modos operativos:
- Predeterminado: Los comandos se ejecutan en la máquina local, sin conexión SSH.
- Manual: Permite la inserción manual de los parámetros de conexión SSH.
- Entorno: Utiliza un entorno de conexión preconfigurado. En este modo se muestra un menú que enumera las conexiones disponibles en base al rol asociado al Workflow.
- Dirección IP: Dirección IP del servidor remoto.
- Nombre de host: Nombre de host del servidor remoto.
- Usuario: Nombre de usuario utilizado para establecer la conexión SSH.
- Contraseña: Contraseña asociada al usuario de conexión.
- Puerto: Puerto utilizado para la conexión SSH (el valor predeterminado es 22).
Ejecutar comando como otro usuario (Ejecutar comando como otro usuario)
Activando esta casilla, es posible ejecutar el comando de gestión del servicio con un usuario diferente al utilizado para la conexión SSH.
- Usuario: El nombre del usuario con el que se ejecutará el comando (ej. root).
- Contraseña: La contraseña del usuario especificado arriba.
Detalles de la Operación
- Operación: Un menú para seleccionar la acción a ejecutar en el servicio:
- Estado: Verifica el estado actual del servicio (ej. activo, inactivo, en carga).
- Iniciar: Inicia el servicio.
- Detener: Detiene el servicio.
- Nombre del servicio: El nombre del servicio en el que actuar, como es conocido por el sistema operativo (ej. httpd, apache2, postgresql, sshd).
Parámetros de Salida
Al completarse la ejecución, la tarea hace disponibles los siguientes Parámetros de Salida, utilizables como entrada en las tareas siguientes del Workflow.
- result: Contiene un mensaje de texto que describe el resultado de la operación o un mensaje de error (ej. “Dirección de servidor no encontrada”).
- resultJson: Representa el resultado de la ejecución de la tarea en formato JSON, incluyendo información general, configuraciones y detalles sobre la ejecución.
- exitStatus: Devuelve el código de salida del comando ejecutado. Un valor de 0 indica típicamente que la operación se ha ejecutado con éxito. Códigos diferentes pueden indicar varios estados (ej. "servicio ya detenido" o "servicio no encontrado").
Notas
La tarea establece una conexión SSH con el servidor remoto y ejecuta el comando de stop/start/status del servicio especificado en el servidor configurado. Si se utiliza la autenticación mediante claves SSH, es necesario que la clave pública esté registrada en el servidor remoto. Si la opción “Ejecutar comando como otro usuario” está habilitada, el comando se ejecuta con un usuario diferente al de la conexión SSH principal.