Erstellen eines Containerprojekts über die Befehlszeile

Wenn Sie ein Containerprojekt mit einer Dockerfile außerhalb von Visual Studio erstellen möchten, können Sie docker build (oder podman build) oder dotnet publish /t:PublishContainer auf der Kommandozeile bauen.

Wenn Sie den .NET SDK-Buildtyp verwenden, haben Sie keine Dockerfile, daher können Sie docker build oder podman build nicht verwenden; stattdessen können Sie dotnet publish /t:PublishContainer nutzen, um über die Befehlszeile zu erstellen.

Wenn Sie ein Containerprojekt mit einer Dockerfile außerhalb von Visual Studio erstellen möchten, können Sie es verwenden docker build oder dotnet publish /t:PublishContainer aus der Befehlszeile erstellen.

Wenn Sie den .NET SDK-Buildtyp verwenden, da Sie keine Dockerfile besitzen, können Sie docker build nicht nutzen; verwenden Sie stattdessen dotnet publish /t:PublishContainer, um über die Befehlszeile zu erstellen.

Voraussetzungen

• Docker Desktop oder Podman Desktop.
• Visual Studio oder für Podman-Unterstützung , Visual Studio 2026, mit installierter ASP.NET und Webentwicklung, Azure-Entwicklungsarbeitsauslastung und/oder .NET-Desktopentwicklungsworkload .

Voraussetzungen

• Docker Desktop.
• Visual Studio mit installierter ASP.NET- und Webentwicklung, Azure-Entwicklungsarbeitsauslastung und/oder .NET-Desktopentwicklungsworkload .

Verwenden Sie Docker-Build

Um eine containerisierte Lösung über die Befehlszeile zu erstellen, können Sie in der Regel den Befehl docker build <context> für jedes Projekt in der Projektmappe verwenden. Dabei müssen Sie das Argument für den Buildkontext angeben. Der Buildkontext eines Dockerfile auf dem lokalen Computer ist der Ordner, der als Arbeitsordner zum Generieren des Images verwendet wird. Beispielsweise ist es der Ordner, aus dem Sie Dateien kopieren, wenn Sie in den Container kopieren. In .NET Core-Projekten wird standardmäßig der Ordner verwendet, der die Lösungsdatei enthält (.sln oder SLNX). Dieses Argument wird als relativer Pfad angegeben und ist in der Regel „..“ für ein Dockerfile in einem Projektordner und für die Projektmappendatei im übergeordneten Ordner.

docker build -f Dockerfile ..

Bei .NET Framework-Projekten ist der Standardbuildkontext der Projektordner und nicht der Projektmappenordner.

Sie können den Buildkontext in der Projektdatei festlegen, indem Sie die eigenschaft DockerfileContext festlegen. Zum Beispiel

<PropertyGroup>
   <DockerfileContext>contextfolder</DockerfileContext>
</PropertyGroup>

Verwenden von Docker-Build oder Podman-Build

Um eine containerisierte Lösung über die Befehlszeile zu erstellen, können Sie in der Regel den Befehl docker build <context> (oder podman build <context>) für jedes Projekt in der Projektmappe verwenden. Dabei müssen Sie das Argument für den Buildkontext angeben. Der Buildkontext eines Dockerfile auf dem lokalen Computer ist der Ordner, der als Arbeitsordner zum Generieren des Images verwendet wird. Beispielsweise ist es der Ordner, aus dem Sie Dateien kopieren, wenn Sie in den Container kopieren. In .NET Core-Projekten wird standardmäßig der Ordner verwendet, der die Lösungsdatei enthält (.sln oder SLNX). Dieses Argument wird als relativer Pfad angegeben und ist in der Regel „..“ für ein Dockerfile in einem Projektordner und für die Projektmappendatei im übergeordneten Ordner.

docker build -f Dockerfile ..

podman build -f Dockerfile ..

Sie können den Buildkontext in der Projektdatei festlegen, indem Sie die eigenschaft ContainerBuildContext festlegen. Zum Beispiel

<PropertyGroup>
   <ContainerBuildContext>contextfolder</ContainerBuildContext>
</PropertyGroup>

Mit Visual Studio 17.11 und höher können Sie beim Hinzufügen der Docker-Unterstützung zu einem Projekt einen Ordner für den Buildkontext angeben. Wenn Sie den Buildkontext ändern möchten, können Sie die Dockerfile-Datei löschen (wenn keine anderen Änderungen vorhanden sind, die Sie beibehalten möchten), und führen Sie Hinzufügen der Docker-Unterstützungerneut aus, dieses Mal den neuen Buildkontext angeben. Die neue Dockerfile wird relative Pfade aktualisieren, um dem neuen Buildkontext zu entsprechen.

Wenn Sie einem Projekt Containerunterstützung hinzufügen, können Sie einen Ordner für den Buildkontext angeben. Wenn Sie den Build-Kontext ändern möchten, können Sie die Dockerfile-Datei löschen (vorausgesetzt, es gibt keine anderen Änderungen, die Sie beibehalten möchten), und Containerunterstützung hinzufügen erneut ausführen, diesmal den neuen Build-Kontext angeben. Die neue Dockerfile wird relative Pfade aktualisieren, um dem neuen Buildkontext zu entsprechen.

Dockerfiles, die von Visual Studio für .NET Framework-Projekten (und für .NET Core-Projekte erstellt wurden, die mit Versionen von Visual Studio vor Visual Studio 2017 Update 4 erstellt wurden) sind keine mehrstufigen Dockerfiles. Die Schritte in diesen Dockerfiles kompilieren Ihren Code nicht. Wenn Visual Studio stattdessen eine .NET Framework Dockerfile erstellt, kompiliert es zuerst Ihr Projekt mithilfe von MSBuild. Wenn dies erfolgreich ist, erstellt Visual Studio dann die Dockerfile-Datei, die einfach die Buildausgabe von MSBuild in das resultierende Docker-Image kopiert. Da die Schritte zum Kompilieren ihres Codes nicht in der Dockerfile enthalten sind, können Sie .NET Framework Dockerfiles nicht mit docker build über die Befehlszeile erstellen. Sie sollten MSBuild verwenden, um diese Projekte zu erstellen.

Visual Studio verwendet den Fast-Modus (sofern aktiviert), um ein Containerimage zu erstellen, das für die Entwicklung und das Debuggen am besten konfiguriert ist. Daher wird nicht empfohlen, die Docker-Buildbefehle aus dem Ausgabefenster nach einem Fast Mode-Build zu kopieren. Um ein Standardimage ohne nicht standardmäßige Optimierungen zu erstellen, können Sie mit der rechten Maustaste auf die Dockerfile-Datei klicken und die Option "Docker-Image erstellen" auswählen.

Visual Studio verwendet den Fast-Modus (sofern aktiviert), um ein Containerimage zu erstellen, das für die Entwicklung und das Debuggen am besten geeignet ist. Daher wird nicht empfohlen, die docker buildpodman build Befehle nach einem Schnellmodus-Build aus dem Ausgabefenster zu kopieren. Um ein Standardimage ohne nicht standardmäßige Optimierungen zu erstellen, können Sie mit der rechten Maustaste auf die Dockerfile-Datei klicken und die Option "Image erstellen " auswählen.