从零到一：在Ubuntu Server上部署你的第一个.NET 8 Web API（含Dockerfile编写与容器化实战）-洪萨配资

从零到一：在Ubuntu Server上部署你的第一个.NET 8 Web API（含Dockerfile编写与容器化实战）

最近两年，.NET跨平台开发能力突飞猛进，特别是.NET 8的发布让Linux服务器部署变得前所未有的简单。作为一名长期在Linux环境部署.NET应用的全栈开发者，我想分享一个完整的实战流程——从裸机Ubuntu Server开始，到最终运行在Docker容器中的Web API服务。这个过程不仅涉及基础环境配置，更重要的是教会你如何将开发成果转化为可部署的生产级应用。

1. 环境准备：Ubuntu Server与.NET 8 SDK

在开始之前，确保你有一台运行Ubuntu Server 22.04 LTS的机器（物理机或云实例均可）。这个版本之所以被推荐，是因为它提供了最完整的.NET支持且生命周期长达5年。

1.1 安装基础依赖

首先更新系统包索引并安装必要的工具链：

sudo apt update && sudo apt upgrade -y sudo apt install -y curl wget git unzip

1.2 安装.NET 8 SDK

对于Ubuntu 22.04，微软提供了官方的APT源配置方式：

sudo apt install -y dotnet-sdk-8.0

安装完成后验证版本：

dotnet --version # 预期输出：8.0.x

注意：如果系统提示找不到包，可能需要先添加微软的GPG密钥和软件源：
wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb rm packages-microsoft-prod.deb

2. 创建你的第一个Web API项目

2.1 初始化项目结构

使用.NET CLI创建一个最小化的Web API项目：

dotnet new webapi -n WeatherAPI --no-https -o ~/WeatherAPI cd ~/WeatherAPI

这个命令创建了一个：

不启用HTTPS的Web API项目（简化开发环境配置）
名为WeatherAPI的天气服务示例
项目目录位于用户主文件夹下

2.2 关键代码解析

打开Program.cs，你会看到一个精简的现代.NET API模板：

var builder = WebApplication.CreateBuilder(args); builder.Services.AddControllers(); var app = builder.Build(); app.MapControllers(); app.Run();

相比传统Startup类，这种"最小API"模式更符合现代开发习惯。让我们添加一个简单的天气控制器：

touch Controllers/WeatherForecastController.cs

编辑该文件并加入：

using Microsoft.AspNetCore.Mvc; namespace WeatherAPI.Controllers; [ApiController] [Route("[controller]")] public class WeatherForecastController : ControllerBase { private static readonly string[] Summaries = new[] { "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching" }; [HttpGet(Name = "GetWeatherForecast")] public IEnumerable<WeatherForecast> Get() { return Enumerable.Range(1, 5).Select(index => new WeatherForecast { Date = DateOnly.FromDateTime(DateTime.Now.AddDays(index)), TemperatureC = Random.Shared.Next(-20, 55), Summary = Summaries[Random.Shared.Next(Summaries.Length)] }) .ToArray(); } }

2.3 本地运行测试

启动开发服务器：

dotnet run

用curl测试API端点：

curl http://localhost:5000/WeatherForecast | jq

你应该能看到返回的JSON格式天气数据。按Ctrl+C停止服务。

3. 容器化部署：Docker实战

3.1 安装Docker引擎

在Ubuntu上安装Docker CE：

sudo apt install -y docker.io sudo systemctl enable --now docker sudo usermod -aG docker $USER newgrp docker # 刷新用户组

3.2 编写生产级Dockerfile

在项目根目录创建Dockerfile：

# 构建阶段 FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build WORKDIR /src COPY . . RUN dotnet restore RUN dotnet publish -c Release -o /app # 运行时阶段 FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS runtime WORKDIR /app COPY --from=build /app . EXPOSE 80 ENTRYPOINT ["dotnet", "WeatherAPI.dll"]

这个多阶段构建的Dockerfile具有以下优化：

分离构建环境和运行时环境，减小最终镜像体积
使用官方微软镜像，确保兼容性
明确暴露80端口（HTTP标准端口）

3.3 构建并运行容器

执行构建命令：

docker build -t weatherapi .

运行容器实例：

docker run -d -p 8080:80 --name weather weatherapi

验证服务：

curl http://localhost:8080/WeatherForecast | jq

4. 生产环境优化建议

4.1 性能调优参数

在docker run命令中添加.NET运行时优化参数：

docker run -d -p 8080:80 \ -e DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1 \ -e ASPNETCORE_ENVIRONMENT=Production \ --name weather weatherapi

关键环境变量说明：

变量名	推荐值	作用
DOTNET_SYSTEM_GLOBALIZATION_INVARIANT	1	禁用全球化特性，提升性能
ASPNETCORE_ENVIRONMENT	Production	启用生产模式配置
COMPlus_ReadyToRun	1	启用AOT编译优化

4.2 日志与监控配置

修改Program.cs添加结构化日志：

builder.Logging.ClearProviders(); builder.Logging.AddJsonConsole(options => { options.IncludeScopes = true; options.TimestampFormat = "HH:mm:ss"; options.JsonWriterOptions = new() { Indented = true }; });

4.3 健康检查端点

添加健康检查路由：

app.MapGet("/health", () => Results.Ok(new { status = "healthy" }));

然后在Dockerfile中添加健康检查指令：

HEALTHCHECK --interval=30s --timeout=3s \ CMD curl -f http://localhost/health || exit 1

5. CI/CD集成示例

5.1 GitHub Actions自动化流程

创建.github/workflows/docker-build.yml：

name: Docker Build on: push: branches: [ "main" ] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Login to Docker Hub uses: docker/login-action@v2 with: username: ${{ secrets.DOCKER_HUB_USERNAME }} password: ${{ secrets.DOCKER_HUB_TOKEN }} - name: Build and push uses: docker/build-push-action@v4 with: push: true tags: yourusername/weatherapi:latest

5.2 多架构镜像构建

修改Dockerfile支持ARM64：

# syntax=docker/dockerfile:1.4 FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/sdk:8.0 AS build # ...其余内容保持不变...

构建命令更新为：

docker buildx build --platform linux/amd64,linux/arm64 -t yourusername/weatherapi:multiarch --push .

在实际部署中发现，这种多阶段构建配合ARM64支持的配置，能让同一套代码无缝运行在树莓派到云服务器的各种环境。特别是在Kubernetes集群中部署时，节点架构差异完全由Docker自动处理，大大简化了运维复杂度。

从零到一：在Ubuntu Server上部署你的第一个.NET 8 Web API（含Dockerfile编写与容器化实战）