{"id":25597,"date":"2026-09-14T13:21:43","date_gmt":"2026-09-14T19:21:43","guid":{"rendered":"https:\/\/sada.services\/?p=25597"},"modified":"2026-09-22T09:06:13","modified_gmt":"2026-09-22T15:06:13","slug":"hpc-3-1-configurar-ssh-fs-en-vs-code","status":"publish","type":"post","link":"https:\/\/sada.services\/?p=25597","title":{"rendered":"HPC 3.1: Configurar SSH FS en VS Code"},"content":{"rendered":"\n

Esta gu\u00eda te ayuda a la configuracion del cl\u00faster Helix<\/strong> (nodo de login cicima-hpc<\/code>) mediante la extensi\u00f3n SSH FS<\/strong> de visual code.<\/p>\n\n\n\n

\n\n\n\n

\u00bfPor qu\u00e9 SSH FS y no Remote-SSH?<\/h2>\n\n\n\n

VS Code tiene dos formas de trabajar remoto:<\/p>\n\n\n\n

<\/th>SSH FS<\/strong> (recomendado en Helix)<\/th>Remote-SSH<\/strong> (no recomendado)<\/th><\/tr><\/thead>
D\u00f3nde corre VS Code<\/td>En tu m\u00e1quina local<\/td>Instala un servidor completo en el HPC<\/td><\/tr>
Uso de disco en el HPC<\/td>~0 (solo lee archivos por SFTP)<\/td>300 MB \u2013 1 GB por usuario en $HOME<\/code><\/td><\/tr>
Proceso corriendo en el nodo de login<\/td>Ninguno<\/td>Un node<\/code> residente mientras est\u00e9s conectado<\/td><\/tr>
Terminal integrada<\/td>Local<\/td>Remota<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Los administradores de Helix piden usar SSH FS<\/strong> para no llenar el $HOME<\/code> compartido con carpetas .vscode-server<\/code> que crecen sin control. Esta gu\u00eda sigue esa recomendaci\u00f3n.<\/p>\n\n\n\n

\n\n\n\n

Prerrequisitos<\/h2>\n\n\n\n

Antes de empezar debes tener:<\/p>\n\n\n\n

    \n
  • VS Code instalado.<\/li>\n\n\n\n
  • Cuenta activa en el cl\u00faster Helix.<\/li>\n\n\n\n
  • Una llave SSH generada (t\u00edpicamente en ~\/.ssh\/una_tavo_ed25519<\/code> o similar).<\/li>\n\n\n\n
  • La llave p\u00fablica ya cargada en el servidor (ssh-copy-id<\/code> o pegada en ~\/.ssh\/authorized_keys<\/code> del HPC).<\/li>\n\n\n\n
  • Preferiblemente keychain<\/code> instalado y configurado para no tipear passphrase en cada conexi\u00f3n.<\/li>\n<\/ul>\n\n\n\n

    Paso 1 \u2014 Verificar que SSH funciona desde terminal<\/h2>\n\n\n\n

    Antes de configurar VS Code, confirma que puedes entrar al cl\u00faster desde la l\u00ednea de comandos. Si esto no funciona, tampoco va a funcionar en VS Code.<\/p>\n\n\n\n

    Abre una terminal y ejecuta:<\/p>\n\n\n\n

    bash<\/p>\n\n\n\n

    ssh hpc<\/code><\/pre>\n\n\n\n
    Si tienes el alias configurado en ~\/.ssh\/config<\/code>, esto deber\u00eda entrar directo sin pedir contrase\u00f1a.<\/p>\n\n\n\n
    Si no tienes el alias<\/strong>, prueba con usuario + IP directo:<\/p>\n\n\n\n
    ssh gustavo.matamoros.gonzalez@10.10.132.5<\/code><\/pre>\n\n\n\n
    Paso 2 \u2014 Configurar ~\/.ssh\/config<\/code> con un alias corto<\/h2>\n\n\n\n
    Para no repetir usuario + host + llave en cada comando, define un alias en tu configuraci\u00f3n SSH local.<\/p>\n\n\n\n
    Abre (o crea) el archivo:<\/p>\n\n\n\n
    nano ~\/.ssh\/config<\/code><\/pre>\n\n\n\n
    Agrega el siguiente bloque:<\/p>\n\n\n\n
    Ajusta:<\/p>\n\n\n\n
      \n
    • La IP en HostName<\/code>  (ssh hpc \u00abhostname -I\u00bb)<\/li>\n\n\n\n
    • Tu usuario en User<\/code>.<\/li>\n\n\n\n
    • El path de tu llave privada en IdentityFile<\/code>.<\/li>\n<\/ul>\n\n\n\n
      Host hpc\n    HostName 10.10.132.5\n    User gustavo.matamoros.gonzalez\n    IdentityFile ~\/.ssh\/una_tavo_ed25519\n    IdentitiesOnly yes\n    ServerAliveInterval 60\n    ServerAliveCountMax 3\n<\/code><\/pre>\n\n\n\n
      Importante \u2014 mant\u00e9n el nombre cicima-hpc<\/code>.<\/strong> Los archivos tasks.json<\/code> que crearemos despu\u00e9s referencian ese nombre exacto. Si le pones otro, tendr\u00e1s que cambiarlo en cada tarea.<\/p>\n\n\n\n
      Ajusta los permisos:<\/p>\n\n\n\n
      chmod 600 ~\/.ssh\/config\n<\/code><\/pre>\n\n\n\n
      Prueba con el alias:<\/p>\n\n\n\n
      ssh hpc<\/code><\/pre>\n\n\n\n
      Si entra directo, est\u00e1s listo para instalar la extensi\u00f3n.<\/p>\n\n\n\n
      \n\n\n\n
      Paso 3 \u2014 Instalar la extensi\u00f3n SSH FS<\/h2>\n\n\n\n
        \n
      1. Abre VS Code.<\/li>\n\n\n\n
      2. Pulsa Ctrl+Shift+X<\/code> para abrir el panel de extensiones.<\/li>\n\n\n\n
      3. En el buscador, escribe: SSH FS<\/strong><\/li>\n\n\n\n
      4. Instala la que dice \u00abSSH FS\u00bb<\/strong> de Kelvin Schoofs<\/strong> (ID: Kelvin.vscode-sshfs<\/code>).<\/li>\n\n\n\n
      5. Espera a que termine la instalaci\u00f3n. No necesitas reiniciar VS Code.<\/li>\n<\/ol>\n\n\n\n
        \"\"<\/figure>\n\n\n\n
        Al instalar, aparece un \u00edcono nuevo en la barra lateral izquierda: parece un servidor con un enchufe. Ese es el panel de SSH FS.<\/p>\n\n\n\n
        <\/p>\n\n\n\n
        \"\"<\/figure>\n\n\n\n
        Paso 4 \u2014 Crear la configuraci\u00f3n de conexi\u00f3n en SSH FS<\/h2>\n\n\n\n
          \n
        1. Click en el \u00edcono de SSH FS en la barra lateral izquierda. Si no lo ves, presiona Ctrl+Shift+P<\/code> y busca \u00abSSH FS: Focus on Configurations View\u00bb<\/strong>.<\/li>\n<\/ol>\n\n\n\n
          \"\"<\/figure>\n\n\n\n
            \n
          1. Ver\u00e1s una secci\u00f3n CONFIGURATIONS<\/strong> con un bot\u00f3n +<\/code> (Add configuration). Click en el +<\/code>.<\/li>\n<\/ol>\n\n\n\n
            \"\"<\/figure>\n\n\n\n
            <\/p>\n\n\n\n
              \n
            1. Se abre un editor con el nombre de la configuraci\u00f3n.\n
                \n
              1. Name: hpc<\/code> (\u26a0\ufe0f Importante<\/strong>: este nombre lo usar\u00e1n despu\u00e9s las tareas del tasks.json<\/code>. lige uno corto y recu\u00e9rdalo. En esta gu\u00eda usamos hpc<\/code>. Solo permite: min\u00fasculas, n\u00fameros, _.+-<\/code>.)<\/li>\n\n\n\n
              2. Location \u00abGlobal settings.json\u00bb (para que la config est\u00e9 disponible en cualquier ventana de VS Code).<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n\n\n\n
                \"\"<\/figure>\n\n\n\n
                4.2 \u2014 Editar los detalles de la conexi\u00f3n<\/h3>\n\n\n\n
                Al guardar, se abre un formulario grande con muchos campos. Rellena los siguientes:<\/p>\n\n\n\n
                Secci\u00f3n superior:<\/strong><\/p>\n\n\n\n
                  \n
                • Name<\/strong>: hpc<\/code> <\/li>\n\n\n\n
                • Label<\/strong>: HPC Helix<\/code><\/li>\n\n\n\n
                • Group<\/strong>, Merge<\/strong>, Extend<\/strong>, PuTTY<\/strong>: d\u00e9jalos vac\u00edos\/default.<\/li>\n\n\n\n
                • Host<\/strong>: 10.10.132.5<\/code> (\u26a0\ufe0f NO pongas aqu\u00ed el alias hpc. SSH FS no siempre resuelve alias del ~\/.ssh\/config como bash lo hace. Si pones hpc, obtienes error getaddrinfo ENOTFOUND hpc. Usa el hostname o IP real.)<\/li>\n<\/ul>\n\n\n\n
                  \"\"<\/figure>\n\n\n\n
                  \"\"<\/figure>\n\n\n\n
                  • Private key<\/strong> (Path): ~\/.ssh\/una_tavo_ed25519<\/code><\/li><\/ul><\/p>\n\n\n\n
                    \"\"<\/figure>\n\n\n\n
                    • Agent<\/strong>: si usas keychain o ssh-agent, activa esta casilla y puedes dejar el private key vac\u00edo.<\/li><\/ul><\/p>\n\n\n\n
                      \"\"<\/figure>\n\n\n\n
                        \n
                      • Root<\/li>\n<\/ul>\n\n\n\n
                        \"\"<\/figure>\n\n\n\n
                        Paso 5 \u2014 Conectar al servidor<\/h2>\n\n\n\n
                        Hay dos formas equivalentes:<\/p>\n\n\n\n
                        Forma 1 \u2014 Desde el panel de SSH FS:<\/strong><\/p>\n\n\n\n
                          \n
                        1. Click derecho sobre hpc<\/code> en la lista.<\/li>\n\n\n\n
                        2. Elige \u00abAdd as Workspace folder\u00bb<\/strong>.<\/li>\n<\/ol>\n\n\n\n
                          \"\"<\/figure>\n\n\n\n
                          Forma 2 \u2014 Con la paleta de comandos:<\/strong><\/p>\n\n\n\n
                            \n
                          1. Ctrl+Shift+P<\/code> \u2192 escribe: SSH FS: Add as Workspace folder<\/strong><\/li>\n\n\n\n
                          2. Elige cicima-hpc<\/code> de la lista.<\/li>\n<\/ol>\n\n\n\n
                            \"\"<\/figure>\n\n\n\n
                            VS Code te va a preguntar si conf\u00edas en el workspace. Elige \u00abYes, I trust the authors\u00bb<\/strong>.<\/p>\n\n\n\n
                            En unos segundos deber\u00edas ver tu carpeta home del HPC aparecer en el explorador de VS Code, como si fuera una carpeta local. Puedes navegar, abrir archivos, editar, guardar, y todo va directo al servidor por SFTP.<\/p>\n\n\n\n
                            \"\"<\/figure>\n\n\n\n
                            Verificaci\u00f3n r\u00e1pida:<\/strong><\/p>\n\n\n\n
                              \n
                            • Abre cualquier archivo del HPC.<\/li>\n\n\n\n
                            • Cambia una l\u00ednea, guarda (Ctrl+S<\/code>).<\/li>\n\n\n\n
                            • Vuelve a abrirlo desde una terminal SSH (cat archivo<\/code>) y confirma que el cambio se guard\u00f3.<\/li>\n<\/ul>\n\n\n\n
                              \n\n\n\n
                              Paso 6 \u2014 Crear la configuraci\u00f3n .vscode\/<\/code> con las tareas<\/h2>\n\n\n\n
                              Para poder compilar y ejecutar c\u00f3digo remotamente sin salir de VS Code, creamos dos archivos de configuraci\u00f3n dentro de una carpeta .vscode<\/code> en la ra\u00edz del workspace remoto.<\/p>\n\n\n\n
                              6.1 \u2014 Crear la carpeta<\/h3>\n\n\n\n
                              En el explorador de VS Code:<\/p>\n\n\n\n
                                \n
                              1. Click derecho sobre la ra\u00edz del workspace remoto.<\/li>\n\n\n\n
                              2. Elige \u00abNew Folder\u00bb<\/strong> \u2192 nombre: .vscode<\/code><\/li>\n<\/ol>\n\n\n\n
                                \"\"<\/figure>\n\n\n\n
                                \"\"<\/figure>\n\n\n\n
                                6.2 \u2014 Crear c_cpp_properties.json<\/code><\/h3>\n\n\n\n
                                Este archivo le dice a IntelliSense d\u00f3nde encontrar los compiladores y headers de MPI en el cl\u00faster.<\/p>\n\n\n\n
                                Dentro de .vscode\/<\/code>, crea un archivo llamado c_cpp_properties.json<\/code> con este contenido:<\/p>\n\n\n\n
                                {\n    \"configurations\": [\n        {\n            \"name\": \"HPC OpenMPI\",\n            \"compilerPath\": \"\/opt\/openmpi\/4.0.4_gnu\/bin\/mpicxx\",\n            \"includePath\": [\n                \"${workspaceFolder}\/**\"\n            ],\n            \"cStandard\": \"c11\",\n            \"cppStandard\": \"c++17\",\n            \"intelliSenseMode\": \"linux-gcc-x64\"\n        }\n    ],\n    \"version\": 4\n}\n<\/code><\/pre>\n\n\n\n
                                \"\"<\/figure>\n\n\n\n
                                6.3 \u2014 Crear tasks.json<\/code><\/h3>\n\n\n\n
                                Este archivo define las tareas de compilaci\u00f3n y ejecuci\u00f3n. Incluye tareas para C\/C++ (MPI, OpenMP) y para Python + Slurm.<\/p>\n\n\n\n
                                Dentro de .vscode\/<\/code>, crea un archivo llamado tasks.json<\/code> con este contenido:<\/p>\n\n\n\n
                                {\n  \"version\": \"2.0.0\",\n  \"tasks\": [\n    {\n      \"label\": \"Compilar OpenMPI\",\n      \"type\": \"ssh-shell\",\n      \"host\": \"hpc\",\n      \"command\": \"\/opt\/openmpi\/4.0.4_gnu\/bin\/mpicxx \\\"${remoteFile}\\\" -o \\\"${remoteFileDirname}\/${remoteFileBasenameNoExtension}\\\"\",\n      \"group\": { \"kind\": \"build\", \"isDefault\": true },\n      \"problemMatcher\": [\"$gcc\"]\n    },\n    {\n      \"label\": \"Compilar OpenMP\",\n      \"type\": \"ssh-shell\",\n      \"host\": \"hpc\",\n      \"command\": \"\/usr\/bin\/g++ \\\"${remoteFile}\\\" -o \\\"${remoteFileDirname}\/${remoteFileBasenameNoExtension}\\\" -fopenmp\",\n      \"group\": \"build\",\n      \"problemMatcher\": [\"$gcc\"]\n    },\n    {\n      \"label\": \"Ejecutar OpenMPI con Slurm\",\n      \"type\": \"ssh-shell\",\n      \"host\": \"hpc\",\n      \"command\": \"cd \\\"${remoteFileDirname}\\\" && srun --partition=debug --ntasks=4 \/opt\/openmpi\/4.0.4_gnu\/bin\/mpirun -np 4 \\\".\/${remoteFileBasenameNoExtension}\\\"\",\n      \"problemMatcher\": []\n    },\n    {\n      \"label\": \"Ejecutar OpenMP con Slurm\",\n      \"type\": \"ssh-shell\",\n      \"host\": \"hpc\",\n      \"command\": \"cd \\\"${remoteFileDirname}\\\" && OMP_NUM_THREADS=4 srun --partition=debug --ntasks=1 --cpus-per-task=4 \\\".\/${remoteFileBasenameNoExtension}\\\"\",\n      \"problemMatcher\": []\n    },\n    {\n      \"label\": \"Ejecutar Python con Slurm\",\n      \"type\": \"ssh-shell\",\n      \"host\": \"hpc\",\n      \"command\": \"cd \\\"${remoteFileDirname}\\\" && module load Anaconda && srun --partition=debug --ntasks=1 --cpus-per-task=1 python \\\"${remoteFile}\\\"\",\n      \"problemMatcher\": []\n    },\n    {\n      \"label\": \"Enviar sbatch\",\n      \"type\": \"ssh-shell\",\n      \"host\": \"hpc\",\n      \"command\": \"cd \\\"${remoteFileDirname}\\\" && sbatch \\\"${remoteFile}\\\"\",\n      \"problemMatcher\": []\n    },\n    {\n      \"label\": \"Ver mi cola (squeue)\",\n      \"type\": \"ssh-shell\",\n      \"host\": \"hpc\",\n      \"command\": \"squeue -u $USER\",\n      \"problemMatcher\": []\n    },\n    {\n      \"label\": \"\u00daltimos jobs de hoy (sacct)\",\n      \"type\": \"ssh-shell\",\n      \"host\": \"hpc\",\n      \"command\": \"sacct -u $USER --starttime=today -o JobID,JobName,State,Elapsed,MaxRSS,NodeList\",\n      \"problemMatcher\": []\n    }\n  ]\n}<\/code><\/pre>\n\n\n\n
                                Guarda con Ctrl+S<\/code>.<\/p>\n\n\n\n
                                \"\"<\/figure>\n\n\n\n
                                \n","protected":false},"excerpt":{"rendered":"
                                Esta gu\u00eda te ayuda a la configuracion del cl\u00faster Helix (nodo de login cicima-hpc) mediante la extensi\u00f3n SSH FS de visual code. \u00bfPor qu\u00e9 SSH FS y no Remote-SSH? VS Code tiene dos formas de trabajar remoto: SSH FS (recomendado en Helix) Remote-SSH (no recomendado) D\u00f3nde corre VS Code En tu m\u00e1quina local Instala un […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-25597","post","type-post","status-publish","format-standard","hentry","category-sin-categoria"],"blocksy_meta":[],"_links":{"self":[{"href":"https:\/\/sada.services\/index.php?rest_route=\/wp\/v2\/posts\/25597","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/sada.services\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sada.services\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sada.services\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/sada.services\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=25597"}],"version-history":[{"count":7,"href":"https:\/\/sada.services\/index.php?rest_route=\/wp\/v2\/posts\/25597\/revisions"}],"predecessor-version":[{"id":25625,"href":"https:\/\/sada.services\/index.php?rest_route=\/wp\/v2\/posts\/25597\/revisions\/25625"}],"wp:attachment":[{"href":"https:\/\/sada.services\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=25597"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sada.services\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=25597"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sada.services\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=25597"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}