Ir al contenido
ELYRA

Hosts SSH

Registre las máquinas a las que accede por SSH y conéctese a ellas desde la app.

Ver Markdown

Un host SSH es una máquina a la que Elyra accede por la red para ejecutar el trabajo pesado: el proyecto, las terminales y los comandos de Git ocurren en el host, no en su computadora. Registrar el host es el paso que permite abrir un proyecto remoto, crear un workspace remoto y usar la terminal allí.

Cuándo usarlo

  • El proyecto vive en una máquina de desarrollo, un VPS o un servidor de compilación.
  • Quiere la potencia del servidor (CPU, memoria, GPU, entorno ya preparado) manteniendo la app en su escritorio.
  • Prefiere no clonar el repositorio otra vez en su computadora.

Requisitos previos

  • La app instalada y con licencia activa.
  • Acceso de red desde su computadora hasta el host.
  • Autenticación SSH ya resuelta en su computadora — la app reutiliza lo que su SSH ya sabe.
  • En el host: un sistema donde el auxiliar de Elyra pueda ejecutarse. Windows, macOS y Linux están en el conjunto de plataformas soportadas.

Registrar un host

  1. Abra Ajustes > Conexões > Hosts SSH (Ajustes > Conexiones > Hosts SSH).
  2. Elija una de las dos entradas:
    • Importar de ~/.ssh/config — la app lee los hosts que usted ya configuró y los trae a la lista. Es el camino recomendado cuando su SSH ya funciona en la terminal.
    • Añadir — registre un host nuevo indicando el destino.
  3. Ajuste lo que necesite y guarde.
  4. En la fila del host, use Connect para abrir la conexión, Test para comprobar el acceso sin entrar en el flujo de trabajo y Edit para corregir el registro.

Lo que el registro guarda es la configuración del host. La conexión en sí se abre y se cierra con los botones Connect y Disconnect.

La primera conexión a un host limpio

La primera conexión suele ser la más lenta, porque casi todo el trabajo ocurre del otro lado. La app instala un auxiliar versionado en el home del host, en ~/.elyra-remote/, y mantiene ese auxiliar en ejecución para que las terminales sobrevivan a una caída del SSH.

Si el host no tiene compilador, make ni Python, la instalación de los módulos nativos falla. En ese caso la app:

  1. comprueba qué falta en el host;
  2. arma el comando del gestor de paquetes detectado — directo si la cuenta es root, y con sudo -n si no lo es;
  3. pregunta una vez, mostrando el comando exacto que se ejecutará;
  4. si usted acepta, reintenta la instalación y continúa; si rechaza, muestra el comando para que lo ejecute a mano.

La respuesta se recuerda por host, así que la pregunta no vuelve en cada conexión. Sin nadie para responder — un proceso automático, por ejemplo — la respuesta es siempre no.

Mientras la conexión avanza

Mientras el host conecta, su tarjeta muestra en qué paso está la conexión. Esa información existe porque conectar a un host nuevo puede tardar de uno a tres minutos, y sin ella una conexión que avanza es indistinguible de una trabada.

Una vez conectado, la tarjeta vuelve a hablar de sincronización del workspace, no del paso de la conexión.

Resultado

  • El host aparece conectado en Ajustes > Conexões > Hosts SSH.
  • Queda disponible para Añadir proyecto > Otra máquina (SSH) y para nuevos workspaces con destino SSH.
  • Terminal, archivos y Git de las sesiones de ese host se ejecutan en la máquina remota.

Límites

  • Cada forma de autenticación depende de su SSH. La app reutiliza la configuración existente; cuando la autenticación exige interacción específica, usa el binario ssh del sistema.
  • Registrar un host no garantiza que esté disponible. Un host guardado no es un host en línea.
  • Disconnect no borra nada. Ni archivos, ni sesiones en ejecución en el host.
  • Los tiempos de espera del auxiliar (tiempo de inactividad, intentos) son decisiones de implementación y pueden cambiar entre releases.
  • Plataformas del host. El auxiliar de Elyra tiene builds para Windows, macOS y Linux.
  • Las credenciales no aparecen en esta documentación — ni claves, ni contraseñas, ni nombres de máquinas reales.

Cuando no conecta

  1. Lea el mensaje de error completo. Clasifica el motivo más común — por ejemplo, una clave protegida por contraseña que nadie informó. Cuando la app no reconoce el motivo, muestra el texto original, sin traducir, justamente para que usted pueda buscarlo o pegarlo en un reporte.
  2. Compruebe que su SSH funciona fuera de la app. Ejecute el mismo destino en la terminal del sistema. Si falla allí, el problema es la conexión, no Elyra.
  3. Si el error menciona una versión de auxiliar, el auxiliar instalado en el host y la app vienen de builds diferentes. Reconectar lo resuelve; el host instala la versión nueva.
  4. Si el host quedó a mitad de una instalación, una conexión lenta justo después de un reinicio suele ser un bloqueo de instalación huérfano. Esperar a que el bloqueo expire e intentar de nuevo es el camino.

Próximos pasos