使用 Docker Compose 为 Visual Studio for Mac 创建多容器应用

项目
05/03/2022

适用于： Visual Studio for Mac Visual Studio

在本教程中，你将了解如何在 Visual Studio for Mac 中使用 Docker Compose 管理多个容器并在它们之间通信。

若要查找有关Visual Studio Windows版本的步骤，请阅读教程：使用 docker Compose 创建包含 Visual Studio Windows 的多容器应用。

先决条件

创建 ASP.NET Core Web 应用程序并添加 Docker 支持

通过转到“文件”>“新建解决方案” 来创建新解决方案。
在“Web 和控制台”>“应用”下，选择“Web 应用程序”模板：
选择目标框架。本示例将使用 .NET Core 3.1：
输入项目详细信息，例如项目名称（在此示例中为 DockerDemoFrontEnd）和解决方案名称 (DockerDemo)。创建的项目包含生成并运行 ASP.NET Core Web 站点所需的所有基础知识。
在解决方案窗口中，右键单击 DockerDemoFrontEnd 项目，并选择“添加”>“添加 Docker 支持”：

Visual Studio for Mac 自动将新项目添加到名为 docker-compose 的解决方案，并将 Dockerfile 添加到现有项目。

创建 ASP.NET Core Web API 并添加 Docker 支持

接下来我们将创建第二个项目，其将充当后端 API。 .NET Core API 模板包括支持处理 RESTful 请求的控制器。

通过右键单击解决方案并选择“添加”>“添加新项目” ，将新项目添加到现有解决方案中。
在“Web 和控制台”>“应用”下，选择“API”模板。
选择目标框架。本示例将使用 .NET Core 3.1。
输入项目详细信息，例如项目名称（在本例中为 MyWebAPI）。
创建后，转到解决方案窗口，右键单击 MyWebAPI 项目并选择“添加”>“添加 Docker 支持”。

docker-compose 项目中的 docker-compose.yml 文件将自动更新，以包含与现有 Web 应用项目一起的 API 项目。当生成并运行 docker-compose 项目中，其中每个项目都将部署到单独的 Docker 容器。

version: '3.4'

services:
  dockerdemofrontend:
    image: ${DOCKER_REGISTRY-}dockerdemofrontend
    build:
      context: .
      dockerfile: DockerDemoFrontEnd/Dockerfile

  mywebapi:
    image: ${DOCKER_REGISTRY-}mywebapi
    build:
      context: .
      dockerfile: MyWebAPI/Dockerfile

集成两个容器

现在我们的解决方案中有两个 ASP.NET 项目，二者都已配置为具有 Docker 支持。接下来我们需要添加一些代码！

在 DockerDemoFrontEnd 项目中，打开 Pages/Index.cshtml.cs 文件，使用以下代码替换 OnGet 方法：

 public async Task OnGet()
 {
    ViewData["Message"] = "Hello from webfrontend";

    using (var client = new System.Net.Http.HttpClient())
    {
       // Call *mywebapi*, and display its response in the page
       var request = new System.Net.Http.HttpRequestMessage();
       request.RequestUri = new Uri("http://mywebapi/WeatherForecast");
       var response = await client.SendAsync(request);
       ViewData["Message"] += " and " + await response.Content.ReadAsStringAsync();
    }
 }

备注

在生产代码中，不应在每次请求后释放 HttpClient。有关最佳做法，请参阅使用 HttpClientFactory 实现复原 HTTP 请求。

在 Index.cshtml 文件中，添加一行以显示 ViewData["Message"]，以便该文件看起来如以下代码：

@page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}

<div class="text-center">
    <h1 class="display-4">Welcome</h1>
    <p>Learn about <a href="https://docs.microsoft.com/aspnet/core">building Web apps with ASP.NET Core</a>.</p>
    <p>@ViewData["Message"]</p>
</div>

在前端项目和 Web API 项目中，注释掉 Startup.cs 的 Configure 方法中对 Microsoft.AspNetCore.Builder.HttpsPolicyBuilderExtensions.UseHttpsRedirection 的调用，因为此示例代码使用 HTTP（而不是 HTTPS）来调用 Web API。
```
            //app.UseHttpsRedirection();
```
将 docker-compose 项目设置为启动项目并转到“运行”>“开始调试”。如果所有内容配置正确，你将看到消息“Hello from webfrontend and webapi (with value 1)”：

Docker 多容器解决方案正在运行

使用 Docker Compose 为 Visual Studio for Mac 创建多容器应用

此页面有帮助吗?

先决条件

创建 ASP.NET Core Web 应用程序并添加 Docker 支持

创建 ASP.NET Core Web API 并添加 Docker 支持

集成两个容器