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

相关文章

Qt实现网络数据解析的方法总结

《Qt实现网络数据解析的方法总结》在Qt中解析网络数据通常涉及接收原始字节流,并将其转换为有意义的应用层数据,这篇文章为大家介绍了详细步骤和示例,感兴趣的小伙伴可以了解下... 目录1. 网络数据接收2. 缓冲区管理(处理粘包/拆包)3. 常见数据格式解析3.1 jsON解析3.2 XML解析3.3 自定义

Golang HashMap实现原理解析

《GolangHashMap实现原理解析》HashMap是一种基于哈希表实现的键值对存储结构,它通过哈希函数将键映射到数组的索引位置,支持高效的插入、查找和删除操作,:本文主要介绍GolangH... 目录HashMap是一种基于哈希表实现的键值对存储结构,它通过哈希函数将键映射到数组的索引位置,支持

Python正则表达式语法及re模块中的常用函数详解

《Python正则表达式语法及re模块中的常用函数详解》这篇文章主要给大家介绍了关于Python正则表达式语法及re模块中常用函数的相关资料,正则表达式是一种强大的字符串处理工具,可以用于匹配、切分、... 目录概念、作用和步骤语法re模块中的常用函数总结 概念、作用和步骤概念: 本身也是一个字符串,其中

Python使用getopt处理命令行参数示例解析(最佳实践)

《Python使用getopt处理命令行参数示例解析(最佳实践)》getopt模块是Python标准库中一个简单但强大的命令行参数处理工具,它特别适合那些需要快速实现基本命令行参数解析的场景,或者需要... 目录为什么需要处理命令行参数?getopt模块基础实际应用示例与其他参数处理方式的比较常见问http

Python利用ElementTree实现快速解析XML文件

《Python利用ElementTree实现快速解析XML文件》ElementTree是Python标准库的一部分,而且是Python标准库中用于解析和操作XML数据的模块,下面小编就来和大家详细讲讲... 目录一、XML文件解析到底有多重要二、ElementTree快速入门1. 加载XML的两种方式2.

Java的栈与队列实现代码解析

《Java的栈与队列实现代码解析》栈是常见的线性数据结构,栈的特点是以先进后出的形式,后进先出,先进后出,分为栈底和栈顶,栈应用于内存的分配,表达式求值,存储临时的数据和方法的调用等,本文给大家介绍J... 目录栈的概念(Stack)栈的实现代码队列(Queue)模拟实现队列(双链表实现)循环队列(循环数组

Mysql用户授权(GRANT)语法及示例解读

《Mysql用户授权(GRANT)语法及示例解读》:本文主要介绍Mysql用户授权(GRANT)语法及示例,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录mysql用户授权(GRANT)语法授予用户权限语法GRANT语句中的<权限类型>的使用WITH GRANT

java解析jwt中的payload的用法

《java解析jwt中的payload的用法》:本文主要介绍java解析jwt中的payload的用法,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录Java解析jwt中的payload1. 使用 jjwt 库步骤 1:添加依赖步骤 2:解析 JWT2. 使用 N

Python中__init__方法使用的深度解析

《Python中__init__方法使用的深度解析》在Python的面向对象编程(OOP)体系中,__init__方法如同建造房屋时的奠基仪式——它定义了对象诞生时的初始状态,下面我们就来深入了解下_... 目录一、__init__的基因图谱二、初始化过程的魔法时刻继承链中的初始化顺序self参数的奥秘默认

HTML5表格语法格式详解

《HTML5表格语法格式详解》在HTML语法中,表格主要通过table、tr和td3个标签构成,本文通过实例代码讲解HTML5表格语法格式,感兴趣的朋友一起看看吧... 目录一、表格1.表格语法格式2.表格属性 3.例子二、不规则表格1.跨行2.跨列3.例子一、表格在html语法中,表格主要通过< tab