Skip to main content

​
Conecte un entorno remoto

Un entorno remoto ejecuta el agente, las operaciones de archivos y los terminales en un host SSH, una distribución WSL o un contenedor Docker. La interfaz de escritorio permanece en su ordenador. Los entornos WSL y Docker pueden ejecutarse en ese mismo ordenador. El repositorio y las herramientas de desarrollo deben existir en ese entorno; conectarse no copia su checkout local. Prepare el entorno antes de conectar: Después, conecte el entorno:
  1. En una nueva sesión de Code, abra el menú de la carpeta y elija Remote workspace… en Run on.
  2. Elija el tipo de conexión, introduzca los datos y seleccione una carpeta de proyecto existente en el destino.
  3. Si la tarea necesita herramientas locales, selecciónelas en Tools and credentials. Incluir sus credenciales requiere una selección aparte.
  4. Elija Connect. El diálogo muestra el progreso de la preparación o el error que impidió la conexión.
Las herramientas y la configuración seleccionadas se copian una vez, al conectar. Los cambios locales posteriores no se sincronizan continuamente. Las autorizaciones OAuth de los conectores no se copian; configure la autenticación en el entorno de destino para los conectores que la necesiten. El lugar de ejecución queda fijado cuando empieza la sesión; para trabajar en otra máquina, cree una nueva sesión. Desconectar separa la interfaz de escritorio del entorno sin cancelar una tarea remota activa. Use el control de parada de la sesión para cancelar el trabajo. Las herramientas transferidas y las credenciales persistentes permanecen en la máquina remota después de desconectar.

​
Introduzca los datos de conexión

Para SSH, indique el host y la carpeta remota. Añada usuario, puerto y ruta de clave privada si no están en la configuración SSH. Establezca primero la confianza mediante su configuración habitual: la aplicación espera el host en known_hosts y una autenticación sin preguntas interactivas. Para WSL, elija la distribución instalada. Para Docker, indique el nombre o ID de un contenedor existente en ejecución y, si hace falta, el contexto Docker. Use una Remote folder existente, como ~/project o /home/user/project; será el directorio de trabajo de la sesión. Antes de editar, pida leer el README remoto e indicar la ubicación del proyecto y el comando de pruebas. Así puede comprobar que seleccionó el checkout correcto.

Una conexión SSH necesita un host y una carpeta remota existente. Estos valores son ejemplos.

​
Vuelva a conectarse

Use Saved connections para reutilizar un destino. Disconnect cierra la conexión; Forget elimina la entrada guardada. Ninguna cambia el destino de una sesión existente. Para detener una tarea remota, use su control de parada antes de desconectar. Si actualiza una skill o un conector localmente, no suponga que cambió la copia remota. La transferencia ocurre una vez y la autenticación remota debe seguir vigente. Revise el destino cuando una herramienta funcione localmente pero falte o no esté autorizada en remoto.

​
Use un entorno en la nube cuando esté disponible

Si su cuenta ofrece Cloud… en el selector, puede elegir un entorno guardado en lugar de SSH, WSL o Docker. Define los repositorios y la preparación de una sesión nueva. La disponibilidad depende de la cuenta y organización. En Settings → Cloud environments, cree o abra un entorno. Añadir repositorios requiere una conexión GitHub en la cuenta. Elija cada repositorio y rama, o deje la rama vacía para usar la predeterminada que se muestra. También puede configurar script de preparación, variables y acceso de red: Incluya solo configuración no secreta en las variables: sus valores son visibles para los usuarios del entorno. El script Bash opcional se ejecuta al inicio de cada sesión, antes del agente, con el acceso de red elegido. Seleccione el entorno antes del primer mensaje. Ese mensaje crea la sesión y prepara repositorios. Abra el indicador del entorno para ver su estado. Si falla la preparación, use Retry cuando se ofrezca; si falla el script, puede aparecer Run setup again. Examine el error antes de repetir. Los cambios del nivel de red guardado afectan a sesiones nuevas. Las existentes conservan el acceso original; cambiar de entorno requiere otra sesión. Continúe con Tareas programadas.