Puppet Bolt 容器镜像文档

一、镜像概述与主要用途

Puppet Bolt 容器镜像是 Puppet Bolt 工具的容器化分发形式，镜像发布于 Docker Hub，标签策略如下：

• 标签对应 Bolt 系统包及 Rubygem 版本
• latest 标签指向最新版本

该镜像用于在容器环境中运行 Puppet Bolt 命令，实现对远程目标节点的任务执行、配置管理等操作，无需在主机本地安装 Bolt 依赖。

二、核心功能与特性

1. 独立运行能力：容器内可直接执行 Bolt 命令，localhost 目标指向容器内部环境
2. 灵活的数据共享：支持通过环境变量传递配置、挂载主机目录共享项目文件
3. 可扩展性：支持基于官方镜像构建自定义扩展镜像，集成固定配置与模块
4. 完整命令支持：兼容 Bolt 原生命令（如 command run、task run 等）

三、使用场景与适用范围

• 临时任务执行：快速运行 Bolt 命令而无需在本地部署完整 Bolt 环境
• 环境隔离：避免主机环境依赖冲突，标准化 Bolt 运行环境
• CI/CD 集成：在自动化流程中嵌入 Bolt 任务执行步骤
• 定制化工作流：通过挂载或构建扩展镜像，固化项目配置与模块

四、详细使用方法与配置说明

4.1 下载镜像

从 Docker Hub 拉取最新版镜像：

docker pull puppet/puppet-bolt

4.2 完全独立运行

基本说明

独立运行时，localhost 目标对应容器内部环境（非 Docker 主机），可直接执行命令测试容器内系统信息。

示例：在容器内执行命令

docker run puppet/puppet-bolt command run 'cat /etc/os-release' -t localhost

输出示例

Started on localhost...
Finished on localhost:
  STDOUT:
    NAME="Ubuntu"
    VERSION="16.04.6 LTS (Xenial Xerus)"
    ID=ubuntu
    ID_LIKE=debian
    PRETTY_NAME="Ubuntu 16.04.6 LTS"
    VERSION_ID="16.04"
    HOME_URL="[***]"
    SUPPORT_URL="[***]"
    BUG_REPORT_URL="[***]"
    VERSION_CODENAME=xenial
    UBUNTU_CODENAME=xenial
Successful on 1 node: localhost
Ran on 1 node in 0.00 seconds

4.3 通过环境变量传递清单（Inventory）

适用场景

无需自定义模块，仅需传递目标节点连接信息时，可通过 BOLT_INVENTORY 环境变量注入清单配置。

清单文件示例（inventory.yaml）

---
nodes:
  - name: pnz2rzpxfzp95hh.delivery.puppetlabs.net  # 目标节点名称
    alias: docker-example  # 别名（用于 -t 参数指定目标）
    config:
      transport: ssh  # 传输方式：SSH
      ssh:
        user: root  # SSH 用户名
        password: secret-password  # SSH 密码
        host-key-check: false  # 禁用主机密钥检查

执行内置任务示例

通过环境变量传递清单并运行 facts 任务（获取目标节点系统信息）：

docker run --env "BOLT_INVENTORY=$(cat Boltdir/inventory.yaml)" puppet/puppet-bolt task run facts -t docker-example

输出示例

Started on pnz2rzpxfzp95hh.delivery.puppetlabs.net...
Finished on pnz2rzpxfzp95hh.delivery.puppetlabs.net:
  {
    "os": {
      "name": "CentOS",
      "release": {
        "full": "7.2",
        "major": "7",
        "minor": "2"
      },
      "family": "RedHat"
    }
  }
Successful on 1 node: pnz2rzpxfzp95hh.delivery.puppetlabs.net
Ran on 1 node in 0.55 seconds

4.4 从主机挂载 Bolt 项目目录

基本说明

通过挂载主机的 Bolt 项目目录（Boltdir），使容器可访问自定义模块、配置文件及密钥，适用于需要持久化或动态更新项目内容的场景。

主机目录结构

.
└── Boltdir
    ├── bolt.yaml          # Bolt 配置文件
    ├── inventory.yaml     # 目标节点清单
    ├── keys               # 密钥目录
    │   └── id_rsa-acceptance  # SSH 私钥
    └── site-modules       # 自定义模块
        └── docker_task    # 模块名称
            └── tasks
                └── init.sh  # 任务脚本

核心配置文件内容

• bolt.yaml（Bolt 配置）：

  ---
  log:
    console:
      level: notice  # 控制台日志级别
  

• inventory.yaml（目标节点清单，注意路径为容器内路径）：

  ---
  nodes:
    - name: pnz2rzpxfzp95hh.delivery.puppetlabs.net
      alias: docker-example
      config:
        transport: ssh
        ssh:
          user: root
          private-key: /Boltdir/keys/id_rsa-acceptance  # 容器内私钥路径
          host-key-check: false
  

• init.sh（任务脚本示例）：

  #!/bin/bash
  echo "Message: ${PT_message}"  # 输出传入的 message 参数
  

挂载并执行任务

将主机 Boltdir 挂载到容器 /Boltdir 目录，执行自定义任务：

docker run --mount type=bind,source=/home/cas/working_dir/docker_bolt/Boltdir,destination=/Boltdir puppet/puppet-bolt task run docker_task message=hi -t docker-example

输出示例

Started on pnz2rzpxfzp95hh.delivery.puppetlabs.net...
Finished on pnz2rzpxfzp95hh.delivery.puppetlabs.net:
  Message: hi
  {
  }
Successful on 1 node: pnz2rzpxfzp95hh.delivery.puppetlabs.net
Ran on 1 node in 0.56 seconds

4.5 基于 puppet-bolt 镜像构建扩展镜像

基本说明

通过 Dockerfile 构建自定义镜像，将固定配置、模块或密钥集成到镜像中，适用于需要重复使用相同项目内容的场景。

扩展镜像目录结构

.
└── Boltdir
    ├── bolt.yaml
    ├── Dockerfile       # 自定义 Dockerfile
    ├── inventory.yaml
    ├── keys
    │   └── id_rsa-acceptance
    └── site-modules
        └── docker_task
            └── tasks
                └── init.sh

Dockerfile 内容

FROM puppet/puppet-bolt  # 基于官方镜像
COPY . /Boltdir          # 将当前目录（Boltdir）复制到容器 /Boltdir

构建扩展镜像

docker build . -t my-extended-puppet-bolt  # 构建镜像并命名为 my-extended-puppet-bolt

执行扩展镜像任务

直接运行扩展镜像，无需额外挂载或传递配置：

docker run my-extended-puppet-bolt task run docker_task message=hi -t docker-example

输出示例

Started on pnz2rzpxfzp95hh.delivery.puppetlabs.net...
Finished on pnz2rzpxfzp95hh.delivery.puppetlabs.net:
  Message: hi
  {
  }
Successful on 1 node: pnz2rzpxfzp95hh.delivery.puppetlabs.net
Ran on 1 node in 0.56 seconds

五、环境变量说明