一、实例环境与工具

Visual Studio 2022 + .NET 6.0(长期支持) +Docker Desktop 4.6.1

二、实例阅读知识储备

了解ASP.NET Core Web API

了解Docker基本应用

熟悉.NET 6新配置文件

三、实例内容

1.使用vs2022构建一个Web API项目，构建和运行效果图如下：

 

2.使用vs自带容器工具-->Docker支持-->Linux平台

 启用后查看启用后的Dockerfile，本例使用80端口，注释默认的443端口

#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80
#EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["WebApplicationDemo/WebApplicationDemo.csproj", "WebApplicationDemo/"]
RUN dotnet restore "WebApplicationDemo/WebApplicationDemo.csproj"
COPY . .
WORKDIR "/src/WebApplicationDemo"
RUN dotnet build "WebApplicationDemo.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "WebApplicationDemo.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "WebApplicationDemo.dll"]

3.修改Program.cs 配置文件

关键点一：修改Program.cs  保证打包发布后的端口与Dockerfile中的端口一致

关键点二：将app.UseHttpsRedirection();注释

关键点三：启用生产环境SwaggerUI。默认配置只是在开发环境启用SwaggerUI，生产环境不启用，在自己学习时候可加上以下代码方便测试

if (app.Environment.IsProduction())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

修改后完整的配置文件如下：

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.

builder.Services.AddControllers();
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

builder.WebHost.UseUrls(new[] { "http://*:80" });

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}
//生产环境启用SwaggerUI
if (app.Environment.IsProduction())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

//app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

4.使用VS容器工具生成映像

查看生成的镜像

5.运行容器

 docker container run -d --name demo -p 80:80 webapplicationdemo:latest

 

6.查看效果图

 

 

三、实例总结

1.实例实现的重点需要数量掌握.NET6全新配置文件的配置方法。

2.使用VS自带容器工具进行Docker映像的生成为多阶段构建，与传统打包发布构建直接的区别为打包后映像的大小，实例打包映像大小为200MB左右，不分阶段打包生成映像大小可能为700MB左右。详情读者可自行打包感受。

分阶段打包参考官方文档： Visual Studio 容器工具生成和调试概述 - Visual Studio (Windows) | Microsoft Docs