Visual Studio 容器工具

用于使用 Docker 或 Podman 容器进行开发的 Visual Studio 中包含的工具极大地简化了容器化应用程序的生成、调试和部署。 可以使用单个项目的容器，也可以将容器业务流程与 Docker Compose 配合使用。

用于使用 Docker 容器进行开发的 Visual Studio 中包含的工具极大地简化了容器化应用程序的生成、调试和部署。 可以使用单个项目的容器，或者将容器业务流程与 Docker Compose 或 Service Fabric 配合使用，以便处理容器中的多个服务。

先决条件

• Docker Desktop
• 安装了 ASP.NET 和 Web 开发、Azure 开发工作负载和/或 .NET Core 跨平台开发工作负载的 Visual Studio 2019 或更高版本。
• 用于使用 .NET Core 进行开发的 .NET Core 开发工具。
• 若要发布到 Azure 容器注册表，需要 Azure 订阅。 注册免费试用版。

Visual Studio 中的 Docker 支持

Docker 支持适用于 ASP.NET 项目、ASP.NET 核心项目和 .NET Core 和 .NET Framework 控制台项目。

Visual Studio 中对 Docker 的支持因许多版本而发生更改，以响应客户需求。 可以向项目添加两个级别的 Docker 支持，支持的选项因项目类型和 Visual Studio 版本而异。 对于某些受支持的项目类型，如果只需要单个项目的容器，而无需使用业务流程，可以通过添加 Docker 支持来执行此操作。 下一个级别是容器业务流程支持，这将为所选的特定业务流程协调程序添加适当的支持文件。

使用 Visual Studio 2019，可以使用 Docker Compose、Kubernetes 和 Service Fabric 作为容器业务流程服务。

在 Visual Studio 2019 版本 16.4 及更高版本中，容器 窗口可用，可用于查看正在运行的容器、浏览可用映像、查看环境变量、日志和端口映射、检查文件系统、附加调试器或在容器环境中打开终端窗口。 请参阅使用“容器”窗口。

先决条件

• Docker Desktop 或 Podman Desktop
• Visual Studio 或针对 Podman 支持，Visual Studio（Insider 版本），需安装 ASP.NET 和 Web 开发、Azure 开发 工作负载，和/或 .NET 桌面开发 工作负载。
• 若要发布到 Azure 容器注册表，需要 Azure 订阅。 注册免费试用版。

Visual Studio 中的容器支持

容器支持适用于 ASP.NET 核心项目，以及 .NET Core（以及 .NET 5 及更高版本）控制台项目。 当前版本的 Visual Studio 不支持 .NET Framework 项目。

如果您只需一个用于单个项目的容器，而不需要使用编排，可以通过添加容器支持来实现。 可以选择 Docker 或 Podman 作为容器平台，并在它们之间轻松切换，而无需更改项目。 下一个级别是 Container Compose 支持，它为 Docker Compose 添加了适当的支持文件。 （不支持 Podman Compose。

向 .NET 7 或更高版本项目添加容器支持时，有两种容器生成类型可供选择，用于添加容器支持。 可以选择添加 Dockerfile 以指定如何生成容器映像，也可以选择使用 .NET SDK 提供的内置容器支持。

使用 “容器 ”窗口可以查看正在运行的容器、浏览可用映像、查看环境变量、日志和端口映射、检查文件系统、附加调试器或打开容器环境中的终端窗口。 请参阅使用“容器”窗口。

先决条件

• Docker Desktop
• Visual Studio。 对于 Podman 支持，需要安装了 ASP.NET 工作负载和 Web 开发工作负载、Azure 开发工作负载和/或 .NET 桌面开发工作负载的 Visual Studio（内部预览版）。
• 若要发布到 Azure 容器注册表，需要 Azure 订阅。 注册免费试用版。

Visual Studio 中的 Docker 支持

Docker 支持适用于 ASP.NET 项目、ASP.NET 核心项目和 .NET Core 和 .NET Framework 控制台项目。

Visual Studio 中对 Docker 的支持因许多版本而发生更改，以响应客户需求。 有几个选项可用于向项目添加 Docker 支持，支持的选项因项目类型和 Visual Studio 版本而异。 对于某些受支持的项目类型，如果只需要单个项目的容器，而无需使用业务流程，可以通过添加 Docker 支持来执行此操作。 下一个级别是容器业务流程支持，这将为所选的特定业务流程协调程序添加适当的支持文件。

使用 Visual Studio 2022 版本 17.9 及更高版本，将 Docker 支持添加到 .NET 7 或更高版本项目时，有两种容器生成类型可供选择，以便添加 Docker 支持。 可以选择添加 Dockerfile 以指定如何生成容器映像，也可以选择使用 .NET SDK 提供的内置容器支持。

此外，使用 Visual Studio 2022 及更高版本，选择容器业务流程时，可以使用 Docker Compose 或 Service Fabric 作为容器业务流程服务。

在 Visual Studio 2022 中，容器 窗口可用，可用于查看正在运行的容器、浏览可用映像、查看环境变量、日志和端口映射、检查文件系统、附加调试器或打开容器环境中的终端窗口。 请参阅使用“容器”窗口。

若要创建具有容器支持的项目，或向现有项目添加容器支持，请参阅 “添加对容器的支持”。

若要使用 Docker 支持创建项目，或向现有项目添加 Docker 支持，请参阅 添加对容器的支持。

Visual Studio 中的 Podman 支持

Visual Studio 支持 Podman 容器，这是一种提供无守护容器引擎的常用容器管理工具。 可以直接从 Visual Studio 使用 Podman CLI 运行和管理容器。 可以使用 Podman 以与 Docker 相同的方式运行单容器应用。

若要使用 Podman 容器，请从 CLI 启动 podman，并在 Visual Studio 中打开解决方案。 默认情况下，容器工具会自动检测 Podman 还是 Docker 正在运行，并在启动应用时使用当前活动的容器运行时。 若要手动配置容器运行时，请转到 工具 > 选项 > 容器工具 > 容器运行时 并选择 Podman 或 Docker。 默认设置为 “自动”，这意味着 Visual Studio 会尝试检测当前活动的容器运行时。 关闭“工具选项”>窗口以提交设置更改。