Configurer les outils de conteneur Visual Studio

Les paramètres de Visual Studio vous permettent de contrôler certains aspects du fonctionnement de Visual Studio avec les conteneurs Docker. Tel est notamment le cas des paramètres qui ont un effet sur les performances et sur l’utilisation de ressources quand des conteneurs Docker sont utilisés.

Paramètres des outils de conteneur

Dans le menu principal, choisissez Outils > Options, puis développez Outils de conteneur > Paramètres. Les paramètres des outils de conteneur s’affichent.

Paramètres Général des outils de conteneur :

Paramètres des outils de conteneur Un seul projet et Docker Compose :

Le tableau suivant peut vous aider à déterminer comment définir ces options.

Le tableau suivant décrit les paramètres Général :

Nom	Paramètre par défaut	S'applique à	Description
Installer Docker Desktop si nécessaire	Me demander	Un seul projet, Docker Compose	Indiquez si vous souhaitez être invité dans le cas où Docker Desktop n’est pas installé.
Approuver le certificat SSL ASP.NET	Me demander	Projets ASP.NET Core 2.x	Quand le paramètre est défini sur Me demander, si le certificat SSL localhost n’est pas approuvé, Visual Studio vous invite à chaque exécution d’un projet ASP.NET Core 2.x.

Le tableau suivant décrit les paramètres Un seul projet et Docker Compose :

Nom	Paramètre par défaut	S'applique à	Description
Tirer (pull) les images Docker obligatoires à l’ouverture du projet	True	Un seul projet, Docker Compose	Pour améliorer les performances lors du chargement des projets, Visual Studio démarre une opération d’extraction Docker en arrière-plan de sorte que lorsque vous êtes prêt à exécuter votre code, l’image est déjà téléchargée ou en cours de téléchargement. Si vous chargez simplement des projets et parcourez du code, vous pouvez définir ce paramètre sur False pour éviter le téléchargement des images conteneur dont vous n’avez pas besoin.
Effectuer un tirage (pull) des images Docker mises à jour à l’ouverture du projet	Projets .NET Core	Un seul projet, Docker Compose	Quand vous ouvrez un projet, vérifiez s’il existe des mises à jour pour les images et téléchargez-les si c’est le cas.
Exécuter les conteneurs à l’ouverture du projet	True	Un seul projet, Docker Compose	De nouveau, pour améliorer les performances, Visual Studio crée un conteneur à l’avance pour qu’il soit prêt au moment où vous créez et exécutez votre conteneur. Si vous voulez contrôler le moment auquel est créé votre conteneur, définissez le paramètre sur False.
Supprimer les conteneurs à la fermeture du projet	True	Un seul projet, Docker Compose	Définissez le paramètre sur False si vous voulez que les conteneurs de votre solution soient conservés après la fermeture de la solution ou la fermeture de Visual Studio.
Exécuter un service dans des conteneurs pour activer l’authentification Azure	True	Un seul projet, Docker Compose	Visual Studio version 17.6 ou ultérieure exécute un service proxy de jeton dans le conteneur, qui facilite l’authentification Azure, afin que vos applications puissent utiliser les services Azure pendant le développement. Configurez sur False si vous ne souhaitez pas que ce service soit installé et exécuté.
Exécuter un service dans des conteneurs pour activer le service Rechargement à chaud	True	Un seul projet, Docker Compose	Configurez sur False si vous ne souhaitez pas que ce service soit installé et exécuté. Le service Rechargement à chaud est disponible dans Visual Studio 2022 version 17.7 et ultérieure et prend uniquement en charge l’exécution sans débogage (Ctrl+F5).

Les paramètres Fenêtre Outil de conteneurs contrôlent les paramètres qui s’appliquent à la fenêtre d’outil Conteneurs, qui affiche des informations sur les conteneurs et les images Docker. Consultez Utiliser la fenêtre Conteneurs.

Le tableau suivant décrit les paramètres de la fenêtre Conteneurs :

Nom	Paramètre par défaut	Description
Confirmer avant d’élaguer les conteneurs	Toujours	Contrôle si vous êtes invité à confirmer l’opération d’élagage des conteneurs inutilisés.
Confirmer avant d’élaguer les images	Toujours	Contrôle si vous êtes invité à confirmer l’opération d’élagage des images inutilisées.
Confirmer avant de supprimer un conteneur	Toujours	Contrôle si vous êtes invité à confirmer l’opération de suppression d’un conteneur.
Confirmer avant de supprimer une image	Toujours	Contrôle si vous êtes invité à confirmer l’opération de suppression d’une image.
Confirmer avant d'exécuter un grand nombre d’images	Toujours	Contrôle si vous êtes invité à confirmer le démarrage de conteneurs de plus de 10 images à la fois.

Avertissement

Si le certificat SSL localhost n’est pas approuvé et que vous sélectionnez la case pour supprimer l’invite, les requêtes web HTTPS risquent d’échouer au moment de l’exécution dans votre application ou service. Dans ce cas, effacez Ne pas demander, exécutez votre projet et confirmez l’approbation à l’invite.

Configurer l’authentification Azure

Si votre application utilise des services Azure, elle a besoin des informations d’identification d’authentification appropriées lorsqu’elle s’exécute dans un conteneur afin de s’authentifier auprès des services Azure. Pendant le développement, vous pouvez généralement utiliser vos propres informations d’identification Azure au lieu des informations d’identification utilisées par l’application en production, mais ces informations d’identification sont nécessaires dans l’environnement de conteneur pour être utiles à l’application conteneurisée en cours d’exécution.

À compter de Visual Studio 2022 version 17.6, dans les projets à conteneur unique et Docker Compose, un service proxy de jeton est déployé et exécuté dans vos conteneurs pour faciliter l’authentification de vos applications et services dans Azure. La fonctionnalité nécessite Azure Identity 1.9.0 ou version ultérieure. Une fois ce service activé, vous pouvez utiliser automatiquement la plupart des services Azure sans aucune autre configuration dans le conteneur. Plus précisément, votre code peut utiliser DefaultAzureCredential et VisualStudioCredential s’authentifier auprès des services Azure de la même manière qu’en dehors d’un conteneur. Consultez le fichier README Azure Identity 1.9.0.

Pour désactiver cette fonctionnalité, définissez le paramètreOutils>OptionsExécuter un service dans des conteneurs pour activer l’authentification Azure (décrit plus haut dans cet article) sur False.

Attention

Il existe un problème de sécurité potentiel si vous utilisez le proxy de jeton et que vous avez activé certains journaux de diagnostic Outils de conteneur. Lorsque la journalisation est activée, il est possible de consigner les informations d’identification d’authentification en texte brut. Ces journaux sont activés par certaines variables d’environnement. Pour des projets de conteneur unique, la variable d’environnement est MS_VS_CONTAINERS_TOOLS_LOGGING_ENABLED, qui se connecte ensuite à %tmp%\Microsoft.VisualStudio.Containers.Tools. Pour les projets Docker Compose, il s’agit de MS_VS_DOCKER_TOOLS_LOGGING_ENABLED qui se connecte ensuite à %tmp%\Microsoft.VisualStudio.DockerCompose.Tools.

Contenu connexe

Pour en savoir plus sur l’utilisation des conteneurs dans Visual Studio, consultez cette vue d’ensemble.