Configuración de contenedores de desarrollo en Windows

Un contenedor de desarrollo le permite utilizar un contenedor de Docker como un entorno de desarrollo completo, definido por un archivo devcontainer.json incorporado en su repositorio. Todos los usuarios que abren el proyecto obtienen las mismas herramientas, extensiones y configuraciones, independientemente de lo que esté instalado en su equipo local.

En esta página se describe la configuración específica del Windows. Para obtener una introducción completa a lo que son los contenedores de desarrollo y cómo funcionan, consulte la documentación de Dev Containers en el sitio web de VS Code.

Prerrequisitos

Los contenedores de desarrollo en Windows requieren:

  • WSL 2: Subsistema de Windows para Linux, versión 2. Instale WSL si aún no lo ha hecho.
  • Docker Desktop para Windows con el back-end WSL 2 habilitado. Descargue Docker Desktop y siga el instalador. Durante la instalación, asegúrese de que el motor basado en WSL 2 está seleccionado en laconfiguración de Docker Desktop (Configuración >general).
  • Visual Studio Code: Download VS Code.
  • Extensión Dev Containers : instale la extensión Dev Containers desde VS Code Marketplace.

Dónde almacena los archivos es importante

Importante

En Windows, el rendimiento del contenedor de desarrollo depende en gran medida de dónde se encuentran los archivos del proyecto. Almacene el proyecto en el sistema de archivos WSL 2 (por ejemplo, /home/yourname/projects/), no en el sistema de archivos de Windows (por ejemplo, C:\Users\yourname\projects\).

Cuando los archivos están en el sistema de archivos de Windows (C:\), Docker los accede a través de un recurso compartido de archivos entre sistemas operativos, que es significativamente más lento. Cuando los archivos están en el sistema de archivos WSL 2, Docker usa la E/S nativa de Linux y el rendimiento es considerablemente mejor, especialmente para compilaciones y herramientas de inspección de archivos.

Para clonar en el sistema de archivos WSL 2, abra la distribución de WSL (por ejemplo, Ubuntu) desde el menú Inicio o Terminal Windows y clone allí:

cd ~
mkdir projects && cd projects
git clone https://github.com/your-org/your-repo.git

A continuación, abra esa carpeta en VS Code desde WSL:

code your-repo

VS Code se conecta a WSL y detecta la presencia de devcontainer.json si hay uno.

Abrir un proyecto en un contenedor de desarrollo

Una vez abierto el proyecto en VS Code (conectado a WSL):

  1. Presione F1 y seleccione Contenedores de desarrollo: Volver a abrir en el contenedor.
  2. VS Code compila la imagen de contenedor definida en .devcontainer/devcontainer.json (o le pide que agregue una si no existe ninguna).
  3. Una vez completada la compilación, VS Code se vuelve a conectar dentro del contenedor con todas las herramientas y extensiones configuradas disponibles.

Para volver al entorno local, presione F1 y seleccione Contenedores de desarrollo: Volver a abrir carpeta localmente.

Agregar un contenedor de desarrollo a un proyecto existente

Si tu proyecto aún no tiene un devcontainer.json:

  1. Presione F1 y seleccione Contenedores de desarrollo: Agregar archivos de configuración de contenedor de desarrollo.
  2. Elija una imagen base (por ejemplo, Node.js, Python o una imagen genérica de Debian/Ubuntu).
  3. VS Code crea un archivo .devcontainer/devcontainer.json que puede registrar en el control de código fuente.

Para consultar la referencia completa de las opciones de devcontainer.json, vea la referencia de devcontainer.json en el sitio de la Especificación del Contenedor de Desarrollo.

Solución de problemas

Container se inicia, pero no se detectan cambios de archivo Es probable que el proyecto se almacene en el sistema de archivos Windows. Muévalo a WSL (consulte Dónde almacene sus archivos es importante anteriormente).

Docker Desktop no se inicia o falta la integración de WSL Abra Docker Desktop, vaya a Configuración>Recursos>integración de WSL y habilite la integración para las distribuciones de WSL instaladas.

VS Code no se puede conectar al contenedor Asegúrese de que Docker Desktop se está ejecutando antes de abrir VS Code. Compruebe el icono de la bandeja del sistema de Docker Desktop.

Pasos siguientes

  • Last updated on