Sign inSign up

vshn/puppet-puppetserver

By vshn

Updated about 5 years ago

VSHN Puppetserver

Image
0

4.5K

vshn/puppet-puppetserver repository overview

Puppetserver

Docker Hub: vshn/puppet-puppetserver

Introduction

Puppetserver image for running Puppetserver in Docker. Can be configured to be a CA or a compiler only.

Usage

Environment variables
NameDescriptionDefault value
AUTOSIGNPuppet CA autosign configurationtrue
CAWhen "enabled" CA service will be enableddisabled
CA_SERVERPuppet CA server to request certificatepuppetca.local
CNCN for certificate request$hostname
HIERA_BASE64Base64 encoded Hiera configuration-
PUPPETDB_SERVER_URLURL to PuppetDB-
PUPPETSERVER_JRUBYINSTANCESNumber of JRuby instances, set to #cpu + 22
PUPPET_ENCConfiguration for external_nodes-
SKIP_CRL_DOWNLOADIf set to true, skips download of CRL from CA-
USE_LEGACY_CA_APIIf set to true, sets CA API URLs for Puppet 3.8-
CA_NAMEThe CN of the generated Puppet CA certificate-
CA_TTLExpire TTL of newly created certs by the CA5y

Support for arbitrary configuration in puppet.conf:

Use environment variables starting with PUPPETCONF_ to add configuration values to puppet.conf. They are in this format: PUPPETCONF_<SECTION>_<KEY>=<VALUE>.

Example:

PUPPETCONF_MASTER_ENVIRONMENT_TIMEOUT=unlimited

This will add enviroment_timeout = unlimited to puppet.conf in the section [master].

Puppetserver configuration

Default configuration files are saved under config/ and are copied into the image during the build process. To overwrite these files and put the own customized configuration into the image (like the Hiera structure) the best way is to build a new image. Example:

FROM vshn/puppet-puppetserver:latest
COPY hiera.yaml /etc/puppetlabs/puppet/hiera.yaml

Other scripts, f.e. a custom ENC provider should also be copied into the image using this way.

Puppet4

The main build is for Puppet 5 with PuppetDB 5. If you need Puppet 4 with PuppetDB 5 support, use the Dockerfile.puppet4 which uses puppetdb-termini version 4.4.x

Support for older PuppetDB versions and support for Puppet 3.8 has been removed.

Details

  • Ports exposed: 8140
  • Volumes: -
  • Based on: ubuntu:16.04
Entrypoint scripts
NameDescription
10-configure-ca.shConfigures CA behavior - if disabled requests a certificate from CA
20-puppetdb.shConfigures connection to PuppetDB if PUPPETDB_SERVER_URL is set
30-enc.shConfigures the ENC to be used
31-hiera.shConfigures Hiera
40-external-tls-termination.shPreparation for allowing SSL termination on HAProxy
50-disable-legacy-auth.shSets use-legacy-auth-conf: false

Tag summary

Content type

Image

Digest

Size

251.3 MB

Last updated

about 5 years ago

docker pull vshn/puppet-puppetserver:6.9