voxpupuli/puppetserver Docker Image Overview

voxpupuli/puppetserver

voxpupuli

⚠️ 已弃用 ⚠️ 此镜像用于运行Puppet Server容器，现建议使用OpenVox Server容器替代。原用于提供Puppet Server的Docker化部署，支持自定义配置、持久化存储及初始化脚本。

下载次数: 0状态：社区镜像维护者：voxpupuli仓库类型：镜像最近更新：1 年前

轩辕镜像，加速的不只是镜像。点击查看

中文简介版本下载

轩辕镜像，加速的不只是镜像。点击查看

Voxpupuli Puppet Server容器

⚠️ 已弃用 ⚠️

此仓库已弃用，将很快归档。请使用OpenVox Server容器替代。

![CI]([] ![License]([] ![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文件，请参见：CRAFTY

您可以在官方文档中了解更多关于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 \
[***] 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

名称	描述
puppet.major	包含的Puppet主版本号（7或8）
puppet.minor	包含的Puppet次版本号
puppet.patch	包含的Puppet补丁版本号
container.major	基础容器的主版本号（Ubuntu 22.04）或不兼容变更
container.minor	新功能或重构，保持向后兼容
container.patch	小变更或错误修复

配置

支持以下环境变量：

名称	用途 / 默认值
PUPPETSERVER_HOSTNAME	服务器SSL证书上使用的DNS名称 - 设置puppet.conf中的`server` 默认未设置。
CERTNAME	服务器SSL证书上使用的DNS名称 - 设置puppet.conf中的`certname` 默认未设置。
DNS_ALT_NAMES	添加到服务器SSL证书的其他DNS名称注意仅在首次运行生成证书时有效
PUPPETSERVER_PORT	Puppet Server端口 `8140`
AUTOSIGN	是否在Puppet Server实例上启用自动签名。有效值为`true`、`false`和`/path/to/autosign.conf`。默认`true`。
CA_ENABLED	此Puppet Server实例是否运行CA（证书颁发机构） `true`
CA_TTL	CA过期日期（以秒为单位或带后缀`s`、`m`、`h`、`d`、`y`） `***`
CA_HOSTNAME	运行CA的Puppet Server的DNS主机名。仅当`CA_ENABLED=false`时生效 `puppet`
CA_PORT	CA的监听端口。仅当`CA_ENABLED=false`时生效 `8140`
CA_ALLOW_SUBJECT_ALT_NAMES	CA是否应签署包含主题备用名称的SSL证书。仅当`CA_ENABLED=true`时生效。 `false`
INTERMEDIATE_CA	允许导入现有中间CA。需要`INTERMEDIATE_CA_BUNDLE`、`INTERMEDIATE_CA_CHAIN`和`INTERMEDIATE_CA_KEY`。参见Puppet中间CA
INTERMEDIATE_CA_BUNDLE	完整CA bundle的文件路径和名称（签名CA + 中间CA）
INTERMEDIATE_CRL_CHAIN	完整CA CRL链的文件路径和名称
INTERMEDIATE_CA_KEY	私有CA密钥的文件路径和名称
PUPPET_REPORTS	设置puppet.conf中的`reports` `puppetdb`
PUPPET_STORECONFIGS	设置puppet.conf中的`storeconfigs` `true`
PUPPET_STORECONFIGS_BACKEND	设置puppet.conf中的`storeconfigs_backend` `puppetdb`
PUPPETSERVER_MAX_ACTIVE_INSTANCES	允许的最大JRuby实例数 `1`
PUPPETSERVER_MAX_REQUESTS_PER_INSTANCE	JRuby实例在其生命周期内将处理的最大HTTP请求数（禁用实例刷新） `0`
PUPPETSERVER_JAVA_ARGS	启动服务时直接传递给JVM的参数 `-Xms1024m -Xmx1024m`
USE_PUPPETDB	是否连接到PuppetDB 如果未设置，将`PUPPET_REPORTS`设为`log`，`PUPPET_STORECONFIGS`设为`false` `true`
PUPPETDB_SERVER_URLS	`/etc/puppetlabs/puppet/puppetdb.conf`中设置的`server_urls` `[***]`
PUPPETDB_HOSTNAME	PuppetDB的DNS名称默认`puppetdb`
PUPPETDB_SSL_PORT	PuppetDB的TLS端口默认`8081`
PUPPETSERVER_GRAPHITE_EXPORTER_ENABLED	激活graphite导出器。还需要__PUPPETSERVER_GRAPHITE_HOST__和__PUPPETSERVER_GRAPHITE_PORT__ 默认`false`
PUPPETSERVER_GRAPHITE_HOST	仅当__PUPPETSERVER_GRAPHITE_EXPORTER_ENABLED__设为`true`时使用。Puppet应推送指标的graphite服务器的FQDN或主机名。默认`exporter`
PUPPETSERVER_GRAPHITE_PORT	仅当__PUPPETSERVER_GRAPHITE_EXPORTER_ENABLED__设为`true`时使用。Puppet应推送指标的graphite服务器端口。默认`9109`
PUPPETSERVER_ENVIRONMENT_TIMEOUT	配置环境超时时间默认`unlimited`
PUPPETSERVER_ENABLE_ENV_CACHE_DEL_API	通过证书启用Puppet管理API端点，允许清除环境缓存默认`true`
ENVIRONMENTPATH	设置环境路径默认`/etc/puppetlabs/code/environments`
HIERACONFIG	在puppet.conf文件中设置hiera_config条目默认`$confdir/hiera.yaml`
CSR_ATTRIBUTES	提供csr_attributes.yaml内容的JSON字符串。例如：`CSR_ATTRIBUTES='{"custom_attributes": { "challengePassword": "foobar" }, "extension_requests": { "pp_project": "foo" } }'` 请注意，在compose文件中，必须将所有环境变量作为Hash提供，而不是Array！ environment: `CSR_ATTRIBUTES: '{"extension_request": {...}}'`

初始化脚本

如果需要执行额外初始化，可以添加名为/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

如何发布容器

参见此处

如何贡献