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

相关文章

Java图片压缩三种高效压缩方案详细解析

《Java图片压缩三种高效压缩方案详细解析》图片压缩通常涉及减少图片的尺寸缩放、调整图片的质量(针对JPEG、PNG等)、使用特定的算法来减少图片的数据量等,:本文主要介绍Java图片压缩三种高效... 目录一、基于OpenCV的智能尺寸压缩技术亮点:适用场景:二、JPEG质量参数压缩关键技术:压缩效果对比

Docker镜像修改hosts及dockerfile修改hosts文件的实现方式

《Docker镜像修改hosts及dockerfile修改hosts文件的实现方式》:本文主要介绍Docker镜像修改hosts及dockerfile修改hosts文件的实现方式,具有很好的参考价... 目录docker镜像修改hosts及dockerfile修改hosts文件准备 dockerfile 文

关于WebSocket协议状态码解析

《关于WebSocket协议状态码解析》:本文主要介绍关于WebSocket协议状态码的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录WebSocket协议状态码解析1. 引言2. WebSocket协议状态码概述3. WebSocket协议状态码详解3

CSS Padding 和 Margin 区别全解析

《CSSPadding和Margin区别全解析》CSS中的padding和margin是两个非常基础且重要的属性,它们用于控制元素周围的空白区域,本文将详细介绍padding和... 目录css Padding 和 Margin 全解析1. Padding: 内边距2. Margin: 外边距3. Padd

Oracle数据库常见字段类型大全以及超详细解析

《Oracle数据库常见字段类型大全以及超详细解析》在Oracle数据库中查询特定表的字段个数通常需要使用SQL语句来完成,:本文主要介绍Oracle数据库常见字段类型大全以及超详细解析,文中通过... 目录前言一、字符类型(Character)1、CHAR:定长字符数据类型2、VARCHAR2:变长字符数

使用Jackson进行JSON生成与解析的新手指南

《使用Jackson进行JSON生成与解析的新手指南》这篇文章主要为大家详细介绍了如何使用Jackson进行JSON生成与解析处理,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1. 核心依赖2. 基础用法2.1 对象转 jsON(序列化)2.2 JSON 转对象(反序列化)3.

Springboot @Autowired和@Resource的区别解析

《Springboot@Autowired和@Resource的区别解析》@Resource是JDK提供的注解,只是Spring在实现上提供了这个注解的功能支持,本文给大家介绍Springboot@... 目录【一】定义【1】@Autowired【2】@Resource【二】区别【1】包含的属性不同【2】@

SpringCloud动态配置注解@RefreshScope与@Component的深度解析

《SpringCloud动态配置注解@RefreshScope与@Component的深度解析》在现代微服务架构中,动态配置管理是一个关键需求,本文将为大家介绍SpringCloud中相关的注解@Re... 目录引言1. @RefreshScope 的作用与原理1.1 什么是 @RefreshScope1.

Java并发编程必备之Synchronized关键字深入解析

《Java并发编程必备之Synchronized关键字深入解析》本文我们深入探索了Java中的Synchronized关键字,包括其互斥性和可重入性的特性,文章详细介绍了Synchronized的三种... 目录一、前言二、Synchronized关键字2.1 Synchronized的特性1. 互斥2.

Java的IO模型、Netty原理解析

《Java的IO模型、Netty原理解析》Java的I/O是以流的方式进行数据输入输出的,Java的类库涉及很多领域的IO内容:标准的输入输出,文件的操作、网络上的数据传输流、字符串流、对象流等,这篇... 目录1.什么是IO2.同步与异步、阻塞与非阻塞3.三种IO模型BIO(blocking I/O)NI