一、实例环境与工具
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