【免费下载链接】dockerfile-roastdroast - a dockerfile linter that actually has opinions 项目地址https://gitcode.com/gh_mirrors/do/dockerfile-roast点击查看免费下载droastdockerfile-roast是一个有主见的 Dockerfile linter。如果你团队已经在用Hadolint迁移并不痛苦droast 提供了两条平滑路径——用--hadolint-compatible兼容模式直接顶替现有 Hadolint 调用零改动试运行或用droast init --from-hadolint把.hadolint.yaml配置导入为droast.toml。等价检查会沿用原DL####规则编号行为不同的检查保留DF####编号迁移全程可审查、可回退。为什么考虑从 Hadolint 迁移到 droast先说结论droast 不是换个提示语的同质替代而是在解析能力和工程体验上的升级85 条规则覆盖 base image、安全、包管理器、层卫生、指令质量等类别规则清单可用droast --list-rules随时查看Span 感知解析器能理解 heredoc、# escape/# syntax指令、shell 与 JSON 两种形式、RUN --mount等 BuildKit 语法、Windows 路径与 PowerShell语法错误统一报DF071仓库级扫描直接droast .递归发现全部 Dockerfile并读取 Compose YAML 与 Bake HCL/JSON 定位非标准路径安全自动修复droast --fix只改 4 类机械问题大小写一致性、EXPOSE协议名等可先--dry-run预览更快更小官方基准测试中扫描 321 个真实 Dockerfile49,563 行的中位耗时约 1 秒单二进制仅 7.5 MB迁移的两种路径怎么选维度路径一兼容模式路径二配置导入命令droast --hadolint-compatible Dockerfiledroast init --from-hadolint .hadolint.yaml是否改动现有配置不动直接读.hadolint.yaml生成新的droast.toml适用场景CI 灰度切换、先跑一周对比结果决定全面迁移提交团队级策略规则编号等价检查输出DL####转译为DF####回退成本删掉 flag 即回退删掉droast.toml即回退建议的顺序先走路径一在 CI 里灰度确认无差异后再走路径二落地配置。路径一用兼容模式直接替换 Hadolint 调用一行命令顶替现有 Hadolintdroast --hadolint-compatible Dockerfile这个模式的目标是让现有 Hadolint 工作流原地继续跑自动发现配置不传--config时按 Hadolint 的惯例依次查找.hadolint.yaml、.hadolint.yml、XDG 配置目录与~/.hadolint/等位置--config在此模式下指向的是 Hadolint YAML 而非droast.toml接收 Hadolint 常用 flag--ignore、--error/--warning/--info/--style严重度覆盖、--trusted-registry、--require-label、--strict-labels、-t/--failure-threshold、--no-fail、--no-color等读取HADOLINT_*环境变量HADOLINT_NOFAIL、HADOLINT_IGNORE、HADOLINT_FORMAT、HADOLINT_FAILURE_THRESHOLD、四个HADOLINT_OVERRIDE_*列表、HADOLINT_TRUSTED_REGISTRIES、HADOLINT_REQUIRE_LABELS等——CI 里靠环境变量传参的流水线不用改一行内联 pragma 原样生效# hadolint ignoreDL3003与# hadolint global ignoreDL3006都会被识别10 种输出格式tty、json、checkstyle、codeclimate、gitlab_codeclimate、gnu、codacy、sonarqube、sarif、junit直接接进 GitLab 代码质量报告、SonarQube 等下游工具# 例如产出 GitLab 代码质量报告 droast --hadolint-compatible --format gitlab_codeclimate \ --file-path-in-report Dockerfile Dockerfile gl-code-quality-report.json编号规则什么时候是 DL什么时候是 DF这是迁移中最容易踩坑的地方droast 的处理原则是不冒充与 Hadolint 规则行为等价的检查输出原始DL####编号——下游已有的 ignore 列表、告警过滤器继续生效droast 检查范围更宽或行为不同时保留DF####编号并在 stderr 打印诊断说明避免看起来静默变了策略配置中引用了无对应关系的规则或设置如某些 ShellCheck 类SC编号同样会在 stderr 明确报出但不中断检查查看完整规则映射矩阵不想翻文档一条命令打印当前版本带版本号的完整对照矩阵droast --hadolint-compatible --hadolint-compatibility-report输出形如DL3007: DF001 equivalent identity每条规则标注equivalent identity等价或behaviorally different行为不同末尾列出所有 unmatched 规则。路径二配置导入生成 droast.toml确认要全面迁移后把 Hadolint YAML 一次性转成 droast 原生配置# 读取当前目录的 .hadolint.yaml droast init --from-hadolint # 或显式指定路径 droast init --from-hadolint .config/hadolint.yml配置项映射对照表Hadolint YAML 设置droast.toml 设置说明ignoredskipDL规则自动翻译为对应DF编号overrideerror/warning/info[severity-overrides]直接平移override.style映射为infoHadolint 的 style 档在 droast 中并入 infotrustedRegistriesapproved-registries对应DF065注册表白名单label-schemastrict-labels[required-labels]strict-labels对应DF074no-failno-fail直接平移disable-ignore-pragmainline-suppressions取反注意语义相反failure-thresholdmin-severitystyle/ignore折算为infonone转为no-failformat: tty/json/sarifformat其余格式checkstyle 等不迁移两个值得注意的细节一条 DL 规则可能映射到多条 DF 规则。例如DL3025JSON 数组形式同时落到DF018ENTRYPOINT和DF025CMDDL3006/DL3007基础镜像标签都收敛到DF001没有静默策略无法对应的规则如SC2086这类 ShellCheck 编号和设置会逐条打印到 stderr 并被排除在生成的策略之外你需要人工审查后再决定导入逻辑源码在 src/hadolint.rs生成的配置开头会带上# Generated from a Hadolint configuration注释方便 code review 时识别来源。规则映射矩阵DL 与 DF 高频对照表以下为映射矩阵中最常见的一批条目完整列表以--hadolint-compatibility-report输出为准Hadolint 规则droast 规则常见含义DL1000DF071Dockerfile 语法/指令序列错误DL3000DF009WORKDIR使用绝对路径DL3002DF002不要以 root 运行DL3003DF008用WORKDIR代替内联cdDL3006/DL3007DF001避免latest等未固定标签DL3009DF004清理 apt/apk 缓存行为不同*DL3013DF051pip install固定版本DL3014DF015apt-get需要-yDL3015DF016使用--no-install-recommendsDL3018DF052apk add固定版本DL3019DF029apk add使用--no-cacheDL3025DF018DF025CMD/ENTRYPOINT使用 JSON 数组一对多DL3026DF065强制使用批准的注册表DL3030DF027yum需要-yDL3042DF030pip使用--no-cache-dirDL3043DF068禁止的ONBUILD触发器DL3059DF003合并RUN减少层数DL3061DF037Dockerfile 必须以FROM开头DL4000DF019弃用MAINTAINER改用LABELDL4004DF039多个ENTRYPOINT只有最后一个生效* 标注为behaviorally different的规则如DL3009、DL3016、DL3033、DL3037、DL3041droast 侧检查范围更宽输出时保留DF编号配置中引用它们会在 stderr 收到提示。映射数据与运行逻辑分别位于 src/hadolint.rs 的aliases()与 src/hadolint_compat.rs回归测试见 tests/hadolint_compatibility_test.rs。迁移验证清单四步完成切换灰度运行CI 中并行跑 Hadolint 与droast --hadolint-compatible对比两者输出文件与退出码0 无阻断发现1 有审查 stderr 诊断逐条确认unmatched规则与behaviorally different提示是否符合预期落地配置droast init --from-hadolint生成droast.toml并提交用droast .全仓库扫一遍保留回退窗口过渡期内不删除.hadolint.yaml确认稳定后再下线 Hadolint 调用相关文件与延伸阅读配置导入实现src/hadolint.rs兼容模式运行时src/hadolint_compat.rs官方文档「Hadolint replacement mode」章节DOCS.md兼容性测试tests/hadolint_compatibility_test.rs完整配置指南与 CLI 参考DOCS.md赞分享【免费下载链接】dockerfile-roastdroast - a dockerfile linter that actually has opinions 项目地址https://gitcode.com/gh_mirrors/do/dockerfile-roast点击查看免费下载相关推荐从 Docusaurus 迁移到 Blume配置、导航、内容与 Frontmatter 全量映射指南从 Docusaurus 迁移到 Blume配置、导航、内容与 Frontmatter 全量映射指南 导读 本文是面向技术文档维护者的完整迁移手册讲解如何把后端RPC框架API设计zincobserve与PromQL兼容性平滑迁移监控规则zincobserve与PromQL兼容性平滑迁移监控规则 监控系统迁移往往伴随着复杂的规则改写和兼容性挑战尤其是从Prometheus生态迁移时Prom可观测性日志分析指标监控链路追踪后端云原生Tinycast 从 Raycast 迁移完整指南.rayconfig 导入、解密原理与字段映射规则Tinycast 从 Raycast 迁移完整指南.rayconfig 导入、解密原理与字段映射规则 Tinycast 是原生 macOS 启动器/热键/剪贴桌面应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考