Compartilhar via


Solucionar problemas de desenvolvimento do Visual Studio com o Docker

Aplica-se a: Visual Studio

Ao trabalhar com Ferramentas do Visual Studio para Contêiner, você poderá encontrar problemas ao compilar ou depurar seu aplicativo. Este artigo apresenta algumas etapas comuns de solução de problemas para os problemas.

Compartilhamento de volume não está habilitado. Habilite o compartilhamento de volume nas configurações do Docker CE for Windows (somente contêineres do Linux)

O compartilhamento de arquivos só precisa ser gerenciado se você estiver usando o Hyper-V com o Docker. Se você estiver usando o WSL 2, as etapas a seguir não serão necessárias e a opção de compartilhamento de arquivos não ficará visível. Para resolver o problema:

  1. Clique com o botão direito do mouse em Docker para Windows na área de notificação e selecione Configurações.

  2. Selecione Recursos>Compartilhamento de Arquivos e compartilhe a pasta que precisa ser acessada. Compartilhar toda a unidade do sistema é possível, mas não recomendado.

    Captura de tela de drives compartilhados.

Dica

O Visual Studio exibem um aviso quando as Unidades Compartilhadas não estão configuradas.

Não é possível iniciar a depuração

Um motivo para esse problema pode estar relacionado a ter componentes de depuração obsoletos em sua pasta de perfil de usuário. Execute os seguintes comandos para remover essas pastas para que os componentes de depuração mais recentes sejam baixados na próxima sessão de depuração.

  • del %userprofile%\vsdbg
  • del %userprofile%\onecoremsvsmon

Erros específicos de rede ao depurar o aplicativo

Tente executar o script baixado de Rede de Host do Contêiner de Limpeza, que atualizará os componentes relacionados à rede no seu computador host.

Montagens negadas

Ao usar o Docker para macOS, você pode encontrar um erro ao fazer referência à pasta /usr/local/share/dotnet/sdk/NuGetFallbackFolder. Adicione a pasta à guia Compartilhamento de arquivos no Docker.

Grupo de usuários do Docker

Você pode encontrar o seguinte erro no Visual Studio ao trabalhar com contêineres:

O usuário atual deve estar no grupo 'docker-users' para usar o Docker Desktop. Adicione-se ao grupo 'docker-users' e saia do Windows.

Você deve ser membro do grupo 'docker-users' para ter permissões para trabalhar com contêineres do Docker. Para adicionar-se ao grupo no Windows 10 ou posterior, siga estas etapas:

  1. No menu Iniciar, abra Gerenciamento de Computador.
  2. Expanda Usuários e Grupos Locais e selecione Grupos.
  3. Encontre o grupo docker-users, clique com o botão direito do mouse e selecione Adicionar ao grupo.
  4. Adicione sua conta de usuário ou contas.
  5. Saia e entre novamente para que essas alterações entrem em vigor.

Você também pode usar o comando net localgroup no prompt de comando Administrador para adicionar usuários a grupos específicos.

net localgroup docker-users DOMAIN\username /add

No PowerShell, use a função Add-LocalGroupMember.

Pouco espaço em disco

Por padrão, o Docker armazena imagens na pasta %ProgramData%/Docker/ , que normalmente está na unidade do sistema, C:\ProgramData\Docker\. Para impedir que as imagens ocupassem espaço valioso na unidade do sistema, você pode alterar o local da pasta de imagem. Para fazer isso:

  1. Clique com o botão direito do mouse no ícone do Docker na barra de tarefas e selecione Configurações.

  2. Selecione Mecanismo do Docker.

  3. No painel de edição, adicione a configuração de propriedade graph com o valor do local desejado para imagens do Docker:

       "graph": "D:\\mypath\\images"
    

    Captura de tela do compartilhamento de arquivos do Docker.

  4. Selecione Aplicar e reiniciar. Essas etapas modificam o arquivo de configuração em %ProgramData%\docker\config\daemon.json. As imagens criadas anteriormente não são movidas.

Incompatibilidade de tipo de contêiner

Ao adicionar o suporte ao Docker a um projeto, escolha um contêiner do Windows ou do Linux. Se o host do Docker Server não estiver configurado para executar o mesmo tipo de contêiner que o destino do projeto, você verá um erro semelhante a:

Captura de tela do host do Docker e da incompatibilidade do projeto.

Para resolver esse problema, clique com o botão direito do mouse no ícone do Docker para Windows na bandeja do sistema e selecione Alternar para contêineres do Windows... ou Alternar para contêineres do Linux....

Outros problemas

Para quaisquer outros problemas que encontrar, consulte problemas do Microsoft/DockerTools.

Referências