知识

解决 WebAPI 在容器中的启动初始化问题

字号+作者:益华科技来源:人工智能2025-11-05 06:06:11我要评论(0)

在产品或项目的部署中,如果和下面场景类似,那么本文可能对您有所帮助。场景WebAPI 和 MySql 数据部署在同一服务器通常是测试环境)。WebAPI 和 MySql 使用 docker-compo

在产品或项目的解决部署中,如果和下面场景类似,容器那么本文可能对您有所帮助。启动

场景

WebAPI 和  MySql  数据部署在同一服务器(通常是初始测试环境)。WebAPI 和  MySql  使用  docker-compose  进行部署。化问WebAPI  启动时有一些初始化的解决操作要做,而初始化需要从  MySql  中获取数据。容器

问题

第一次部署,启动执行  docker-compose up -d  后,初始WebAPI  不能正常启动。化问断电、解决或其他原因导致的容器服务器重启或  docker  重启,WebAPI  不能正常启动。启动

原因

docker  容器启动时,初始WebAPI  程序启动的化问速度比  MySql  快,导致程序去连接  MySql  时,MySql  服务器还没有启动完成,自然是连不上。

假象

在  docker-compose.yml 文件中可以添加 depends_on 来设置依赖,如下:

复制api: restart: always image: netapi ports: - "5000:5000" environment: - TZ=Asia/Shanghai depends_on: - mysql networks: s2_net: ipv4_address: 172.66.9.51.2.3.4.5.6.7.8.9.10.11.12.

在 api  的 depends_on 设置 mysql ,表示 api  依赖  mysql ,只有当  mysql  启动后,api  才会启动。

但很可惜,这里的  mysql  启动指的是站群服务器  mysql  的容器是否启动了,而不是  mysql  的服务是否启动。所以,这种配置只能控制容器的启动顺序,并不能解决问题。

解决

要解决这个问题,有两种方式:

在 WebAPI 项目中使用 Polly 库,它是一个 .NET 的弹性和瞬态故障处理库,可以实现重试、断路器、超时等策略来处理网络请求失败的情况。可以使用 Polly 来尝试连接 mysql 服务,并在失败时进行重试或等待。优化 depends_on 配置。

本文着重介绍的是第二种方式,进行 depends_on 配置的优化。

优化思路

mysql  服务添加 healthcheck 检查,用来判断  mysql 的服务是否正常启动。api  服务的服务器租用 depends_on 监听这个检查,只有当 mysql 服务正常启动后,api  才会启动。

完整  docker-compose.yml

复制version: "3" networks: s2_net: driver: bridge ipam: driver: default config: - subnet: 172.66.9.0/24 services: mysql: restart: always image: mysql/mysql-server:latest ports: - "3306:3306" environment: - TZ=Asia/Shanghai - MYSQL_ROOT_PASSWORD=123456 healthcheck: test: ["CMD", "mysqladmin" ,"ping", "-h", "localhost", "-u", "root", "--password=123456"] interval: 3s timeout: 5s retries: 3 start_period: 5s command: mysqld --character-set-server=utf8mb4 --collation-server=utf8mb4_general_ci --default-authentication-plugin=mysql_native_password networks: s2_net: ipv4_address: 172.66.9.2 api: restart: always image: netapi ports: - "5000:5000" environment: - TZ=Asia/Shanghai depends_on: mysql: condition: service_healthy networks: s2_net: ipv4_address: 172.66.9.51.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.29.30.31.32.33.34.35.36.37.38.39.40.41.42.43.

mysql  服务中添加 healthcheck 属性,子属性解释如下:

test:设置健康检查的命令。interval:定义健康检查的间隔时间,上面配置为间隔  3  秒。timeout:健康检查的超时时间。retries:定义了健康检查失败后的重试次数。start_period:默认值为 0 秒,表示容器启动后立即进行健康检查。如果将 start_period 设置为非零值,则 Docker 会在容器启动后先等待一段时间,然后再开始进行健康检查。

api  服务的配置为固定写法。

注意事项

如果您的  docker-compose  安装的是  1.27  以下的版本,需要升级到  1.27  或以上版本。

因为 docker-compose 3  不支持 depends_on  的条件设置, 但从 1.27.0 开始,2.x 和 3.x 与 COMPOSE_SPEC 架构合并,版本现在是兼容的。服务器托管

可以使用下面命令进行  docker-compose  版本的查看:

复制docker-compose -v1.

安装  docker-compose   可以使用下面命令:

复制curl -L https://github.com/docker/compose/releases/download/1.28.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose1.2.

升级到  1.28.0 后,执行  docker-compose  的命令时可能会出现错误,错误提示如下:

[29250] Error loading Python lib /tmp/_MEIYmY20a/libpython3.9.so.1.0: dlopen: /lib64/libc.so.6: version `GLIBC_2.28 not found (required by /tmp/_MEIYmY20a/libpython3.9.so.1.0)

按照提示  google 下,会有很多方式解决,或者直接参考这个链接:https://blog.csdn.net/wangying202/article/details/113178159。

总结

在  docker-compose  中进行设置是一种偷懒的做法,适用于测试环境,因为生产环境程序和数据库通常在不同的服务器。

最好的方式还是应该在  WebAPI  程序中进行处理。

1.本站遵循行业规范,任何转载的稿件都会明确标注作者和来源;2.本站的原创文章,请转载时务必注明文章作者和来源,不尊重原创的行为我们将追究责任;3.作者投稿可能会经我们编辑修改或补充。

相关文章
  • 如何制作U盘启动盘(简单易行的步骤帮您快速制作一枚U盘启动盘)

    如何制作U盘启动盘(简单易行的步骤帮您快速制作一枚U盘启动盘)

    2025-11-05 04:22

  • 揭秘迷人的MiniCooper手表(MiniCooper手表)

    揭秘迷人的MiniCooper手表(MiniCooper手表)

    2025-11-05 04:21

  • 诺基亚X7-00(性能强大,外观出众,X7-00再度成为时尚标杆)

    诺基亚X7-00(性能强大,外观出众,X7-00再度成为时尚标杆)

    2025-11-05 03:47

  • 华硕ME371(探索华硕ME371的功能与特点)

    华硕ME371(探索华硕ME371的功能与特点)

    2025-11-05 03:37

网友点评