Dockerfile HEALTHCHECK指令 语法解析

2023-11-11 23:18

本文主要是介绍Dockerfile HEALTHCHECK指令 语法解析,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

  Docker实际应用中,为了保证高可用性等,肯定会遇到需要实时或定时检测Docker容器以及容器内服务运行状态的需求,此时就会用到健康检查机制,dockerfile内部提供了HEALTHCHECK指令,用来完成对Docker容器的健康检测。

  HEALTHCHECK 语法

# 通过在容器内部运行命令来检查容器运行状况.
HEALTHCHECK [OPTIONS] CMD command
# 禁用从基映像继承的任何运行状况检查.
HEALTHCHECK NONE

  HEALTHCHECK 语义

  · HEALTHCHECK指令用于检测容器运行是否正常,这可以检测到一些情况,例如web服务器陷入无限循环,无法处理新的连接,即使服务器进程仍在运行。

  · 当容器指定了HEALTHCHECK时,除了正常状态外,它还有一个健康状态。此状态最初处于启动状态。只要健康检查通过,它就会变为正常(无论它以前处于什么状态)。在连续失败一定次数后,它将变得不健康。

  · 可以出现在CMD之前的选项有:

  1) --interval=DURATION (default: 30s)

  2) --timeout=DURATION (default: 30s)

  3) --start-period=DURATION (default: 0s)

  4) --retries=N (default: 3)

  · 运行状况检查将首先在容器启动后每隔秒运行一次,然后在前一次检查完成后每隔秒运行一次。

  · 如果单次运行检查所用时间超过超时秒数,则认为检查失败。

  · 它将重试容器的运行状况检查的连续失败,以将其视为不健康。

  · start period为需要引导时间的容器提供初始化时间。探测失败期间的最大重试次数不计算在内。但是,如果在启动期间健康检查成功,则认为容器已启动,并且所有连续失败都将计入最大重试次数。

  · dockerfile中只能有一条HEALTHCHECK指令。如果列出多个,则只有最后一个运行状况检查才会生效。

  · CMD关键字后面的命令可以是shell命令(例如:HEALTHCHECK CMD /bin/check running)或exec数组(与其他dockerfile命令一样)。

  · 命令的exit status指示容器的运行状况。可能的值为:

  1) 0:健康状态,容器健康且已准备完成。

  2) 1:不健康状态,容器工作不正常。

  3) 2:保留,不要使用此退出代码。

HEALTHCHECK --interval=5m --timeout=3s \CMD curl -f http://localhost/ || exit1

  · 为了帮助调试失败的探测,命令在stdoutstderr上写入的任何输出文本(UTF-8编码)都将被存储在health status中,并且可以使用docker inspect进行查询。这样的输出应该保持简短(当前只存储前4096个字节)。

  · 当容器的运行状况发生变化时,将生成具有新状态的health_status事件。

  · docker 1.12中增加了HEALTHCHECK特性。

  HEALTHCHECK 示例

  1) 进入/securitit/dockerfile/目录(根据个人选择,这是本文使用的目录),创建dockerfile文件。

FROM nginx
MAINTAINER Securitit
HEALTHCHECK --interval=5s --timeout=3s \CMD curl -f http://localhost/ || exit 1
CMD ["usr/sbin/nginx", "-g", "daemon off;"]

  配置文件中通过HEALTHCHECK指令指定健康检查的相关配置,结尾的CMD指令指定容器启动时,同时启动Nginx服务器。

  2) 执行如下的构建命令,基于dockerfile构建镜像。

docker build -f /securitit/dockerfile/dockerfile -t securitit-nginx-healthcheck:1.0.0.1 .

在这里插入图片描述

  3) 查看镜像信息。

docker images

在这里插入图片描述

  4) 指定通过dockerfile生成的镜像启动容器。

docker run --name securitit-nginx-healthcheck -it -d -p 10080:80 securitit-nginx-healthcheck:1.0.0.1

在这里插入图片描述

  5) 查看容器信息。

docker ps -a

在这里插入图片描述

  通过docker ps -a命令,可以看到运行中容器的状态是在变化中的。

  6) 通过docker inspect查看容器健康检查信息。

docker inspect -f {{".State.Health"}} b6e07518c14d

在这里插入图片描述

  可以看到,目前容器状态为0,处于健康状态。

  除了查看状态之外,还可以查看更加详细的健康检查日志。

docker inspect b6e07518c14d

在这里插入图片描述

  总结

  在提倡服务高可用的今天,健康检查是不可缺少的,HEALTHCHECK只是简单的基础指令,要达到更加智能、完善的服务监控机制,需要三方工具来协助完成,会在系列博文中介绍。

  若文中存在错误和不足,欢迎指正!

这篇关于Dockerfile HEALTHCHECK指令 语法解析的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/393473

相关文章

PostgreSQL的扩展dict_int应用案例解析

《PostgreSQL的扩展dict_int应用案例解析》dict_int扩展为PostgreSQL提供了专业的整数文本处理能力,特别适合需要精确处理数字内容的搜索场景,本文给大家介绍PostgreS... 目录PostgreSQL的扩展dict_int一、扩展概述二、核心功能三、安装与启用四、字典配置方法

深度解析Java DTO(最新推荐)

《深度解析JavaDTO(最新推荐)》DTO(DataTransferObject)是一种用于在不同层(如Controller层、Service层)之间传输数据的对象设计模式,其核心目的是封装数据,... 目录一、什么是DTO?DTO的核心特点:二、为什么需要DTO?(对比Entity)三、实际应用场景解析

深度解析Java项目中包和包之间的联系

《深度解析Java项目中包和包之间的联系》文章浏览阅读850次,点赞13次,收藏8次。本文详细介绍了Java分层架构中的几个关键包:DTO、Controller、Service和Mapper。_jav... 目录前言一、各大包1.DTO1.1、DTO的核心用途1.2. DTO与实体类(Entity)的区别1

Java中的雪花算法Snowflake解析与实践技巧

《Java中的雪花算法Snowflake解析与实践技巧》本文解析了雪花算法的原理、Java实现及生产实践,涵盖ID结构、位运算技巧、时钟回拨处理、WorkerId分配等关键点,并探讨了百度UidGen... 目录一、雪花算法核心原理1.1 算法起源1.2 ID结构详解1.3 核心特性二、Java实现解析2.

使用Python绘制3D堆叠条形图全解析

《使用Python绘制3D堆叠条形图全解析》在数据可视化的工具箱里,3D图表总能带来眼前一亮的效果,本文就来和大家聊聊如何使用Python实现绘制3D堆叠条形图,感兴趣的小伙伴可以了解下... 目录为什么选择 3D 堆叠条形图代码实现:从数据到 3D 世界的搭建核心代码逐行解析细节优化应用场景:3D 堆叠图

深度解析Python装饰器常见用法与进阶技巧

《深度解析Python装饰器常见用法与进阶技巧》Python装饰器(Decorator)是提升代码可读性与复用性的强大工具,本文将深入解析Python装饰器的原理,常见用法,进阶技巧与最佳实践,希望可... 目录装饰器的基本原理函数装饰器的常见用法带参数的装饰器类装饰器与方法装饰器装饰器的嵌套与组合进阶技巧

解析C++11 static_assert及与Boost库的关联从入门到精通

《解析C++11static_assert及与Boost库的关联从入门到精通》static_assert是C++中强大的编译时验证工具,它能够在编译阶段拦截不符合预期的类型或值,增强代码的健壮性,通... 目录一、背景知识:传统断言方法的局限性1.1 assert宏1.2 #error指令1.3 第三方解决

全面解析MySQL索引长度限制问题与解决方案

《全面解析MySQL索引长度限制问题与解决方案》MySQL对索引长度设限是为了保持高效的数据检索性能,这个限制不是MySQL的缺陷,而是数据库设计中的权衡结果,下面我们就来看看如何解决这一问题吧... 目录引言:为什么会有索引键长度问题?一、问题根源深度解析mysql索引长度限制原理实际场景示例二、五大解决

深度解析Spring Boot拦截器Interceptor与过滤器Filter的区别与实战指南

《深度解析SpringBoot拦截器Interceptor与过滤器Filter的区别与实战指南》本文深度解析SpringBoot中拦截器与过滤器的区别,涵盖执行顺序、依赖关系、异常处理等核心差异,并... 目录Spring Boot拦截器(Interceptor)与过滤器(Filter)深度解析:区别、实现

深度解析Spring AOP @Aspect 原理、实战与最佳实践教程

《深度解析SpringAOP@Aspect原理、实战与最佳实践教程》文章系统讲解了SpringAOP核心概念、实现方式及原理,涵盖横切关注点分离、代理机制(JDK/CGLIB)、切入点类型、性能... 目录1. @ASPect 核心概念1.1 AOP 编程范式1.2 @Aspect 关键特性2. 完整代码实