Outils de conteneur Visual Studio pour Docker

Prérequis

• Docker Desktop
• Visual Studio 2019 avec la charge de travail Développement web, Outils Azure et/ou la charge de travail Développement multiplateforme .NET Core installée
• Outils de développement .NET Core pour le développement avec .NET Core.
• Pour publier sur Azure Container Registry, un abonnement Azure. Inscrivez-vous pour un essai gratuit.

Prise en charge de Docker dans Visual Studio

La prise en charge de Docker est disponible pour les projets ASP.NET, les projets ASP.NET Core, et les projets de console .NET Core et .NET Framework.

La prise en charge de Docker dans Visual Studio a été modifiée sur un certain nombre de versions pour répondre aux besoins des clients. Il existe deux niveaux de prise en charge de Docker que vous pouvez ajouter à un projet, et les options prises en charge varient selon le type de projet et la version de Visual Studio. Pour certains types de projets pris en charge, si vous souhaitez utiliser un conteneur dans un seul projet, sans orchestration, ajoutez la prise en charge de Docker. Le niveau suivant est la prise en charge de l’orchestration de conteneur, qui ajoute les fichiers de prise en charge appropriés pour l’orchestrateur spécifique que vous choisissez.

Visual Studio 2019 vous permet d’utiliser Docker Compose, Kubernetes et Service Fabric comme services d’orchestration de conteneur.

Dans Visual Studio 2019 version 16.4 et versions ultérieures, la fenêtre Conteneurs vous permet d’afficher les conteneurs en cours d’exécution, de parcourir les images disponibles, d’afficher les variables d’environnement, les journaux et les mappages de ports, d’inspecter le système de fichiers, d’attacher un débogueur ou d’ouvrir une fenêtre de terminal à l’intérieur de l’environnement de conteneur. Consultez Utiliser la fenêtre Conteneurs.

Prérequis

• Docker Desktop
• Visual Studio 2022 avec la charge de travail Développement web, Outils Azure et/ou la charge de travail Développement .NET Desktop installée
• Pour publier sur Azure Container Registry, un abonnement Azure. Inscrivez-vous pour un essai gratuit.

Prise en charge de Docker dans Visual Studio

La prise en charge de Docker est disponible pour les projets ASP.NET, les projets ASP.NET Core, et les projets de console .NET Core et .NET Framework.

La prise en charge de Docker dans Visual Studio a été modifiée sur un certain nombre de versions pour répondre aux besoins des clients. Il existe plusieurs options pour ajouter la prise en charge de Docker à un projet, et les options prises en charge varient en fonction du type de projet et de la version de Visual Studio. Pour certains types de projets pris en charge, si vous souhaitez utiliser un conteneur dans un seul projet, sans orchestration, ajoutez la prise en charge de Docker. Le niveau suivant est la prise en charge de l’orchestration de conteneur, qui ajoute les fichiers de prise en charge appropriés pour l’orchestrateur spécifique que vous choisissez.

Avec Visual Studio 2022 version 17.9 et ultérieures, lorsque vous ajoutez la prise en charge de Docker à un projet .NET 7 ou ultérieur, vous avez le choix entre deux types de build de conteneur pour ajouter la prise en charge de Docker. Vous pouvez choisir d’ajouter un Dockerfile pour spécifier comment générer les images conteneur, ou d’utiliser la prise en charge de conteneur intégrée fournie par le Kit de développement logiciel (SDK) .NET.

En outre, avec Visual Studio 2022 et versions ultérieures, lorsque vous choisissez l’orchestration de conteneurs, vous pouvez utiliser Docker Compose ou Service Fabric comme services d’orchestration de conteneurs.

Dans Visual Studio 2022, la fenêtre Conteneurs vous permet d’afficher les conteneurs en cours d’exécution, de parcourir les images disponibles, d’afficher les variables d’environnement, les journaux et les mappages de ports, d’inspecter le système de fichiers, d’attacher un débogueur ou d’ouvrir une fenêtre de terminal à l’intérieur de l’environnement de conteneur. Consultez Utiliser la fenêtre Conteneurs.

Ajouter la prise en charge Docker

Lorsque vous ajoutez ou activez la prise en charge de Docker, Visual Studio ajoute les éléments suivants au projet :

• un fichier Dockerfile
• Un fichier .dockerignore
• une référence de package NuGet pour Microsoft.VisualStudio.Azure.Containers.Tools.Targets

Le fichier Dockerfile que vous ajoutez ressemblera au code suivant. Dans cet exemple, le projet a été nommé WebApplication-Docker et vous avez choisi des conteneurs Linux :

#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.

FROM mcr.microsoft.com/dotnet/aspnet:3.1 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:3.1 AS build
WORKDIR /src
COPY ["WebApplication-Docker/WebApplication-Docker.csproj", "WebApplication-Docker/"]
RUN dotnet restore "WebApplication-Docker/WebApplication-Docker.csproj"
COPY . .
WORKDIR "/src/WebApplication-Docker"
RUN dotnet build "WebApplication-Docker.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "WebApplication-Docker.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "WebApplication-Docker.dll"]

Ajouter la prise en charge de Docker à l’aide du type de build de conteneur Dockerfile

Lorsque vous ajoutez ou activez la prise en charge de Docker dans un projet .NET 7 ou version ultérieure, Visual Studio affiche la boîte de dialogue Options de vue de structure de conteneur, qui vous donne le choix du système d’exploitation (Linux ou Windows), mais également la capacité à choisir le type de build de conteneur, Dockerfile ou SDK .NET. Cette boîte de dialogue n'apparaît pas dans les projets .NET Framework ou Azure Functions.

Dans les versions 17.11 et ultérieures, vous pouvez également spécifier la distribution de l'image de conteneur et le contexte de construction de Docker.

Distro de l'image du conteneur spécifie l'image du système d'exploitation que vos conteneurs utilisent comme image de base. Cette liste change si vous passez de Linux à Windows en tant que type de conteneur.

Les images suivantes sont disponibles :

Windows :

• Windows Nano Server (recommandé, disponible uniquement à partir de la version 8.0, non prédéfini pour les projets de déploiement anticipé (AOT))
• Windows Server Core (uniquement disponible à partir de la version 8.0)

Linux :

• Default (Debian, mais la balise est « 8.0 »)
• Debian
• Ubuntu
• Ubuntu ciselé
• Alpine

Contexte de construction Docker spécifie le dossier utilisé pour la construction Docker. Voir Contexte de build Docker. Le dossier par défaut est le dossier solution, ce qui est fortement recommandé. Tous les fichiers nécessaires à la construction doivent se trouver dans ce dossier, ce qui n'est généralement pas le cas si vous choisissez le dossier project ou un autre dossier.

Si vous choisissez Dockerfile, Visual Studio ajoute ce qui suit au projet :

• un fichier Dockerfile
• un fichier .dockerignore
• une référence de package NuGet pour Microsoft.VisualStudio.Azure.Containers.Tools.Targets

Le fichier Dockerfile que vous ajoutez ressemblera au code suivant. Dans cet exemple, le projet a été nommé WebApplication-Docker et vous avez choisi des conteneurs Linux :

#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["WebApplication-Docker/WebApplication-Docker.csproj", "WebApplication-Docker/"]
RUN dotnet restore "WebApplication-Docker/WebApplication-Docker.csproj"
COPY . .
WORKDIR "/src/WebApplication-Docker"
RUN dotnet build "WebApplication-Docker.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "WebApplication-Docker.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "WebApplication-Docker.dll"]

Conteneuriser une application .NET sans Dockerfile

Avec Visual Studio 2022 17.9 et versions ultérieures avec le kit SDK .NET 7 installé, dans les projets ASP.NET Core qui ciblent .NET 6 ou version ultérieure, vous avez la possibilité d’utiliser la prise en charge intégrée du kit SDK .NET pour les builds de conteneur, ce qui signifie que vous n’avez pas besoin d’un Dockerfile ; consultez Conteneuriser une application .NET avec dotnet publish. Au lieu de cela, vous configurez vos conteneurs à l’aide de propriétés MSBuild dans le fichier projet, et les paramètres de lancement des conteneurs avec Visual Studio sont encodés dans un fichier de configuration .json, launchSettings.json.

Ici, choisissez .NET SDK comme type de construction de conteneur pour utiliser la gestion de conteneur de .NET SDK au lieu d'un fichier Docker.

Distro de l'image du conteneur spécifie l'image du système d'exploitation que vos conteneurs utilisent comme image de base. Cette liste change si vous passez de Linux à Windows en tant que conteneur. Consultez la section précédente pour obtenir la liste des images disponibles.

L’entrée de build de conteneur du kit SDK .NET lors dans launchSettings.json ressemble au code suivant :

"Container (.NET SDK)": {
  "commandName": "SdkContainer",
  "launchBrowser": true,
  "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}",
  "environmentVariables": {
    "ASPNETCORE_HTTPS_PORTS": "8081",
    "ASPNETCORE_HTTP_PORTS": "8080"
  },
  "publishAllPorts": true,
  "useSSL": true
}

Le SDK .NET gère certains paramètres qui auraient été encodés dans un fichier Docker, tels que l'image de base du conteneur et les variables d'environnement à définir. Les paramètres disponibles dans le fichier projet pour la configuration du conteneur sont répertoriés dans Personnalisation de votre conteneur. Par exemple, la distribution de l'image du conteneur est enregistrée dans le fichier de projet en tant que propriété ContainerBaseImage. Vous pouvez les modifier ultérieurement en éditant le fichier de projet.

<PropertyGroup>
    <ContainerBaseImage>mcr.microsoft.com/dotnet/runtime:8.0-alpine-amd64</ContainerBaseImage>
</PropertyGroup>