Configurar contêineres de desenvolvimento no Windows

Um Contêiner de Desenvolvimento permite que você use um contêiner do Docker como um ambiente de desenvolvimento completo, definido por um devcontainer.json arquivo verificado em seu repositório. Todos os que abrem o projeto recebem as mesmas ferramentas, extensões e configurações, independentemente do que está instalado no computador local.

Esta página aborda a configuração específica do Windows. Para obter uma introdução completa sobre o que são contêineres de desenvolvimento e como eles funcionam, consulte a documentação de Contêineres de Desenvolvimento no site do VS Code.

Pré-requisitos

Os contêineres de desenvolvimento em Windows exigem:

  • WSL 2 — Subsistema do Windows para Linux, versão 2. Instale o WSL se ainda não tiver feito isso.
  • Docker Desktop para Windows com o back-end do WSL 2 habilitado. Baixe o Docker Desktop e siga o instalador. Durante a instalação, verifique se Usar o mecanismo baseado em WSL 2 está selecionado nas configurações do Docker Desktop (Configurações>Geral).
  • Visual Studio Code — Download VS Code.
  • Extensão Dev Containers — Instale a extensão Dev Containers do VS Code Marketplace.

Onde você armazena seus arquivos importa

Importante

Em Windows, o desempenho do Contêiner de Desenvolvimento depende muito de onde os arquivos do projeto residem. Armazene seu projeto no sistema de arquivos WSL 2 (por exemplo, /home/yourname/projects/), não no sistema de arquivos Windows (por exemplo, C:\Users\yourname\projects\).

Quando seus arquivos estão no sistema de arquivos Windows (C:\), o Docker os acessa por meio de um compartilhamento de arquivos entre sistemas operacionais, que é significativamente mais lento. Quando seus arquivos estão no sistema de arquivos WSL 2, o Docker usa E/S nativa do Linux e o desempenho é substancialmente melhor , especialmente para builds e ferramentas de observação de arquivos.

Para clonar no sistema de arquivos WSL 2, abra sua distribuição WSL (por exemplo, Ubuntu) no menu Iniciar ou Terminal do Windows e clone lá:

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

Em seguida, abra essa pasta no VS Code do WSL:

code your-repo

O VS Code conecta-se ao WSL e detecta o devcontainer.json se houver.

Abrir um projeto em um contêiner de desenvolvimento

Depois que o projeto estiver aberto no VS Code (conectado ao WSL):

  1. Pressione F1 e selecione Contêineres de Desenvolvimento: Reabrir no Contêiner.
  2. O VS Code cria a imagem de contêiner definida em .devcontainer/devcontainer.json (ou solicita que você adicione uma se nenhuma existir).
  3. Quando o build é concluído, o VS Code se reconecta dentro do contêiner com todas as ferramentas e extensões configuradas disponíveis.

Para retornar ao ambiente local, pressione F1 e selecione Contêineres de Desenvolvimento: Reabrir Pasta Localmente.

Adicionar um contêiner de desenvolvimento a um projeto existente

Se o projeto ainda não tiver devcontainer.json :

  1. Pressione F1 e selecione Contêineres de Desenvolvimento: Adicionar Arquivos de Configuração de Contêiner de Desenvolvimento.
  2. Escolha uma imagem base (por exemplo, Node.js, Python ou uma imagem genérica de Debian/Ubuntu).
  3. O VS Code cria um .devcontainer/devcontainer.json arquivo que você pode verificar no controle do código-fonte.

Para obter a referência completa das opções de devcontainer.json, consulte a referência devcontainer.json no site Dev Container Specification.

Solução de problemas

Container é iniciado, mas as alterações de arquivo não são detectadas Seu projeto provavelmente está armazenado no sistema de arquivos Windows. Mova-o para o WSL (veja onde você armazena seus arquivos importantes acima).

O Docker Desktop não inicia ou a integração do WSL está ausente Abra o Docker Desktop, vá para Configurações>Recursos>Integração WSL, para habilitar a integração para suas distribuições WSL instaladas.

O VS Code não pode se conectar ao contêiner Verifique se o Docker Desktop está em execução antes de abrir o VS Code. Verifique o ícone na bandeja do sistema do Docker Desktop.

Próximas Etapas 

  • Last updated on