Hadolint：Lint Dockerfile 的完整指南

想学习如何使用 Hadolint 对 Dockerfile 进行 lint 处理吗？这篇博文将向您展示如何操作。这是关于 Dockerfile linting 的完整指南。

通过对 Dockerfile 进行 lint 检查，您可以及早发现错误和问题，并确保它们遵循最佳实践。

什么是Hadolint？

Hadolint 是一个使用 Haskell 构建的开源命令行 Dockerfile linter 工具，可帮助您编写无错误的 Dockersfile。Hadolint 会检查您的 Dockerfile 是否存在可能的错误、安全漏洞和性能问题。它在 GitHub 上有超过 9k 的启动

这是它的工作原理。

  1. Hadolint 读取 Dockerfile
  2. 它将 Dockerfile 解析为 AST（抽象语法树），以标识与其关联的每个指令和参数。
  3. 然后，它根据预定义的规则集检查每条指令，这些规则涵盖安全性、效率和代码质量。这些规则是 Hadolint 源代码的一部分。您可以在此处查看规则列表。
  4. Hadolint 会标记所有违反规则的行为，并会针对所有检测到的问题创建反馈。

问题的严重性分类如下：

  1. Info– 您将获得有关信息改进的建议。它被认为不太严重。
  2. Style – 与 Dockerfile 的格式或结构相关，例如使用缩进或使用长单行等。
  3. Warning – 不太严重的问题和需要改进的次要安全问题。
  4. Error– 这些问题很严重，可能与安全漏洞或重大最佳实践违规有关。

现在我们已经对 Hadolint 有了基本的了解，让我们继续安装并查看它的实际效果。

安装 Hadolint

您可以在 Linux、Mac 和 Windows 系统上安装 Hadolint。

在 Linux 中安装

如果要在Linux系统中安装Hadolint，请按照以下步骤操作。

步骤1：从 Hadolint Github 发布页面下载最新的 Linux Hadolint 包。

wget -O hadolint https://github.com/hadolint/hadolint/releases/download/v2.12.0/hadolint-Linux-x86_64

步骤2： 下载应用程序后，将其移动到 /usr/local/bin 目录。

sudo mv hadolint /usr/local/bin/hadolint

第 3 步：使用下面给出的命令向 Hadolint 授予执行权限。

sudo chmod +x /usr/local/bin/hadolint

在 Mac 中安装

您可以使用下面给出的命令在 Mac 系统上安装 Hadolint。

brew install hadolint

要检查 Linux 或 Mac 系统上是否安装了 Hadolint，请运行以下命令：

hadolint --version

在 Windows 中安装

使用 scoop 在 Windows 上安装 Hadolint

scoop install hadolint

安装 hadolint 后，您将拥有 hadolint CLI 来对 Dockerfile 运行 lint 测试。

要了解所有 CLI 选项，可以使用 –help 标志。

hadolint --help

使用 Hadolint 的 lint Dockerfile

要使用 Hadolint，只需将其安装在您的系统上并使用 Dockerfile 运行该命令。Hadolint 将提供它在 Dockerfile 中发现的错误列表作为输出，以及严重性级别和该问题的原因。

为了获得实际的理解，我们将使用未优化的 Dockerfile。

将以下内容另存为 Dockerfile。

FROM ubuntu:latest
RUN apt-get update
RUN apt-get install -y curl
RUN apt-get update && apt-get install -y curl
RUN echo "hello world" | grep "world" | wc -l
CMD ["echo", "Hello, world!"]

让我们针对上面的 Dockerfile 运行 Hadolint。确保 Dockerfile 位于运行 hadolint 命令的同一目录中。

hadolint Dockerfile

您将收到以下输出，其中包含“警告”和“信息”消息，其中包含规则编号和修正信息，如下图所示。

如果您检查编号 7，Hadolint 也会提供有关 shell 脚本的信息。Hadolint 在后台使用 Shellcheck 对属于 RUN 指令一部分的 shell 脚本进行 lint 处理。

现在，如果您检查退出代码，您将获得一个非零返回。

hadolint-examples git:(main) ✗ echo $?                      
1
➜  hadolint-examples git:(main) ✗

如果实现所有建议，将获得以下 Dockerfile。

# Use Ubuntu 20.04 as the base image
FROM ubuntu:20.04# Set the default shell with -o pipefail
SHELL ["/bin/bash", "-o", "pipefail", "-c"]# Run commands
RUN apt-get update && \apt-get install -y curl=8.4.0 --no-install-recommends && \apt-get clean && \rm -rf /var/lib/apt/lists/* && \echo "hello world" | grep -c "world"# Default command to run
CMD ["echo", "Hello, world!"]

现在，如果对修正和更新的 Dockerfile 运行 Hadolint，则不会收到任何警告或信息消息。如果您检查返回值，您将获得如下图所示。0

忽略规则

在某些情况下，你可能不希望修正所有建议。在这种情况下，您可以使用 --ignore 标志忽略特定规则。

例如，如果我想忽略建议指定软件包版本的 DL3008，可以使用以下命令。

hadolint --ignore DL3008 Dockerfile

在使用 CI/CD 系统时，我们需要标准化衬里的所有配置和规则。这是配置文件hadolint.yaml的用武之地。

hadolint.yaml

handolint.yaml 是 Hadolint 的配置文件。您可以使用配置文件自定义 Hadolint 处理输出和建议的方式。

当您希望对跨组织或项目进行 linting Dockerfile 的标准化和自定义时，这特别有用。此模板可以与开发 Dockerfile 的开发人员或 DevOps 工程师共享。

您可以参考官方文档了解所有支持的参数。

让我们来看看关键参数。

  1. failure-threshold：指定 lint 应失败的级别或提供非零fanhuizhi。例如，默认情况下，Hadolinit 为所有级别提供非零退出代码。使用此参数，您可以为错误和警告配置非零退出代码。对于非零退出代码，将忽略 Info 和 style。
  2. ignored：如果要忽略特定规则，可以在 ignore 参数下列出它们。
  3. override：如果要覆盖特定规则的严重性，则此参数特别有用。例如，DL3015 规则位于 info 下。但是，您希望将其归类为警告。因此，您可以将 DL3015 添加到覆盖下的警告类别下。对于使用此配置的所有 Hadolint 运行，DL3015 将列为警告。
  4. trustedRegistries：在大多数组织中，只允许使用内部容器注册表。如果只想允许来自特定容器注册表的映像，可以在这些参数下添加这些注册表终结点。如果 Dockerfile 包含来自其他注册表的映像，则 lint 将失败。

下面是包含所有关键参数的示例配置。将以下配置另存为 .hadolint.yaml

failure-threshold: warning
format: tty
ignored:
- DL3007
override:error:- DL3015warning:- DL3015info:- DL3008style:- DL3015
trustedRegistries:
- docker.io
- techiescamp.com:5000
- "*.gcr.io"
- quay.io

您可以将配置文件与 Hadolint 一起使用，如下所示

hadolint --config .hadolint.yaml Dockerfile

​

在 Docker 镜像构建中使用 Hadolint

作为标准做法，开发人员可以在创建 Dockerfile 时运行 Hadolint，然后再将其推送到存储库。但是，Hadolint 的主要用途在于 Docker 映像构建管道。

可以使用 Hadolint 添加 Dockerfile 链接，作为 Docker 生成 CI 管道的一部分。当为创建/更新 Dockerfile 引发 PR 时，管道中的第一步将是 linting。

如果 Dockerfile 不遵守 Hadolint 规则，则生成将失败，开发人员可以使用 Hadolint 反馈来纠正 Dockerfile 的问题。

您可以根据组织的标准和项目要求使用该文件自定义规则和配置。hadolint.yaml

这样，您可以捕获 Dockerfile 中的所有错误，并确保它在提交到主分支之前遵循标准最佳实践。

使用 Docker 运行 Hadolint

有一种方法可以在不在您的系统中安装 Hadolint 的情况下使用它，我们可以将 Docker 镜像用于 Hadolint。下面给出了使用 Hadolint Docker 映像的命令。

docker run --rm -i hadolint/hadolint < Dockerfile

​

使用此命令的最佳部分是，如果系统中没有Hadolint Docker映像，它将首先下载Docker映像，然后扫描Dockerfile。

Hadolint 在线版

有一个 Hadolint 的在线版本，您可以在其中从浏览器中对 Dockerfile 进行 lint 检查。这对于快速测试很有用。

您可以在此处访问在线版本。

使用 Hadolint 的好处

根据这篇关于 Dockerfile 的 IEEE 研究论文，其数据集中近 84% 的 GitHub 项目在其 Dockerfile 代码中都有气味，尤其是 DL 气味。

使用 Hadolint 有很多好处，下面列出了一些好处：

  1. 改进了 Dockerfile 质量：Hadolint 识别 Dockerfile 中的错误，从而改进和优化 Dockerfile
  2. 降低安全风险：Hadolint 可以识别 Dockerfile 中的安全漏洞，例如使用旧的基础映像，并帮助减少攻击面。
  3. 提高性能：Hadolint 可以在 Dockerfile 中发现降低 Docker 映像性能的问题，例如构建不必要的大型映像。
  4. 提高一致性：Hadolint 确保您的 Dockerfile 与最佳实践一致，从而使它们符合您组织的策略。

使用Hadolint的提示

以下是使用 Hadolint 的一些提示：

  1. 首先修复最严重的错误：Hadolint 将为其发现的每个错误分配一个严重性级别。首先，修复最严重的错误，因为这些错误最有可能导致问题。
  2. 启用所有规则：Hadolint 附带了一组默认启用的默认规则。但是，还可以启用许多可选规则。考虑启用所有规则以使 Hadolint 高效工作。您可以根据排除要求再次自定义这些规则。
  3. 根据需要配置 Hadolint：您还可以修改启用的规则和不同冲突的严重性级别，还可以指定输出格式。

结论

在开发过程中，Linting Dockerfile 是一种很好的做法，就像在 Infra 管道中一样。我强烈建议您将 Hadolint 添加为 Docker 映像构建管道的一部分，以获得安全和优化的容器映像。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.hqwc.cn/news/329267.html

如若内容造成侵权/违法违规/事实不符，请联系编程知识网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

深入理解C指针

深入理解C指针

深入理解C指针 ​#C语言 #​ #C指针 #​ 1 认识指针 指针&#xff1a;一个存放内存地址的变量 1.1 指针和内存 ​​ ‍ 阅读指针声明时候&#xff0c;可以选择倒过来读&#xff0c;会更容易理解。 指针被赋值为NULL时候&#xff0c;会被解释为二进制0. void指针 具有和…
阅读更多...
Java Swing手搓坦克大战遇到的问题和思考

Java Swing手搓坦克大战遇到的问题和思考

1.游戏中的坐标系颇为复杂 像素坐标系还有行列坐标&#xff0c;都要使用&#xff0c;这之间的互相转化使用也要注意 2.游戏中坦克拐弯的处理&#xff0c;非常重要 由于坦克中心点是要严格对齐到一条网格线&#xff0c;并沿着这条线前进的&#xff0c;如果拐弯不做处理&#…
阅读更多...
二刷Laravel 教程（构建页面）总结Ⅰ

二刷Laravel 教程（构建页面）总结Ⅰ

L01 Laravel 教程 - Web 开发实战入门 ( Laravel 9.x ) 一、功能 1.会话控制&#xff08;登录、退出、记住我&#xff09; 2.用户功能&#xff08;注册、用户激活、密码重设、邮件发送、个人中心、用户列表、用户删除&#xff09; 3.静态页面&#xff08;首页、关于、帮助&am…
阅读更多...
【二】使用create-vue创建vue3的helloworld项目(推荐)

【二】使用create-vue创建vue3的helloworld项目(推荐)

create-vue 官网&#xff1a;快速上手 | Vue.js create-vue 是 Vue3 的专用脚手架&#xff0c;使用 vite 创建 Vue3 的项目&#xff0c;也可以选择安装需要的各种插件&#xff0c;使用更简单。 1、使用方式 npm create vuelatest这个命令会安装和执行 create-vue&#xff0…
阅读更多...
【Project】TPC-Online Module (manuscript_2024-01-07)

【Project】TPC-Online Module (manuscript_2024-01-07)

PRD正文 一、概述 本模块实现隧道点云数据的线上汇总和可视化。用户可以通过注册和登录功能进行身份验证&#xff0c;然后上传原始隧道点云数据和经过处理的数据到后台服务器。该模块提供数据查询、筛选和可视化等操作&#xff0c;同时支持对指定里程的分段显示和点云颜色更改…
阅读更多...
2022年多元统计分析期末试题

2022年多元统计分析期末试题

2023年多元统计分析期末试题 1.试论述系统聚类、动态聚类和有序聚类的异同之处。 2、设 X {X} X~ N 3 {N_3} N3​(μ&#xff0c;Σ)&#xff0c;其中 X {X} X ~ ( X 1 {X_1} X1​, X 2 {X_2} X2​, X 3 {X_3} X3​)&#xff0c;μ (1,-2,3)‘&#xff0c;Σ [ 1 1 1 1 3 2…
阅读更多...
【Python机器学习】线性模型——用于多分类的线性模型

【Python机器学习】线性模型——用于多分类的线性模型

很多线性分类模型只使用与二分类问题&#xff0c;将二分类算法推广到多分类算法的一种常见方法是“一对其余”方法。在“一对其余”方法中&#xff0c;对每个类别都学习一个二分类模型&#xff0c;将这个类别和其他类别尽量区分&#xff0c;这样就生成了与类别数相同的二分类模…
阅读更多...
qt三大控件

qt三大控件

1.QListWidget控件 先在ui界面将 QListWidget拖出来竖直对齐 再去代码中实现文本插入 两种插入方式 方法1 //listWidget使用 有左右中间对齐需求QListWidgetItem * itemnew QListWidgetItem("床前明月光"); // //上面只是独立的一句话,没有关联起来ui-&g…
阅读更多...
JavaWeb实验报告

JavaWeb实验报告

JavaWeb实验报告 JavaWeb实验报告 2024 年 1 月 7 日 课程名称&#xff1a; JavaWeb 实验名称&#xff1a; 期末作业 班级&#xff1a; 姓名 同组人&#xff1a; 指导教师评定&#xff…
阅读更多...
Qt qDebug基本的使用方法详解

Qt qDebug基本的使用方法详解

目录 qDebug基本用法输出字符串输出变量值1输出变量值2支持流式输出输出十六进制去除双引号和空格调试输出级别 自定义类型输出自定义日志信息的输出格式示例占位符设置环境变量 关闭QDebug输出Qt工程VS工程 在VS工程中如何查看qDebug输出 DebugView下载 qDebug基本用法 qDebug…
阅读更多...
PyTorch|构建自己的卷积神经网络——nn.Sequential()

PyTorch|构建自己的卷积神经网络——nn.Sequential()

之前在构建神经网络时&#xff0c;我们一般是采用这种方式&#xff0c;就像这样&#xff1a; class Network1(nn.Module): def __init__(self): super(Network1,self).__init__() self.conv1 nn.Conv2d(in_channels3, out_channels6, kernel_size5) …
阅读更多...
[算法应用]dijkstra算法的应用

[算法应用]dijkstra算法的应用

先看一眼原始dijkstra算法&#xff0c;参考自dijkstra算法C实现_c实现djikstra-CSDN博客 分为三步 找到当前最优的把当前最优的&#xff0c;不参与后面的更新逐个比较是否更新 dijkstra算法的应用 题目大概是要从图上找一条权值不减的路径&#xff0c;且要经过最多的点。 所以…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023