--- title: Comando SSH description: "##### Descripción General El comando **SSH**pertenece a la categoría de **[comandos de Ejecución](https://www.stela.ai/wiki-categoria/ejecucion/)** en STELA. Su función es conectarse a un servidor remoto y ejecutar una instrucción o comando de consola de manera segura. Este comando utiliza las credenciales y…" url: "https://www.stela.ai/wiki/comando-ssh/" updated: "2026-09-04" category: Comandos de Ejecución --- # Comando SSH ##### Descripción General El comando **SSH**pertenece a la categoría de **[comandos de Ejecución](https://www.stela.ai/wiki-categoria/ejecucion/)** en STELA. Su función es conectarse a un servidor remoto y ejecutar una instrucción o comando de consola de manera segura. Este comando utiliza las credenciales y parámetros de red previamente cargados en la configuración del proyecto, por lo que no requiere exponer datos sensibles (como host, usuario o contraseñas) directamente en el flujo de automatización^. La respuesta generada por el servidor remoto se captura y se almacena en variables de STELA para su posterior validación o procesamiento^. ##### Ejemplo de Uso Rápido Imagina que durante una automatización necesitas verificar si un servicio de backend está activo en un servidor Linux o consultar el nombre del host remoto antes de procesar un lote de archivos: - Configuras un paso en tu flujo utilizando `{ssh}` con la instrucción `hostname` o `systemctl status mi-servicio`. - Especificas una variable (por ejemplo `@resultado_ssh`) para guardar la respuesta. - El robot ejecuta la orden en el servidor remoto y guarda la salida textual en el contenedor de variables, permitiéndote decidir si el flujo continúa o si debe reportar una alerta. ##### Parámetros y Opciones Detalladas Una vez configurada la conexión, puedes utilizar el comando SSH en tu automatización. Para encontrarlo, busca "ssh" en el panel de comandos. ![](https://www.stela.ai/wp-content/uploads/2025/07/image-12.webp) El comando SSH tiene los siguientes parámetros configurables: - **Instrucción (requerido)**: Este campo es donde ingresas el comando SSH que deseas ejecutar en el servidor remoto. ![](https://www.stela.ai/wp-content/uploads/2025/07/image-13.webp) - **Guardar Resultado**: Nombre del contenedor o etiqueta donde se almacenará la respuesta enviada por el servidor remoto. Si este campo se deja vacío, STELA guardará los datos utilizando la etiqueta por defecto `SSH`. ##### Ejemplos de Uso Avanzado A continuación, se presentan ejemplos prácticos de cómo utilizar el**comando SSH**y procesar sus resultados: ###### 1. Listar Archivos e Imprimir el Primer Elemento Este ejemplo muestra cómo ejecutar el comando `ls` para listar archivos y luego imprimir el primer archivo listado: - **Configuración del Comando SSH**: - En el campo "Instrucción", ingresa `ls`. - En el campo "Guardar Resultado", puedes especificar `@resultado` (aunque la función de guardar resultado no está operativa). - **Configuración del Comando Mensaje**: - Utiliza la siguiente estructura para leer la primera línea de la respuesta SSH: `{e: linea1/ssh/_wrk_datos.TMP}`. Esto imprimirá el primer elemento listado por el comando `ls`. Cuando ejecutas el comando SSH, automáticamente se generan variables con el prefijo "linea" y un número, junto con una variable `cant_lineas` que indica la cantidad total de líneas en la respuesta. Por ejemplo, si `ls` devuelve dos archivos, se crearán `linea1` y `linea2`, y `cant_lineas` será `2`. - **Resultado Esperado**: Si el comando `ls` lista `pub` como primer archivo, el mensaje mostrará: "El resultado de ssh es: pub". ###### 2. Recorrer e Imprimir Todos los Elementos Listados Este ejemplo demuestra cómo iterar a través de todas las líneas de la respuesta SSH y mostrarlas: - **Configuración del comando SSH**: - En el campo "Instrucción", ingresa `ls`. - **Inicialización de Contadores**: - Crea un comando "Guardar" para la variable `@Contador1` y establece su valor inicial en `0`. - Crea otro comando "Guardar" para la variable `@Contador2` y establece su valor inicial en `1`. - **Configuración del Comando** **"Mientras"**: - Configura la condición "Mientras" para que continúe mientras `@Contador1` sea menor o igual a `{e: cant_lineas/ssh/_wrk_datos.TMP}`. Esto asegura que se recorran todas las líneas de la respuesta SSH. - **Configuración del Comando** **Mensaje (dentro del bucle)**: - En el comando"Mensaje", utiliza la expresión `{e: linea@Contador2/Contadores/ssh/_wrk_datos.TMP}` para imprimir cada línea de la respuesta. - **Incremento de Contadores (dentro del bucle)**: - Después del Comando "Mensaje", añade un Comando "Calcular" para incrementar `@Contador1` en `1` (`@Contador1/Contadores + 1`). - Añade otro Comando "Calcular" para incrementar `@Contador2` en `1` (`@Contador2/Contadores + 1`). ## Errores Comunes y Soluciones - **Error: Fallo de autenticación o conexión rehusada al ejecutar el comando.** - **Causa:** Las credenciales (usuario, contraseña o clave privada) o los datos de red (host, puerto) configurados en el proyecto son incorrectos o el servidor remoto rechaza la conexión. - **Solución:** Ve a la **Configuración del Proyecto > SSH** y verifica que el Host, Puerto, Usuario y la Clave Privada/Contraseña sean válidos y tengan permisos para conectarse. - **Error: El robot no encuentra la variable con el resultado de la ejecución.** - **Causa:** Se intentó leer la variable con un nombre incorrecto o no se tomó en cuenta que la respuesta multilínea genera índices (`line1`, `line2`) en lugar de un único bloque de texto. - **Solución:** Si la respuesta contiene múltiples líneas, asegúrate de acceder a los datos usando las variables indexadas `line1`, `line2`, etc., o consulta `cant_lineas` para verificar la cantidad de elementos capturados. ##### Consideraciones Importantes - **Ejecución Remota No Soportada**: El Comando SSH no es compatible con la ejecución remota. Se recomienda descargar la automatización para su ejecución local.