Puppet Dev Tools

镜像概述和主要用途

Puppet Dev Tools是一个集成了多种Puppet开发工具的Docker镜像，旨在简化Puppet模块的开发、测试和验证流程。该镜像包含PDK（Puppet Development Kit）、Onceover以及一系列预安装的Rake任务，适用于Puppet模块的语法检查、测试执行、文档生成等开发环节。

Docker标签说明

<year>-<month>-<day>-<short-string>

每次合并到master分支会生成以此标签命名的镜像，格式为构建日期加简短Git SHA。适合需要固定版本而非使用4.x动态更新的场景。镜像间的变更包括GitHub提交历史中的更新以及构建时拉取的操作系统包更新，同时会包含最新版本的PDK。

<year>-<month>-<day>-<short-string>-rootless

与上述标签功能相同，但容器以puppetdev用户身份运行，提供无root权限的执行环境。

4.x

用于CD4PE（Continuous Delivery for Puppet Enterprise）4.x版本的标签，由维护团队定期手动更新。

latest

遗留标签，并非最新的puppet-dev-tools构建，适用于CD4PE 4.0之前的旧版本，由CD4PE团队手动创建。

使用方法

基本运行命令

通过以下命令运行容器，其中<command>替换为支持的工具命令：

bash
docker run --rm -v $(pwd):/repo puppet/puppet-dev-tools <command>

• --rm：容器退出后自动删除
• -v $(pwd):/repo：将当前工作目录挂载到容器内的/repo目录，便于工具访问本地代码

支持的命令

1. PDK（Puppet Development Kit）

• 命令：pdk
• 查看帮助：

  bash
  docker run --rm puppet/puppet-dev-tools:4.x pdk --help
  

• 详细文档：PDK命令参考

2. Onceover

• 命令：onceover
• 查看帮助：

  bash
  docker run --rm puppet/puppet-dev-tools:4.x onceover --help
  

• 详细文档：Onceover README

3. Rake任务（基于已安装的gems）

• 运行单个Rake任务示例：

  bash
  docker run --rm -v $(pwd):/repo puppet/puppet-dev-tools:4.x rake -f /Rakefile lint
  

• 运行多个Rake任务示例：

  bash
  docker run --rm -v $(pwd):/repo puppet/puppet-dev-tools:4.x rake -f /Rakefile lint syntax yamllint
  

Onceover使用注意事项

若控制仓库包含Gemfile，需修改命令以安装依赖：

bash
docker run --rm -v $(pwd):/repo puppet/puppet-dev-tools:latest \
/bin/bash -c "bundle install && bundle exec onceover run spec --force --trace --parallel"

支持的Rake任务列表