Freigeben über

Visual Studio-Containertools

Die in Visual Studio zum Entwickeln mit Docker - oder Podman-Containern enthaltenen Tools vereinfachen das Erstellen, Debuggen und Bereitstellen für containerisierte Anwendungen erheblich. Sie können mit einem Container für ein einzelnes Projekt arbeiten oder container-Orchestrierung mit Docker Compose verwenden.

Die in Visual Studio zum Entwickeln mit Docker-Containern enthaltenen Tools vereinfachen das Erstellen, Debuggen und Bereitstellen für containerisierte Anwendungen erheblich. Sie können mit einem Container für ein einzelnes Projekt arbeiten oder container-Orchestrierung mit Docker Compose oder Service Fabric verwenden, um mit mehreren Diensten in Containern zu arbeiten.

Voraussetzungen

Containerunterstützung in Visual Studio

Containerunterstützung ist für ASP.NET Core-Projekte und .NET Core-Konsolenprojekte (und .NET 5 und höher) verfügbar. .NET Framework-Projekte werden in der aktuellen Version von Visual Studio nicht unterstützt.

Wenn Sie nur einen Container für ein einzelnes Projekt benötigen, ohne die Orchestrierung zu verwenden, können Sie dies tun, indem Sie die Containerunterstützung hinzufügen. Sie können Docker oder Podman als Containerplattform auswählen und einfach zwischen ihnen wechseln, ohne das Projekt zu ändern. Die nächste Ebene ist die Unterstützung von Container compose, die geeignete Supportdateien für Docker Compose hinzufügt. (Podman Compose wird nicht unterstützt.)

Wenn Sie einem .NET 7- oder höher-Projekt Containerunterstützung hinzufügen, können Sie zwischen zwei Container-Build-Typen wählen. Sie können eine Dockerfile-Datei hinzufügen, um anzugeben, wie die Containerimages erstellt werden sollen, oder Sie können die integrierte Containerunterstützung verwenden, die vom .NET SDK bereitgestellt wird.

Im Fenster "Container" können Sie ausgeführte Container anzeigen, verfügbare Images durchsuchen, Umgebungsvariablen, Protokolle und Portzuordnungen anzeigen, das Dateisystem überprüfen, einen Debugger anfügen oder ein Terminalfenster in der Containerumgebung öffnen. Weitere Informationen finden Sie unter Verwenden des Fensters „Container“.

Voraussetzungen

Docker-Unterstützung in Visual Studio

Docker-Unterstützung ist für ASP.NET Projekte, ASP.NET Core-Projekte und .NET Core- und .NET Framework-Konsolenprojekte verfügbar.

Die Unterstützung für Docker in Visual Studio hat sich aufgrund der Kundenanforderungen über eine Reihe von Versionen geändert. Es gibt mehrere Optionen zum Hinzufügen der Docker-Unterstützung zu einem Projekt, und die unterstützten Optionen variieren je nach Projekttyp und Version von Visual Studio. Wenn Sie bei einigen unterstützten Projekttypen nur einen Container für ein einzelnes Projekt benötigen, ohne die Orchestrierung zu verwenden, können Sie dies tun, indem Sie docker-Unterstützung hinzufügen. Die nächste Ebene ist container-Orchestrierungsunterstützung, die geeignete Supportdateien für den ausgewählten Orchestrator hinzufügt.

Mit Visual Studio 2022, Version 17.9 und höher, wenn Sie Docker-Unterstützung zu einem .NET 7- oder höher-Projekt hinzufügen, verfügen Sie über zwei Containerbuildtypen, aus denen Sie die Docker-Unterstützung hinzufügen können. Sie können eine Dockerfile-Datei hinzufügen, um anzugeben, wie die Containerimages erstellt werden sollen, oder Sie können die integrierte Containerunterstützung verwenden, die vom .NET SDK bereitgestellt wird.

Außerdem können Sie mit Visual Studio 2022 und höher, wenn Sie die Container-Orchestrierung auswählen, Docker Compose oder Service Fabric als Container-Orchestrierungsdienste verwenden.

In Visual Studio 2022 ist das fenster Container verfügbar, mit dem Sie ausgeführte Container anzeigen, verfügbare Bilder durchsuchen, Umgebungsvariablen, Protokolle und Portzuordnungen anzeigen, das Dateisystem überprüfen, einen Debugger anfügen oder ein Terminalfenster in der Containerumgebung öffnen können. Weitere Informationen finden Sie unter Verwenden des Fensters „Container“.

Informationen zum Erstellen eines Projekts mit Containerunterstützung oder zum Hinzufügen von Containerunterstützung zu einem vorhandenen Projekt finden Sie unter Hinzufügen der Unterstützung für Container.

Informationen zum Erstellen eines Projekts mit Docker-Unterstützung oder Zum Hinzufügen von Docker-Unterstützung zu einem vorhandenen Projekt finden Sie unter Hinzufügen der Unterstützung für Container.

Anmerkung

Die Lizenzierungsanforderungen von Docker können für verschiedene Versionen von Docker Desktop unterschiedlich sein. Lesen Sie die Docker-Dokumentation, um die aktuellen Lizenzierungsanforderungen für die Verwendung Ihrer Version von Docker Desktop für die Entwicklung in Ihrer Situation zu verstehen.

Podman-Unterstützung in Visual Studio

Visual Studio unterstützt Podman-Container, ein beliebtes Containerverwaltungstool, das ein daemonloses Containermodul bereitstellt. Sie können Container über die Podman CLI direkt aus Visual Studio ausführen und verwalten. Sie können Podman verwenden, um Ihre Einzelcontainer-Apps auf die gleiche Weise wie Docker auszuführen.

Um Podman-Container zu verwenden, starten Sie Podman über die CLI, und öffnen Sie Ihre Lösung in Visual Studio. Standardmäßig erkennt Containertools automatisch, ob Podman oder Docker ausgeführt wird, und verwendet die derzeit aktive Containerlaufzeit, wenn Sie die App starten. Um die Container-Laufzeitumgebung manuell zu konfigurieren, gehen Sie zu Tools > Optionen > Container-Tools > Container-Laufzeitumgebung und wählen Sie Podman oder Docker aus. Die Standardeinstellung ist "Auto", was bedeutet, dass Visual Studio versucht, die derzeit aktive Containerlaufzeit zu erkennen. Schließen Sie das Fenster "Extras-Optionen>", um die Einstellungsänderung zu übernehmen.

Container-Fenster

Im Fenster Container können Sie Container und Bilder auf Ihrem Computer anzeigen und sehen, was mit ihnen passiert. Sie können das Dateisystem, die bereitgestellten Volumes, Umgebungsvariablen, verwendete Ports und Protokolldateien anzeigen.

Öffnen Sie das Fenster Container mithilfe der Schnellstartleiste (STRG+Q) und geben Sie containersein. Sie können die Docking-Steuerelemente verwenden, um das Fenster an einer beliebigen Stelle zu platzieren. Aufgrund der Breite des Fensters funktioniert es am besten, wenn es am unteren Bildschirmrand angedockt wird.

Wählen Sie einen Container aus, und verwenden Sie die Registerkarten, um die verfügbaren Informationen anzuzeigen. Um es auszuchecken, führen Sie Ihre Docker-fähige App aus, öffnen Sie die Registerkarte Dateien, und erweitern Sie den Ordner App, um die bereitgestellte App im Container anzuzeigen.

Screenshot des Fensters

Screenshot des Fensters

Weitere Informationen finden Sie unter Verwenden des Container-Fensters.

Docker Compose-Unterstützung

Wenn Sie eine Multicontainerlösung mit Docker Compose erstellen möchten, fügen Sie Ihren Projekten Container-Orchestratorunterstützung hinzu. Auf diese Weise können Sie eine Gruppe von Containern (eine ganze Projektmappe oder Eine Gruppe von Projekten) gleichzeitig ausführen und debuggen, wenn sie in derselben docker-compose.yml Datei definiert sind.

Wenn Sie Container-Orchestrator-Unterstützung mithilfe von Docker Compose hinzufügen wollen, klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Anwendung und wählen Sie dann "Container Compose-Unterstützung hinzufügen" aus.

Um die Unterstützung des Containerorchestrators unter Verwendung von Docker Compose hinzuzufügen, klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, und wählen Sie Hinzufügen > Unterstützung für Containerorchestrator aus. Wählen Sie dann Docker Compose aus, um die Container zu verwalten.

Nachdem Sie Ihrem Projekt die Unterstützung der Containerorchestrierung hinzugefügt haben, können Sie wie im Folgenden gezeigt im Projektmappen-Explorer sehen, dass dem Projekt (sofern bisher noch nicht vorhanden) ein Dockerfile und der Projektmappe der Ordner docker-compose hinzugefügt wurde:

Screenshot, der die Docker-Dateien im Solution-Explorer zeigt.

Screenshot von Docker-Dateien im Projektmappen-Explorer in Visual Studio.

Wenn docker-compose.yml bereits vorhanden ist, fügt Visual Studio lediglich die erforderlichen Konfigurationscodezeilen hinzu.

Wiederholen Sie den Prozess mit den anderen Projekten, die Sie mithilfe von Docker Compose steuern möchten.

Wenn Sie mit einer großen Anzahl von Diensten arbeiten, können Sie Zeit und Rechenressourcen sparen, indem Sie auswählen, welche Teilmenge von Diensten Sie in Ihrer Debugsitzung starten möchten. Weitere Informationen finden Sie unter Starten einer Teilmenge der Compose-Dienste.

Anmerkung

Remote-Docker-Hosts werden in visual Studio-Tools nicht unterstützt.

Service Fabric-Unterstützung

Die Service Fabric-Anwendungsprojekte wurden in Visual Studio 2026 entfernt und werden zu einer Visual Studio-Erweiterung. Status der Verfügbarkeit finden Sie in diesem GitHub-Issue.

Mit Service Fabric-Tools in Visual Studio können Sie Azure Service Fabric entwickeln und debuggen, lokal ausführen und debuggen und in Azure bereitstellen.

Visual Studio 2019 und Visual Studio 2022 unterstützen die Entwicklung von containerisierten Microservices mithilfe von Windows-Containern und service Fabric-Orchestrierung.

Ein ausführliches Lernprogramm finden Sie im Lernprogramm: Bereitstellen einer .NET-Anwendung in einem Windows-Container in Azure Service Fabric.

Weitere Informationen zu Azure Service Fabric finden Sie unter Service Fabric.

Kontinuierliche Bereitstellung und kontinuierliche Integration (CI/CD)

Visual Studio lässt sich problemlos in Azure-Pipelines integrieren, um die automatische und kontinuierliche Integration und Bereitstellung von Änderungen an Ihrem Dienstcode und Ihrer Konfiguration zu ermöglichen. Informationen zu den ersten Schritten finden Sie unter Erstellen Ihrer ersten Pipeline.

Für Service Fabric, siehe Tutorial: Bereitstellung Ihrer ASP.NET Core-App in Azure Service Fabric mit Azure DevOps-Projekten.

Nächste Schritte

Weitere Informationen zur Implementierung und Verwendung von Visual Studio-Tools für die Arbeit mit Containern finden Sie in den folgenden Artikeln:

Hinzufügen von Unterstützung für Container

Containertools in Visual Studio

Debuggen von Apps in einem lokalen Container

Bereitstellen eines ASP.NET Containers in einer Containerregistrierung mithilfe von Visual Studio

Bereitstellen in Azure App Service

Bereitstellen in Azure Container Apps mithilfe von Visual Studio

  • Last updated on