vladgh/r10k

R10K Docker镜像 (https://github.com/vladgh/docker_base_images/tree/master/r10k)

镜像概述

本镜像为R10K工具的容器化版本，R10K是Puppet Labs官方提供的运维工具，用于自动化管理Puppet控制仓库和Puppetfile，实现环境部署与模块同步的标准化流程。

核心功能

1. 支持Puppetfile的检查与安装操作
2. 通过CRONTIME配置定时部署任务
3. 通过POSTRUN设置部署后的自定义命令（如通知、回调）
4. 可自定义缓存目录存储Git仓库缓存
5. 支持挂载外部R10K配置文件和缓存目录

使用场景

• Puppet环境的自动化部署与同步
• 定时更新Puppet模块以保持环境一致性
• 部署完成后触发外部系统通知（如CI/CD流水线回调）
• 隔离的Puppet模块管理环境，避免本地依赖冲突

配置说明

环境变量

• REMOTE：Puppet控制仓库的远程URL（未挂载配置文件时必填）
• POSTRUN：部署后执行的命令，需以字符串数组形式传入（示例：POSTRUN="['/usr/bin/curl', '-F', 'deploy=done', 'http://my-app.site/endpoint']"）
• CRONTIME：定时执行部署的cron表达式（示例：CRONTIME='0 */6 * * *' 表示每6小时执行一次）
• CACHEDIR：Git仓库缓存位置（默认：/var/cache/r10k）

部署示例

检查Puppetfile

bash
docker run -it \
  -v $(pwd)/Puppetfile:/Puppetfile \
  vladgh/r10k \
  r10k puppetfile check

安装Puppetfile模块

bash
docker run -it \
  -v $(pwd)/Puppetfile:/Puppetfile \
  vladgh/r10k \
  r10k puppetfile install --verbose

定时部署环境

bash
docker run -it \
  -e REMOTE='https://github.com/me/example.git' \
  -e CRONTIME='0 */6 * * *' \
  vladgh/r10k \
  r10k deploy environment --puppetfile --verbose

部署后执行自定义命令

bash
docker run -it \
  -e REMOTE='https://github.com/me/example.git' \
  -e POSTRUN="['/usr/bin/curl', '-F', 'deploy=done', 'http://my-app.site/endpoint']" \
  vladgh/r10k \
  r10k deploy environment --puppetfile --verbose

挂载外部配置文件

bash
docker run -it \
  -v $(pwd)/r10k.yaml:/etc/puppetlabs/r10k/r10k.yaml \
  -v $(pwd)/cache:/var/cache/r10k \
  vladgh/r10k \
  r10k deploy environment --puppetfile --verbose