Asp-Net-Core开发笔记:使用alpine镜像并加入健康检查

前言

使用 docker 部署 AspNetCore 应用已经是标配了,之前我一直使用 mcr.microsoft.com/dotnet/aspnet:8.0 这类镜像,简单粗暴,不过可以使用 alpine 进一步优化镜像大小。

很多开源工具的 docker 都有健康检查,这次我顺便也给加上了。

PS: 本文的例子项目来自一个差点被砍掉的项目「IdentityServerLite」,后面我会写个文章介绍一下~

添加健康检查

注册服务

c# 复制代码
builder.Services.AddHealthChecks();

配置中间件

c# 复制代码
app.MapHealthChecks("/healthz");

之后测试一下,本地运行后访问 http://host:port/healthz 可以看到 Healthy 字样

修改 docker-compose

在应用配置下面增加 healthcheck 配置

这个镜像 mcr.microsoft.com/dotnet/aspnet 里自带了 wget ,所以直接用这个来请求健康检查接口就完事了,如果用 curl 还得去安装。

yaml 复制代码
version: '3.6'

services:
  web:
    image: ${DOCKER_REGISTRY-}web
    container_name: ids-lite
    restart: always
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - ASPNETCORE_URLS=http://+:80
    build:
      context: .
    volumes:
      - .:/app
    networks:
      - swag
    healthcheck:
      test: ["CMD-SHELL", "wget --spider http://localhost:80/healthz || exit"]
      interval: 10s
      timeout: 5s
      retries: 5

networks:
  swag:
    name: swag
    external: true

换成 alpine 基础镜像

还没有配置CICD之前,我使用了 FrameworkDependent 的方式来搭配 docker 部署,详见之前的文章: Asp-Net-Core开发笔记:FrameworkDependent搭配docker部署

换成 alpine 可以减少一半镜像体积,从 240MB 减少到 100MB 左右。

修改 dockerfile

8.0 后面加 -alpine 就行了

dockerfile 复制代码
FROM mcr.microsoft.com/dotnet/aspnet:8.0-alpine AS base
RUN apk add --no-cache icu-libs
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM base AS final
WORKDIR /app
COPY . .
ENTRYPOINT ["./IdsLite.Api"]

ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

重新发布

之前在本机发布的时候,运行时选的是 linux-x64

这样发布出来的可执行文件是依赖 glibc 的

但是 alpine 基础镜像里是 musl libc

所以需要选择 linux-musl-x64 这个运行时,然后重新发布

bash 复制代码
dotnet publish -r linux-musl-x64

搞定~

参考资料

相关推荐
lightningyang3 小时前
DVWA 在 openEuler 系统的安装部署
docker·渗透测试·openeuler·dvwa·天枢一体化虚拟仿真靶场平台
Ha_To6 小时前
2026.1.28 docker安装
运维·docker·容器
北极熊~~7 小时前
emqx持久化 Docker 容器中生成的数据并打包新镜像,迁移至新机器运行
运维·docker·容器
tomiatomia7 小时前
MinIO docker 部署使用的几个坑
运维·docker·容器
初九之潜龙勿用8 小时前
C# 操作Word模拟解析HTML标记之背景色
开发语言·c#·word·.net·office
时光追逐者9 小时前
使用 MWGA 帮助 7 万行 Winforms 程序快速迁移到 WEB 前端
前端·c#·.net
杨浦老苏9 小时前
Docker方式安装你的私人AI电脑助手Moltbot
人工智能·docker·ai·群晖
x70x8010 小时前
# Docker 搭建 MySQL 8 主从复制(踩坑实录 + 完整验证)
mysql·docker·容器
qq_3168377510 小时前
docker 运行 cn_clip
运维·docker·容器
老骥伏枥~10 小时前
【C# 入门】程序结构与 Main 方法
开发语言·c#