voxpupuli/puppetdb

⚠️ 已弃用 ⚠️ 本仓库已弃用，即将归档。请改用https://github.com/OpenVoxProject/container-openvoxdb%E3%80%82

https://github.com/voxpupuli/container-puppetdb/actions/workflows/ci.yaml/badge.svg](https://github.com/voxpupuli/container-puppetdb/actions/workflows/ci.yaml) ![Donated by Puppet]([] ![Sponsored by betadots GmbH]([]

• Voxpupuli PuppetDB容器
  • 新版本命名规则
  • 配置
    • 证书文件位置
  • 初始化脚本
  • Docker部署方案示例
  • 容器发布方法
  • 贡献指南
  • 项目转移说明

⚠️ 注意 ⚠️：容器名称voxpupuli/container-puppetdb将于2025年2月弃用，未来可能会被移除。请改用voxpupuli/puppetdb。

本项目包含构建PuppetDB容器镜像所需的Dockerfile和脚本。有关compose文件，请参见https://github.com/voxpupuli/crafty/tree/main/puppet/oss%E3%80%82

PuppetDB容器需要一个正常运行的PostgreSQL容器或其他适当配置的PostgreSQL数据库。有关Compose示例，请参见https://github.com/voxpupuli/crafty/blob/main/puppet/oss/compose.yaml%E3%80%82

您可以通过挂载包含配置文件的卷或将此镜像用作基础镜像来更改配置设置。默认配置请参见https://github.com/voxpupuli/container-puppetdb/tree/main/puppetdb%E3%80%82

有关PuppetDB的更多详情，请参见官方文档。

新版本命名规则

新版本命名规则如下：

text
<puppet.major>.<puppet.minor>.<puppet.patch>-v<container.major>.<container.minor>.<container.patch>

示例用法：

shell
docker pull ghcr.io/voxpupuli/puppetdb:7.13.0-v1.2.1

配置

证书文件位置

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

• 'ssl-ca-cert'
  /opt/puppetlabs/server/data/puppetdb/certs/certs/ca.pem

• 'ssl-cert'
  /opt/puppetlabs/server/data/puppetdb/certs/certs/<certname>.pem

• 'ssl-key'
  /opt/puppetlabs/server/data/puppetdb/certs/private_keys/<certname>.pem

初始化脚本

如果需要执行额外的初始化操作，可添加名为/docker-custom-entrypoint.d/的目录，并在其中放置.sh脚本。这些脚本将在入口点脚本末尾、服务启动前执行。

Docker部署方案示例

以下是使用Docker Compose部署PuppetDB及依赖的PostgreSQL的基本示例：

yaml
version: '3.8'
services:
  postgres:
    image: postgres:14
    environment:
      POSTGRES_DB: puppetdb
      POSTGRES_USER: puppetdb
      POSTGRES_PASSWORD: puppetdb
    volumes:
      - postgres_data:/var/lib/postgresql/data

  puppetdb:
    image: ghcr.io/voxpupuli/puppetdb:7.13.0-v1.2.1
    environment:
      PUPPETDB_POSTGRES_HOSTNAME: postgres
      PUPPETDB_POSTGRES_PORT: 5432
      PUPPETDB_POSTGRES_DATABASE: puppetdb
      PUPPETDB_USER: puppetdb
      PUPPETDB_PASSWORD: puppetdb
      CERTNAME: puppetdb
      PUPPETSERVER_HOSTNAME: puppet
    depends_on:
      - postgres
    volumes:
      - puppetdb_data:/opt/puppetlabs/server/data/puppetdb

volumes:
  postgres_data:
  puppetdb_data:

容器发布方法

https://github.com/voxpupuli/crafty/blob/main/RELEASE.md

贡献指南

https://github.com/voxpupuli/crafty/blob/main/CONTRIBUTING.md

项目转移说明

本项目最初由https://github.com/puppetlabs%E5%88%9B%E5%BB%BA%E3%80%82%E7%BB%B4%E6%8A%A4%E8%80%85%E5%B8%8C%E6%9C%9BVox Pupuli接管该项目以进行未来的改进和维护。现有的拉取请求和问题已转移至此，请 Fork 并继续在此贡献。