egutierrez
560cbf280e
Conjunto completo de funciones SSH para operaciones remotas: conexión, verificación de host, ejecución de comandos, transferencia de archivos (upload/download) y gestión de túneles. Incluye tipo SSHConn y tests. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
40 lines
1.3 KiB
Markdown
40 lines
1.3 KiB
Markdown
---
|
|
name: ssh_tunnel_open
|
|
kind: function
|
|
lang: go
|
|
domain: infra
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "func SSHTunnelOpen(conn SSHConn, localPort int, remoteHost string, remotePort int) (int, error)"
|
|
description: "Abre un tunel SSH (local port forwarding) en background. Retorna el PID del proceso para cerrarlo despues."
|
|
tags: [ssh, tunnel, port-forwarding, remote]
|
|
uses_functions: []
|
|
uses_types: [ssh_conn_go_infra]
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: [fmt, os/exec, strings, time]
|
|
tested: true
|
|
tests: ["abre tunel y lo cierra"]
|
|
test_file_path: "functions/infra/ssh_tunnel_test.go"
|
|
file_path: "functions/infra/ssh_tunnel_open.go"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
conn := SSHConn{Host: "bastion.example.com", User: "deploy"}
|
|
// Tunel: localhost:5432 -> db-server:5432 via bastion
|
|
pid, err := SSHTunnelOpen(conn, 5432, "db-server", 5432)
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
fmt.Println("tunnel PID:", pid)
|
|
// Usar localhost:5432 para conectar a la BD remota
|
|
// Cerrar con SSHTunnelClose(pid)
|
|
```
|
|
|
|
## Notas
|
|
|
|
Usa ssh -N -f -L para crear el tunel en background. ExitOnForwardFailure=yes falla inmediatamente si el puerto local esta ocupado. remoteHost vacio se interpreta como "localhost" (el servidor SSH mismo). El PID se obtiene buscando el proceso ssh en la tabla de procesos.
|