Compartilhar via


Configurar túneis de desenvolvimento no VS Code

Use o Microsoft Dev Box com o VS Code (Visual Studio Code) para criar ambientes de desenvolvimento seguros baseados em nuvem. Este artigo explica como configurar túneis de desenvolvimento e conectar-se ao Seu Dev Box do VS Code. Você aprenderá a instalar a extensão necessária, habilitar túneis seguros e conectar-se remotamente para uma experiência de desenvolvimento simplificada. Siga estas etapas para começar rapidamente e trabalhar com eficiência de qualquer lugar.

Pré-requisitos

Configurar um túnel de desenvolvimento

Siga estas etapas para configurar um túnel de desenvolvimento e conectar-se à caixa de desenvolvimento usando o VS Code.

  1. Instalar a extensão do VS Code

    No seu VS Code local, instale a extensão Dev Box do VS Code Extension Marketplace. Os túneis de desenvolvimento exigem a versão 2.0.0 ou posterior. Instale a extensão localmente, não na Caixa de Desenvolvimento à qual deseja se conectar.

    Captura de tela da extensão Dev Box no VS Code.

  2. Entrar na extensão Dev Box

    Selecione o ícone Caixa de Desenvolvimento na barra lateral esquerda e selecione Entrar.

    Captura de tela da extensão Dev Box mostrando a opção de entrada.

  3. Criar e habilitar o Túnel do Dev Box

    Depois de entrar, você verá todos os projetos que você pode acessar. Escolha o projeto ao qual você criou a Caixa de Desenvolvimento e selecione a Caixa de Desenvolvimento à qual deseja se conectar.

    Se Sem túnel estiver sendo exibido na descrição, primeiro crie um recurso de túnel manualmente.

    Captura de tela da extensão Dev Box mostrando a opção de criar um túnel.

    Antes de habilitar o túnel, você deve fazer logon no Dev Box pelo menos uma vez usando qualquer cliente (por exemplo, navegador, Aplicativo do Windows, cliente de Área de Trabalho Remota). Essa etapa é obrigatória após cada desligamento e reinicialização para estabelecer a sessão de usuário necessária para configurar o túnel. Depois de fazer logon, você pode se desconectar da Caixa de Desenvolvimento.

    Você não precisa fazer login sempre que habilitar ou se conectar ao túnel; somente após um desligamento ou reinicialização.

    Captura de tela da habilitação do túnel na extensão Dev Box.

    Em seguida, habilite o túnel. Esse processo pode levar de 1 a 3 minutos, pois instala o VS Code na Caixa de Desenvolvimento (se ainda não estiver instalado) e configura o túnel.

  4. Conectar-se à Caixa de Desenvolvimento no VS Code

    Depois que tudo estiver configurado, você poderá abrir a Caixa de Desenvolvimento no VS Code clicando no botão Conectar ao Túnel .

    Captura de tela da extensão Caixa de Desenvolvimento mostrando a opção de se conectar ao túnel.

  5. Explorar a experiência remota no VS Code

    Abra qualquer pasta ou workspace na Dev Box remota usando Arquivo > Abrir Arquivo/Pasta/Workspace da mesma forma que faria localmente.

    Se você tiver um ambiente WSL (Subsistema do Windows para Linux) na Caixa de Desenvolvimento, conecte-se a ele usando o Gerenciador Remoto.

    Captura de tela do Gerenciador Remoto no VS Code mostrando destinos WSL.

    Selecione os destinos do WSL na lista suspensa para ver todas as distribuições WSL. Abra qualquer distribuição WSL na janela atual ou nova.

    Captura de tela de um terminal de distribuição WSL no VS Code.

    Para obter mais informações sobre a experiência de desenvolvimento do WSL, consulte Remote – WSL e Configure um ambiente de desenvolvimento WSL.

Perguntas frequentes

  • Por que preciso entrar no Dev Box antes de habilitar o túnel?

    Essa etapa é necessária para estabelecer uma sessão de usuário para configurar o túnel. Após o login inicial, você pode simplesmente se desconectar da Dev Box. Em seguida, você pode habilitar ou se conectar ao túnel sem fazer logon novamente, a menos que a Caixa de Desenvolvimento seja desligada ou reiniciada.

  • Por que não consigo me conectar à Caixa de Desenvolvimento mesmo que o túnel esteja habilitado?

    Atualize a exibição do explorador de extensões do Dev Box com o botão no canto superior direito para verificar o último status do túnel. Se o túnel estiver habilitado, mas você ainda não puder se conectar, tente desabilitar o túnel, entrar na Caixa de Desenvolvimento e habilitar novamente o túnel.