Résoudre les problèmes de développement Visual Studio avec Docker

S’applique à : Visual Studio

Quand vous utilisez Visual Studio Tools Container Tools, vous pouvez rencontrer des problèmes au moment de la génération ou du débogage de votre application. Cet article présente certaines étapes de dépannage courantes pour les problèmes.

Le partage de volume n’est pas activé. Activez le volume de partage dans les paramètres de Docker CE pour Windows (uniquement pour les conteneurs Linux)

Le partage de fichiers doit être géré uniquement si vous utilisez Hyper-V avec Docker. Si vous utilisez WSL 2, les étapes suivantes ne sont pas nécessaires et l’option de partage de fichiers n’est pas visible. Pour résoudre ce problème :

1. Dans la zone de notification, cliquez avec le bouton droit sur Docker pour Windows, puis sélectionnez Paramètres.

2. Sélectionnez Ressources>Partage de fichiers et partagez le dossier à accéder. Le partage de l’ensemble de votre lecteur système est possible, mais pas recommandé.

   

Conseil

Visual Studio vous sollicite quand les lecteurs partagés ne sont pas configurés.

Impossible de démarrer le débogage

Une des raisons de ce problème peut être liée à l’utilisation de composants de débogage obsolètes dans votre dossier de profil utilisateur. Exécutez les commandes suivantes pour supprimer ces dossiers. Les composants de débogage les plus récents seront téléchargés lors de la session de débogage suivante.

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

Erreurs de réseau lors du débogage de votre application

Essayez d’exécuter le script téléchargeable à partir de Cleanup Container Host Networking. Ce script met à jour les composants réseau sur votre machine hôte.

Montages refusés

Lorsque vous utilisez Docker pour macOS, vous pouvez rencontrer une erreur référençant le dossier /usr/local/share/dotnet/sdk/NuGetFallbackFolder. Ajoutez le dossier à l’onglet Partage de fichiers dans Docker.

Groupe d’utilisateurs Docker

Vous pouvez rencontrer l’erreur suivante dans Visual Studio lors de l’utilisation de conteneurs :

L’utilisateur actuel doit se trouver dans le groupe « docker-users » pour utiliser Docker Desktop. Ajoutez-vous au groupe « docker-users », puis déconnectez-vous de Windows.

Vous devez être membre du groupe « docker-users » pour pouvoir utiliser des conteneurs Docker. Pour vous ajouter au groupe dans Windows 10 ou une version ultérieure, procédez comme suit :

1. Dans le menu Démarrer, ouvrez Gestion de l’ordinateur.
2. Développez Utilisateurs et groupes locaux, puis sélectionnez Groupes.
3. Recherchez le groupe docker-users, cliquez avec le bouton droit et sélectionnez Ajouter au groupe.
4. Ajoutez votre ou vos comptes d’utilisateur.
5. Déconnectez-vous et reconnectez-vous pour que ces modifications prennent effet.

Vous pouvez également utiliser la commande net localgroup à l’invite de commandes Administrateur pour ajouter des utilisateurs à des groupes spécifiques.

net localgroup docker-users DOMAIN\username /add

Dans PowerShell, utilisez la fonction Add-LocalGroupMember.

Espace disque insuffisant

Par défaut, Docker stocke des images dans le dossier %ProgramData%/Docker/ , qui se trouve généralement sur le lecteur système, C :\ProgramData\Docker\. Pour éviter que les images n’occupent un espace précieux sur le lecteur système, vous pouvez modifier l’emplacement du dossier d’images. Pour ce faire :

1. Cliquez avec le bouton droit sur l’icône Docker dans la barre des tâches, puis sélectionnez Paramètres.

2. Sélectionnez Moteur Docker.

3. Dans le volet d’édition, ajoutez le paramètre de propriété graph avec la valeur de l’emplacement souhaité pour les images Docker :

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

   

4. Sélectionnez Appliquer & Redémarrer. Ces étapes modifient le fichier de configuration dans %ProgramData%\docker\config\daemon.json. Les images créées précédemment ne sont pas déplacées.

Incompatibilité de type de conteneur

Quand vous ajoutez la prise en charge de Docker à un projet, choisissez un conteneur Windows ou Linux. Si l’hôte Docker Server n’est pas configuré pour exécuter le même type de conteneur que la cible du projet, vous voyez une erreur similaire à :

Pour résoudre ce problème, cliquez avec le bouton droit sur l’icône Docker pour Windows dans la barre d’état système, puis sélectionnez Basculer vers les conteneurs Windows... ou Basculer vers des conteneurs Linux....

Autres problèmes

Pour tout autre problème que vous rencontrez, consultez les problèmes répertoriés dans Microsoft/DockerTools.

References

• Messages d’erreur Container Tools