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

相关文章

C语言中自动与强制转换全解析

《C语言中自动与强制转换全解析》在编写C程序时,类型转换是确保数据正确性和一致性的关键环节,无论是隐式转换还是显式转换,都各有特点和应用场景,本文将详细探讨C语言中的类型转换机制,帮助您更好地理解并在... 目录类型转换的重要性自动类型转换(隐式转换)强制类型转换(显式转换)常见错误与注意事项总结与建议类型

MySQL 缓存机制与架构解析(最新推荐)

《MySQL缓存机制与架构解析(最新推荐)》本文详细介绍了MySQL的缓存机制和整体架构,包括一级缓存(InnoDBBufferPool)和二级缓存(QueryCache),文章还探讨了SQL... 目录一、mysql缓存机制概述二、MySQL整体架构三、SQL查询执行全流程四、MySQL 8.0为何移除查

在Rust中要用Struct和Enum组织数据的原因解析

《在Rust中要用Struct和Enum组织数据的原因解析》在Rust中,Struct和Enum是组织数据的核心工具,Struct用于将相关字段封装为单一实体,便于管理和扩展,Enum用于明确定义所有... 目录为什么在Rust中要用Struct和Enum组织数据?一、使用struct组织数据:将相关字段绑

使用Java实现一个解析CURL脚本小工具

《使用Java实现一个解析CURL脚本小工具》文章介绍了如何使用Java实现一个解析CURL脚本的工具,该工具可以将CURL脚本中的Header解析为KVMap结构,获取URL路径、请求类型,解析UR... 目录使用示例实现原理具体实现CurlParserUtilCurlEntityICurlHandler

深入解析Spring TransactionTemplate 高级用法(示例代码)

《深入解析SpringTransactionTemplate高级用法(示例代码)》TransactionTemplate是Spring框架中一个强大的工具,它允许开发者以编程方式控制事务,通过... 目录1. TransactionTemplate 的核心概念2. 核心接口和类3. TransactionT

数据库使用之union、union all、各种join的用法区别解析

《数据库使用之union、unionall、各种join的用法区别解析》:本文主要介绍SQL中的Union和UnionAll的区别,包括去重与否以及使用时的注意事项,还详细解释了Join关键字,... 目录一、Union 和Union All1、区别:2、注意点:3、具体举例二、Join关键字的区别&php

Spring IOC控制反转的实现解析

《SpringIOC控制反转的实现解析》:本文主要介绍SpringIOC控制反转的实现,IOC是Spring的核心思想之一,它通过将对象的创建、依赖注入和生命周期管理交给容器来实现解耦,使开发者... 目录1. IOC的基本概念1.1 什么是IOC1.2 IOC与DI的关系2. IOC的设计目标3. IOC

java中的HashSet与 == 和 equals的区别示例解析

《java中的HashSet与==和equals的区别示例解析》HashSet是Java中基于哈希表实现的集合类,特点包括:元素唯一、无序和可包含null,本文给大家介绍java中的HashSe... 目录什么是HashSetHashSet 的主要特点是HashSet 的常用方法hasSet存储为啥是无序的

Linux中shell解析脚本的通配符、元字符、转义符说明

《Linux中shell解析脚本的通配符、元字符、转义符说明》:本文主要介绍shell通配符、元字符、转义符以及shell解析脚本的过程,通配符用于路径扩展,元字符用于多命令分割,转义符用于将特殊... 目录一、linux shell通配符(wildcard)二、shell元字符(特殊字符 Meta)三、s

使用Python实现批量访问URL并解析XML响应功能

《使用Python实现批量访问URL并解析XML响应功能》在现代Web开发和数据抓取中,批量访问URL并解析响应内容是一个常见的需求,本文将详细介绍如何使用Python实现批量访问URL并解析XML响... 目录引言1. 背景与需求2. 工具方法实现2.1 单URL访问与解析代码实现代码说明2.2 示例调用