voxpupuli/puppetserver

Voxpupuli Puppet Server容器

⚠️ 已弃用 ⚠️

此仓库已弃用，将很快归档。请使用https://github.com/OpenVoxProject/container-openvoxserver%E6%9B%BF%E4%BB%A3%E3%80%82

---

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

---

• Voxpupuli Puppet Server容器
  • 环境缓存说明
  • 新版本 schema
  • 配置
  • 初始化脚本
  • 持久化
  • 如何发布容器
  • 如何贡献
  • 转移通知

---

此项目托管用于构建Puppet Server容器镜像的Dockerfile和所需脚本。

您可以使用以下Docker命令运行Puppet Server：

bash
docker run --name puppet --hostname puppet ghcr.io/voxpupuli/puppetserver:8.6.1-latest

虽然不严格要求将容器命名为puppet，但在使用其他Puppet镜像时这很有用，因为它们默认会在该主机名上查找服务器。

如果您想使用自己的Puppet代码启动Puppet Server，可以将自己的目录挂载到/etc/puppetlabs/code：

shell
 docker run --name puppet --hostname puppet -v ./code:/etc/puppetlabs/code ghcr.io/voxpupuli/puppetserver:8.6.1-latest

关于compose文件，请参见：https://github.com/voxpupuli/crafty/tree/main/puppet/oss

您可以在官方文档中了解更多关于Puppet Server的信息。

环境缓存说明

⚠️ Puppet Server默认启用环境缓存。部署新环境时，应显式调用API端点清除缓存。见下方curl示例。

bash
curl -i --cert $(puppet config print hostcert) \
--key $(puppet config print hostprivkey) \
--cacert $(puppet config print cacert) \
-X DELETE \
https://$(puppet config print server):8140/puppet-admin-api/v1/environment-cache?environment=production

另一个选项是将PUPPETSERVER_ENVIRONMENT_TIMEOUT环境变量设置为零（0）以禁用环境缓存。

新版本 schema

新版本 schema 格式如下：

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

使用示例：

shell
docker run --name puppet --hostname puppet -v ./code:/etc/puppetlabs/code/ ghcr.io/voxpupuli/puppetserver:8.6.1-v1.6.0

配置

支持以下环境变量：

初始化脚本

如果需要执行额外初始化，可以添加名为/docker-custom-entrypoint.d/的目录，并在其中放入.sh脚本。

您还可以在/docker-custom-entrypoint.d/中创建子目录，用于需要在不同阶段运行的脚本。

• /docker-custom-entrypoint.d/pre-default/ - 在此仓库的默认入口点脚本运行前执行的脚本。
• /docker-custom-entrypoint.d/ - 在默认入口点脚本之后、Puppet Server服务启动前执行的脚本。
• /docker-custom-entrypoint.d/post-startup/ - 在Puppet Server服务启动后执行的脚本。
• /docker-custom-entrypoint.d/sigterm-handler/ - 容器收到SIGTERM信号时执行的脚本。
• /docker-custom-entrypoint.d/post-execution/ - 在Puppet Server服务停止后执行的脚本。

持久化

如果计划使用服务器内置CA，重启容器可能导致服务器密钥和证书更改，从而使代理和服务器停止互相信任。为防止这种情况，可以持久化默认CA目录/etc/puppetlabs/puppetserver/ca。例如：

shell
docker run -v $PWD/ca-ssl:/etc/puppetlabs/puppetserver/ca ghcr.io/voxpupuli/puppetserver:8.6.1-latest

或在compose中：

yaml
services:
  puppet:
    image: ghcr.io/voxpupuli/puppetserver:8.6.1-latest
    # ...
    volumes:
      - ./ca-ssl:/etc/puppetlabs/puppetserver/ca

如何发布容器

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接管该项目以进行未来改进和维护。现有的拉取请求和问题已转移，欢迎在此分叉并继续贡献。===SHORT_DESC=== ⚠️ 已弃用 ⚠️ 此镜像用于运行Puppet Server容器，现建议使用OpenVox Server容器替代。原用于提供Puppet Server的Docker化部署，支持自定义配置、持久化存储及初始化脚本。 ===FULL_DESC===# Voxpupuli Puppet Server容器

⚠️ 已弃用 ⚠️

此仓库已弃用，将很快归档。请使用https://github.com/OpenVoxProject/container-openvoxserver%E6%9B%BF%E4%BB%A3%E3%80%82

---

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

---

• Voxpupuli Puppet Server容器
  • 环境缓存说明
  • 新版本 schema
  • 配置
  • 初始化脚本
  • 持久化
  • 如何发布容器
  • 如何贡献
  • 转移通知

---

此项目托管用于构建Puppet Server容器镜像的Dockerfile和所需脚本。

您可以使用以下Docker命令运行Puppet Server：

bash
docker run --name puppet --hostname puppet ghcr.io/voxpupuli/puppetserver:8.6.1-latest

虽然不严格要求将容器命名为puppet，但在使用其他Puppet镜像时这很有用，因为它们默认会在该主机名上查找服务器。

如果您想使用自己的Puppet代码启动Puppet Server，可以将自己的目录挂载到/etc/puppetlabs/code：

shell
 docker run --name puppet --hostname puppet -v ./code:/etc/puppetlabs/code ghcr.io/voxpupuli/puppetserver:8.6.1-latest

关于compose文件，请参见：https://github.com/voxpupuli/crafty/tree/main/puppet/oss

您可以在官方文档中了解更多关于Puppet Server的信息。

环境缓存说明

⚠️ Puppet Server默认启用环境缓存。部署新环境时，应显式调用API端点清除缓存。见下方curl示例。

bash
curl -i --cert $(puppet config print hostcert) \
--key $(puppet config print hostprivkey) \
--cacert $(puppet config print cacert) \
-X DELETE \
https://$(puppet config print server):8140/puppet-admin-api/v1/environment-cache?environment=production

另一个选项是将PUPPETSERVER_ENVIRONMENT_TIMEOUT环境变量设置为零（0）以禁用环境缓存。

新版本 schema

新版本 schema 格式如下：

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

使用示例：

shell
docker run --name puppet --hostname puppet -v ./code:/etc/puppetlabs/code/ ghcr.io/voxpupuli/puppetserver:8.6.1-v1.6.0

配置

支持以下环境变量：

| 名称 | 用途 / 默认值 |