Compartir a través de

Troubleshoot Visual Studio development with Docker (Solución de problemas de desarrollo de Visual Studio con Docker)

  • Artículo

Se aplica a: Visual Studio

Al trabajar con las herramientas de contenedor de Visual Studio, se pueden producir problemas al compilar o depurar la aplicación. En este artículo se presentan algunos pasos comunes de solución de problemas para los problemas.

El uso compartido de volúmenes no está habilitado. Habilite el uso compartido de volúmenes en la configuración de Docker CE para Windows (solo en contenedores con Linux)

El uso compartido de archivos solo debe administrarse si usa Hyper-V con Docker. Si usa WSL 2, los pasos siguientes no son necesarios y la opción compartir archivos no estará visible. Para solucionar este problema:

  1. Haga clic derecho en Docker para Windows en el área de notificación y, a continuación, seleccione Configuración.

  2. Seleccione Recursos>Uso compartido de archivos y comparta la carpeta a la que se necesita tener acceso. Es posible compartir toda la unidad del sistema, pero no se recomienda.

    Captura de pantalla de unidades compartidas.

Sugerencia

Visual Studio se lo pide si las unidades compartidas no están configuradas.

No se puede iniciar la depuración

Un motivo de este problema podría estar relacionado con tener componentes de depuración obsoletos en la carpeta de perfil de usuario. Ejecute los comandos siguientes para quitar estas carpetas, a fin de que se descarguen los últimos componentes de depuración en la siguiente sesión de depuración.

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

Errores específicos de redes al depurar una aplicación

Intente ejecutar el script que puede descargar de Cleanup Container Host Networking (Limpieza de redes host de contenedores), que actualizará los componentes de red en el equipo host.

Montajes denegados

Al usar Docker para macOS, podría producirse un error al hacer referencia a la carpeta /usr/local/share/dotnet/sdk/NuGetFallbackFolder. Agregue la carpeta a la pestaña Uso compartido de archivos en Docker.

Grupo de usuarios de Docker

Podría aparecer el siguiente error en Visual Studio al trabajar con contenedores:

El usuario actual debe estar en el grupo "docker-users" para usar Docker Desktop. Agréguese al grupo "docker-users" y cierre sesión en Windows.

Debe ser miembro del grupo "docker-users" para obtener permisos para trabajar con contenedores de Docker. Para agregarse al grupo en Windows 10 o posterior, siga estos pasos:

  1. En el menú Inicio, abra Administración de equipos.
  2. Expanda Usuarios y grupos locales y seleccione Grupos.
  3. Busque el grupo docker-users, haga clic con el botón derecho y seleccione Agregar al grupo.
  4. Agregue la cuenta o cuentas de usuario.
  5. Cierre la sesión y vuelva a iniciarla para que estos cambios surtan efecto.

También puede usar el comando net localgroup en el símbolo del sistema del administrador para agregar usuarios a grupos determinados.

net localgroup docker-users DOMAIN\username /add

En PowerShell, use la función Add-LocalGroupMember.

Espacio de disco bajo

De forma predeterminada, Docker almacena imágenes en la carpeta %ProgramData%/Docker/ , que normalmente se encuentra en la unidad del sistema, C:\ProgramData\Docker\. Para evitar que las imágenes ocupen espacio valioso en la unidad del sistema, puede cambiar la ubicación de la carpeta de imágenes. Para ello:

  1. Haga clic con el botón derecho en el icono de Docker de la barra de tareas y seleccione Configuración.

  2. Seleccione Docker Engine (Motor de Docker).

  3. En el panel de edición, agregue la configuración de la propiedad graph con el valor de la ubicación deseada para las imágenes de Docker:

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

    Captura de pantalla del uso compartido de archivos de Docker.

  4. Seleccione Aplicar y reiniciar. En estos pasos se modifica el archivo de configuración que se encuentra en %ProgramData%\docker\config\daemon.json. Las imágenes creadas anteriormente no se mueven.

Error de coincidencia de tipos de contenedores

Al agregar compatibilidad con Docker a un proyecto, se elige un contenedor de Linux o Windows. Si el host de Docker Server no está configurado para ejecutar el mismo tipo de contenedor que el destino del proyecto, verá un error similar al siguiente:

Captura de pantalla de La falta de coincidencia del host y el proyecto de Docker.

Para resolver este problema, haga clic con el botón derecho en el icono de Docker para Windows en la bandeja del sistema y seleccione Cambiar a contenedores de Windows... o Cambiar a contenedores de Linux....

Otros problemas

Para otros problemas que detecte, consulte los problemas de Microsoft/DockerTools.

Referencias