ASP.NET CORE在docker中的健康检查（healthcheck）

在使用docker-compose的过程中，很多程序都提供了健康检查（healthcheck）的方法，通过健康检查，应用程序能够在确保其依赖的程序都已经启动的前提下启动，减少各种错误的发生，同时，合理设计的健康检查也能够提供给外界关于应用程序状态的一些信息。

大多数docker镜像的详细说明中，会交代如何进行健康检查，.NET 6也提供了文档。也有其他人写了文章说了更细节的内容。

实践一下，现在docker-compose里面是这样：

1. version: '3.7'
2. services:
3.   postgres:
4.     container_name: postgres-container
5.     image: postgres:13
6.     volumes:
7.       - ./postgres_data:/var/lib/postgresql/data/pgdata
8.     ports:
9.       - "5432:5432"
10.     environment:
11.       POSTGRES_PASSWORD: "123456"
12.       PGDATA: "/var/lib/postgresql/data/pgdata"
13.     healthcheck:
14.       test: ["CMD-SHELL", "pg_isready -U postgres"]
15.       interval: 10s
16.       timeout: 5s
17.       retries: 5  
18.     networks:
19.       - dotnet-network
20.   
21.   dotnet-service:
22.     image: dotnet-service:latest
23.     container_name: dotnet-service-container
24.     ports:
25.       - 5000:5000
26.     build:
27.       context: ./TestWeb/
28.       dockerfile: ./TestWeb/Dockerfile
29.     environment:
30.       # - ASPNETCORE_ENVIRONMENT=Docker
31.       - ASPNETCORE_URLS=http://*:5000
32.       - App__SelfUrl=http://*:5000
33.     restart: on-failure
34.     depends_on:
35.       postgres:
36.         condition: service_healthy
37.     networks:
38.       - dotnet-network
40. networks:
41.   dotnet-network:
42.     external: false

复制代码

首先调整一下程序：

1. var builder = WebApplication.CreateBuilder(args);
3. builder.Services.AddHealthChecks();
5. var app = builder.Build();
7. app.MapHealthChecks("/healthz");
9. app.Run();

复制代码

如果直接运行的话，web访问/healthz节点，那么可以页面将直接返回Healthy。看上去没有问题，那我们按照要求调整一下Dockerfile

1. FROM base AS final
2. WORKDIR /app
3. COPY --from=publish /app/publish .
4. HEALTHCHECK CMD curl --fail http://localhost:5000/healthz || exit
5. ENTRYPOINT ["dotnet", "TestWeb.dll"]

复制代码

然后调整docker-compose.yml文件，让postgres启动依赖dotnet-service：

1. version: '3.7'
2. services:
3.   postgres:
4.     container_name: postgres-container
5.     image: postgres:13
6.     volumes:
7.       - ./postgres_data:/var/lib/postgresql/data/pgdata
8.     ports:
9.       - "5432:5432"
10.     environment:
11.       POSTGRES_PASSWORD: "123456"
12.       PGDATA: "/var/lib/postgresql/data/pgdata"
13.     healthcheck:
14.       test: ["CMD-SHELL", "pg_isready -U postgres"]
15.       interval: 10s
16.       timeout: 5s
17.       retries: 5  
18.     depends_on:
19.       dotnet-service:
20.         condition: service_healthy
21.     networks:
22.       - dotnet-network
23.   
24.   dotnet-service:
25.     image: dotnet-service:latest
26.     container_name: dotnet-service-container
27.     ports:
28.       - 5000:5000
29.     build:
30.       context: ./TestWeb/
31.       dockerfile: ./TestWeb/Dockerfile
32.     environment:
33.       # - ASPNETCORE_ENVIRONMENT=Docker
34.       - ASPNETCORE_URLS=http://*:5000
35.       - App__SelfUrl=http://*:5000
36.     restart: on-failure
37.     networks:
38.       - dotnet-network
40. networks:
41.   dotnet-network:
42.     external: false

复制代码

然后postgres就启动不了了，提示容器unhealthy。运行docker ps，发现.net容器的后面有一个unhealthy。但是程序访问正常，说明只是没有正确运行这段话而已。
Dockerfile方案

文档说.NET 6的镜像里面不带curl这个工具了，需要手动装一下：

1. FROM base AS final
2. WORKDIR /app
3. COPY --from=publish /app/publish .
4. RUN apt-get update && apt-get install -y curl
5. HEALTHCHECK CMD curl --fail http://localhost:5000/healthz || exit
6. ENTRYPOINT ["dotnet", "TestWeb.dll"]

复制代码

这样再看，就完全没问题了，如果把aspnet:6.0改成aspnet:6.0-alpine，空间更节省了（默认是239M，alpine版是108M），还自带了wget，也没必要这么麻烦先安装curl（比较费时间按）。

1. HEALTHCHECK CMD wget --spider http://localhost:5000/healthz || exit

复制代码

docker-compose方案

我不太喜欢去改Dockerfile，而是更倾向于修改docker-compose.yml文件。当然，没有curl依然还是得在Dockerfile中添加相应语句安装，但是可以删除HEALTHCHECK这一条了，直接在docker-compose.yml中对应服务下面添加：

1. healthcheck:
2.     test: ["CMD-SHELL", "wget --spider http://localhost:5000/healthz || exit"]
3.     interval: 10s
4.     timeout: 5s
5.     retries: 5  

复制代码

程序依然可以正常运行。

P.S. 如果程序没有使用AddHealthChecks，那么也可以使用暴力一点的，直接用HEALTHCHECK CMD curl --fail http://localhost:5000 || exit，只要能够正常访问页面，就认为是Healthy，不过肯定就少了很多高级特性了。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！