Búsqueda de Texto en Unix

• Tipo de tarea: ssh_searchtext

Descripción

La tarea Búsqueda de Texto en Unix permite buscar una cadena o patrón de texto dentro de un archivo, ya sea en un servidor remoto (a través de SSH) o en la máquina local (modo Predeterminado).

Puede ser utilizada para analizar archivos de registro, identificar mensajes de error o verificar la presencia de información específica en archivos de configuración o de texto.

Configuración

La configuración de la tarea define los detalles de la conexión (si es necesaria), el archivo a analizar y el texto a buscar. Los campos de configuración de la tarea pueden ser valorados manualmente o a través de parámetros y variables del flujo de trabajo.

Conexión al Servidor

• Modo de conexión: define el origen de las credenciales utilizadas para la conexión. Puede asumir tres modos operativos:
• Predeterminado: la búsqueda se ejecuta 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

Activando esta casilla de verificación, es posible ejecutar la búsqueda con un usuario diferente al utilizado para la conexión SSH.

• Usuario: nombre del usuario con el que se ejecutará el comando.
• Contraseña: contraseña del usuario utilizado para la ejecución del comando.

Detalles de la Búsqueda

• Ruta del archivo: la ruta completa del archivo en el servidor remoto donde se realizará la búsqueda del texto.
• Patrón: el texto o la expresión que se buscará dentro del archivo. Junto al campo de texto, un menú permite especificar la modalidad de búsqueda:
• Cadena: la búsqueda tratará el patrón como una simple cadena de texto literal.
• Expresión Regular: la búsqueda interpretará el patrón como una expresión regular, permitiendo búsquedas mucho más complejas y flexibles.
• Límite de líneas: activando la casilla de verificación, es posible especificar el número máximo de líneas que corresponden al patrón que el Task debe devolver. Si no está activado, se devolverán todas las líneas encontradas.

Parámetros de Salida

Al finalizar la búsqueda, la tarea expone los siguientes parámetros de salida, proporcionando no solo las líneas encontradas sino también datos cuantitativos sobre la búsqueda:

• result: contiene un mensaje de texto que describe el resultado de la operación.
• 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.
• occurrences: un contador numérico que indica el número total de veces en que el Patrón fue encontrado. Esto es particularmente útil porque, si una sola línea contiene múltiples veces el patrón, occurrences las contará todas, mientras que result devolverá la línea una sola vez.
• exitStatus: devuelve el código de salida del comando grep ejecutado en el servidor.
• 0: indica que se encontró al menos una coincidencia.
• 1: indica que no se encontró ninguna coincidencia (esto, para grep, no es un error de ejecución).
• Valores mayores de 1: indican un error de sintaxis o un problema en el acceso al archivo.

Ejemplo parámetro resultJson

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}

Nota

• La tarea ejecuta un comando de búsqueda en el archivo configurado, localmente o a través de una conexión SSH.
• Si utiliza una conexión remota con autenticación mediante claves SSH, es necesario que la clave pública esté registrada en el servidor.
• Si la opción “Ejecutar comando como otro usuario” está habilitada, el comando se ejecuta con un usuario diferente al de la conexión principal.
• En modo Predeterminado, la búsqueda se ejecuta en la máquina local y no se requiere ninguna conexión SSH.