davidphay/puppetdb

davidphay/puppetdb Docker镜像文档

概述和主要用途

davidphay/puppetdb是PuppetDB的Docker镜像，PuppetDB是Puppet生态系统的核心组件，作为后端数据库存储节点信息、目录、事实和报告。该镜像需要配合已配置的PostgreSQL数据库容器使用，适用于构建基于Docker的Puppet基础设施。

核心功能和特性

• PostgreSQL集成：需连接PostgreSQL数据库容器，支持通过环境变量配置数据库连接参数
• 灵活配置：可通过环境变量自定义SSL证书、数据库连接、JVM参数等
• SSL证书管理：支持自动从Puppet Server获取SSL证书，也可手动配置证书
• 数据生命周期管理：支持配置节点过期时间、节点清理时间和报告保留时间
• 可扩展性：可作为基础镜像扩展，或通过挂载卷自定义配置文件

使用场景和适用范围

• Puppet基础设施的后端数据存储部署
• 自动化运维环境中节点信息和报告的集中管理
• 需要快速部署和配置PuppetDB的开发或测试环境
• 基于Docker Compose的完整Puppet栈部署（参考pupperware仓库）

使用方法和配置说明

基本运行方法

需先启动PostgreSQL容器，然后运行PuppetDB容器并链接PostgreSQL和Puppet Server：

bash
docker run --link postgres:postgres --link puppet:puppet puppet/puppetdb

配置方法

可通过以下方式自定义配置：

• 挂载包含配置文件的卷
• 将此镜像作为基础镜像构建自定义镜像
• 设置环境变量（详见下方配置参数表）

Docker Compose部署（参考）

完整Puppet栈部署可参考https://github.com/puppetlabs/pupperware，基本结构示例：

yaml
version: '3'
services:
  postgres:
    image: postgres
    environment:
      POSTGRES_USER: puppetdb
      POSTGRES_PASSWORD: puppetdb
      POSTGRES_DB: puppetdb
  puppet:
    image: puppet/puppetserver
  puppetdb:
    image: puppet/puppetdb
    links:
      - postgres:postgres
      - puppet:puppet
    environment:
      PUPPETDB_PASSWORD: puppetdb

配置参数

证书文件位置

容器内证书目录结构遵循以下约定，完整路径可通过环境变量$SSLDIR获取：

• 'ssl-ca-cert'：/opt/puppetlabs/server/data/puppetdb/certs/certs/ca.pem
• 'ssl-cert'：/opt/puppetlabs/server/data/puppetdb/certs/certs/<certname>.pem（其中<certname>为CERTNAME环境变量的值）
• 'ssl-key'：/opt/puppetlabs/server/data/puppetdb/certs/private_keys/<certname>.pem

数据分析收集

PuppetDB容器默认禁用使用数据收集。可通过在docker run命令中传递--env PUPPERWARE_ANALYTICS_ENABLED=true启用。

收集的数据内容

• PuppetDB容器版本
• 用于地理位置数据的***IP地址（IP地址本身不被收集）

收集数据的原因

收集数据是为了帮助了解容器的使用方式，以便为未来的变更做出决策。

如何选择退出数据收集

数据收集默认处于禁用状态，无需额外操作。