此仓库已弃用,将很快归档。请使用OpenVox Server容器替代。
 \ --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 格式如下:
text<puppet.major>.<puppet.minor>.<puppet.patch>-v<container.major>.<container.minor>.<container.patch>
使用示例:
shelldocker 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中的reportspuppetdb |
| PUPPET_STORECONFIGS | 设置puppet.conf中的storeconfigstrue |
| PUPPET_STORECONFIGS_BACKEND | 设置puppet.conf中的storeconfigs_backendpuppetdb |
| 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设为falsetrue |
| 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。例如:
shelldocker run -v $PWD/ca-ssl:/etc/puppetlabs/puppetserver/ca ghcr.io/voxpupuli/puppetserver:8.6.1-latest
或在compose中:
yamlservices: puppet: image: ghcr.io/voxpupuli/puppetserver:8.6.1-latest # ... volumes: - ./ca-ssl:/etc/puppetlabs/puppetserver/ca
参见此处
参见此处
此项目最初由Puppet创建。维护者希望Vox Pupuli接管该项目以进行未来改进和维护。现有的拉取请求和问题已转移,欢迎在此分叉并继续贡献。===SHORT_DESC=== ⚠️ 已弃用 ⚠️ 此镜像用于运行Puppet Server容器,现建议使用OpenVox Server容器替代。原用于提供Puppet Server的Docker化部署,支持自定义配置、持久化存储及初始化脚本。 ===FULL_DESC===# Voxpupuli Puppet Server容器
此仓库已弃用,将很快归档。请使用OpenVox Server容器替代。
 \ --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 格式如下:
text<puppet.major>.<puppet.minor>.<puppet.patch>-v<container.major>.<container.minor>.<container.patch>
使用示例:
shelldocker 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 | 小变更或错误修复 |
支持以下环境变量:
| 名称 | 用途 / 默认值 |
来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429