Comment exécuter une application .NET dans Docker

Docker est un service de conteneurisation, utilisé pour exécuter des applications dans des environnements isolés emballés avec toutes les dépendances et le code dont il a besoin pour fonctionner. Il peut exécuter toutes sortes d'applications, y compris des programmes basés sur .NET à l'aide d'images d'exécution fournies par Microsoft.

Dockerizing .NET

Microsoft fournit des images de base prédéfinies pour exécuter des applications .NET. Vous n’avez pas besoin de gérer l’installation du runtime ou du SDK .NET dans votre conteneur Docker, car vous pouvez simplement étendre l’image de base de Microsoft à la version de .NET utilisée par votre application.

À moins que vous ne prévoyiez de déployer des conteneurs Windows sur un serveur Windows, vous devrez utiliser .NET Core ou .NET 5. L'ancien environnement d'exécution .NET Framework n'est pas multiplateforme et ne fonctionnera pas sur les conteneurs Linux.

Si Docker n'est pas installé sur votre machine de développement, vous devrez installer Docker Desktop pour avoir accès à la CLI. Si vous utilisez WSL sous Windows, vous souhaiterez activer le moteur basé sur WSL 2, qui offre de meilleures performances.

Pour tester les choses, nous allons créer une nouvelle application API ASP.NET. La même procédure générale s'appliquera à tout type d'application, car tout ce que Docker fait est d'exécuter une compilation chaque fois que vous créez le conteneur et de démarrer votre application avec une commande entrypoint.

Créez un nouveau fichier appelé Dockerfile à la racine de votre projet, là où se trouve votre solution. Collez dans la configuration suivante:

FROM mcr.microsoft.com/dotnet/core/sdk AS build-env
WORKDIR /app

# Copy csproj and restore
COPY *.csproj ./
RUN dotnet restore

# Copy everything else and build
COPY . ./
RUN dotnet publish -o out

# Build runtime image
FROM mcr.microsoft.com/dotnet/core/runtime
WORKDIR /app
COPY --from=build-env /app/out .
ENTRYPOINT ("dotnet", "DockerTest.dll")

Ce Dockerfile extrait l'image du SDK .NET Core pour effectuer la génération. Il copie le .csproj over et restaure, puis copie tout le reste et exécute une construction. Ensuite, il crée une nouvelle image à partir de l'image .NET Runtime et copie les artefacts de génération.

Enfin, le point d'entrée est défini ici comme dotnet DockerTest.dll. Cela démarrera le serveur Web ASP.NET, même si vous devrez peut-être modifier les paramètres de votre application ou spécifier une commande de point d'entrée entièrement différente.

Vous pouvez tester l'exécution de votre conteneur avec docker container run, en le passant dans l'ID du conteneur de construction:

docker container run containerid

Pour une application ASP.NET, vous devrez ouvrir des ports en mappant un port sur l'hôte à un port sur le conteneur:

docker run -p 80:80 containerid

Vous pouvez lire notre guide sur l'utilisation de Docker et Dockerfiles pour en savoir plus.