voxpupuli/container-puppetserver

Voxpupuli Puppet Server 容器

⚠️ 已弃用 ⚠️

此仓库已弃用，即将归档。请改用 https://github.com/OpenVoxProject/container-openvoxserver%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) ![由 Puppet ]([] ![由 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 的信息。

环境缓存注意事项

⚠️ Puppetserver 默认启用了 环境缓存。部署新环境时，应显式调用 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/ - 在默认入口点脚本之后、puppetserver 服务启动之前执行的脚本。
• /docker-custom-entrypoint.d/post-startup/ - 在 puppetserver 服务启动之后执行的脚本。
• /docker-custom-entrypoint.d/sigterm-handler/ - 容器收到 SIGTERM 信号时执行的脚本。
• /docker-custom-entrypoint.d/post-execution/ - 在 puppetserver 服务停止之后执行的脚本。

持久化

如果计划使用服务器内置 CA，重启容器可能导致服务器的密钥和证书更改，从而使代理和服务器停止相互信任。为避免这种情况，您可以持久化默认的 cadir /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 创建。维护者希望 Vox Pupuli 接管该项目以进行未来的改进和维护。现有的拉取请求和问题已转移，欢迎在此处 fork 并继续贡献。