hashieducation/inspec
hashieducation
运行inspec的Docker容器，用于集成HashiCorp learn平台，通过自动提取Markdown中的代码块生成测试，针对目标Docker容器执行语法检查和验证。
下载次数: 0状态：社区镜像维护者：hashieducation仓库类型：镜像最近更新：4 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
镜像概述
本镜像包含inspec与https://github.com/hashicorp/learn%E5%B9%B3%E5%8F%B0%E7%9A%84%E9%9B%86%E6%88%90%EF%BC%8C%E4%BD%BF%E7%94%A8Docker%E8%BF%90%E8%A1%8Cinspec%E3%80%82%E6%B5%8B%E8%AF%95/%E6%8E%A7%E5%88%B6%E9%80%9A%E8%BF%87%E4%BB%8Emarkdown(mdx)%E4%B8%AD%E6%8F%90%E5%8F%96 fenced 代码块自动生成，每个测试通过挂载的Docker socket针对目标Docker容器运行。您可以使用真实环境变量（如AWS密钥）自定义此"目标"环境，对示例代码进行实时测试，也可通过重建目标Docker容器修改其配置。
当前这些测试对Terraform HCL、JSON和Shell进行语法检查。 有关主动与被动测试的解释，请参见RFC。
核心功能与特性
- 自动测试生成：从Markdown文档中提取代码块自动创建测试用例
- 多语言支持：验证HCL、Shell、JSON和YAML等多种代码格式的语法
- 目标容器交互：通过挂载Docker socket与目标容器通信
- 环境定制：支持配置真实环境变量（如AWS密钥）进行实时测试
- 灵活配置：可通过重建目标容器修改测试环境配置
使用场景与适用范围
- HashiCorp learn平台文档的自动化测试验证
- 开发人员本地验证代码示例的语法正确性
- CI/CD流程中集成代码示例的自动化测试
- 多产品（Terraform、Vault、Nomad、Consul）文档的一致性检查
使用方法与配置说明
环境要求
需安装Docker，可从https://hub.docker.com/editions/community/docker-ce-desktop-mac%E4%B8%8B%E8%BD%BD%E3%80%82
执行inspec配置文件
在终端窗口中，运行如下./run.sh脚本。代码将从本地learn仓库的检出/分支中提取markdown内容，需使用-d参数提供本地learn仓库的根路径，然后使用-p参数指定要运行测试的产品，产品名称对应inspec配置文件。
shellmake ./run.sh -p terraform -d ~/src/learn ./run.sh -p vault -d ~/src/learn ./run.sh -p nomad -d ~/src/learn ./run.sh -p consul -d ~/src/learn
可使用
-p all运行所有配置文件 可使用| less -r管道输出带颜色的结果
产品配置文件
| 配置文件 | 说明 |
|---|---|
| terraform | 提取所有hcl、shell、json和yaml代码块并验证其语法 |
| vault | 提取所有shell、json和yaml代码块并验证其语法 |
| nomad | 提取所有shell、json和yaml代码块并验证其语法 |
| consul | 提取所有shell、json和yaml代码块并验证其语法 |
terraform通过terraform fmt -将每个代码块作为标准输入传递来验证语法。
实用配置文件
| 配置文件 | 说明 |
|---|---|
| all | 与./run.sh脚本配合使用，运行所有产品配置文件 |
| shared | 用于存储inspec库的共享自定义资源 |
| github | 与Github Action配合使用，需要GITHUB环境变量进行提交查找 |
支持文件说明
run.sh
供作者和开发人员在本地运行测试的脚本。
input.yml
包含inspec配置文件的全局输入，当前被shell_syntax自定义资源用于对代码中的占位符进行动态替换。此替换哈希允许我们对包含占位符的命令进行语法检查，否则这些命令将具有无效语法。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 inspec 镜像标签
docker pull docker.xuanyuan.run/hashieducation/inspec:<标签>
DockerHub 原生拉取命令
docker pull hashieducation/inspec:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"