System requirements

Sections

Refer to these system requirements for your Continuous Delivery for Puppet Enterprise (PE) installation.

Hardware and port requirements

Before installing Continuous Delivery for PE, ensure that your system meets these requirements.

Hardware requirements

While Continuous Delivery for PE can be installed on a single server, installing on three servers is recommended to provide redundancy in case one server becomes unavailable.

Each server must meet the following minimum requirements:

Memory Storage CPUs
8 GB
  • At least 50 GB for /opt/replicated (Add 10 GB if installing in an offline environment)

  • At least 32 GB for /var/lib/kubelet

  • At least 40 GB for /var/lib/docker
4 (or equivalent)
Note: If Continuous Delivery for PE is used by more than one team in your organization, allocate additional storage space to /opt/replicated to support the increased load on the system.

Open port requirements

Continuous Delivery for PE uses the following ports:
Port Protocol Purpose Source Destination
Continuous Delivery for PE ports
443 TCP Web UI Browser Continuous Delivery for PE
8000 TCP Webhook service Source control Continuous Delivery for PE
Platform ports
2379 TCP High availability (HA) communication etcd on the Kubernetes host etcd on the Kubernetes host
2380 TCP
6443 TCP Kubernetes API Admin workstation Kubernetes host
6783 TCP/UDP Kubernetes networking - Weave Kubernetes host Kubernetes host
6784 UDP
8800 TCP Platform admin console Admin browser Kubernetes host
9001 (offline installations only) TCP Local registry for offline installations Job hardware Kubernetes host
10250 TCP Kubernetes cluster management Kubernetes host Kubernetes host

Supported operating systems

Continuous Delivery for PE can be installed on these operating systems.

Operating system Supported versions
CentOS

7.4, 7.5, 7.6, 7.7

Red Hat Enterprise Linux (RHEL) 7.4, 7.5, 7.6, 7.7
Ubuntu (General availability kernels) 16.04 (on PE versions prior to 2019.8), 18.04

Job hardware requirements

System requirements for your job hardware vary considerably based on the size of your Continuous Delivery for PE installation, the type of jobs you run, and how frequently you run them.

The size of the load placed on a job hardware server determines how robust that server's resources need to be. Determining that load involves a huge number of variables, from the number of jobs that run concurrently to the languages those jobs are written in. As a result, it's nearly impossible to provide one-size-fits-all system requirements for job hardware.

Instead, we've developed a sizing chart based on the estimated number of concurrent jobs a job hardware server is expected to regularly handle. While this chart represents our best estimates and understanding, it's provided only as a starting point. Testing and experience will help you fine-tune your job hardware and determine the optimum resource configuration for your installation's unique circumstances.

Estimated concurrent job load Memory Disk storage CPUs
2 - 4 concurrent spec tests 4 GB 100 GB 2
4 - 8 concurrent spec tests 8 GB 100 GB 4
6 - 12 concurrent spec tests 8 GB 100 GB 6
When setting up your job hardware, keep these facts in mind:
  • Disk storage requirements are minimal, and don't increase with added load. After a job run is complete, the job's log is passed to the object storage, and all data related to the job run is erased from the job hardware.
  • You can run more jobs concurrently without increasing CPUs, but the jobs will run more slowly.

Job hardware requirements for Docker-based jobs

To run Docker-based jobs, your job hardware must have a modern version of Docker CE or Docker EE installed. The puppetlabs/docker module is our preferred way to install Docker and keep it up to date.

Job hardware used for Docker-based jobs also requires internet access. If you're working in an air-gapped environment, set up an internal Docker registry by following the Docker documentation.

Supported Puppet Enterprise versions

The following versions of Puppet Enterprise (PE) are supported for use with Continuous Delivery for PE.

PE version
2019.8.x (LTS)
2019.7
2019.5
2019.4
2019.3
2018.1.x (LTS)

For more on PE versions, see Puppet Enterprise support lifecycle.

PE version-specific feature limitations

A small number of Continuous Delivery for PE features are not available on all supported versions of PE.
  • Impact analysis reports for module code are supported on PE 2018.1.9 and newer versions in the 2018.1 series, and on all supported versions in the PE 2019.x series.
  • Hiera support for impact analysis reports is supported on all supported versions in the PE 2019.x series.

Supported browsers

The following browsers are supported for use with the Continuous Delivery for PE web UI.

Browser Supported versions
Google Chrome Current version as of release
Mozilla Firefox Current version as of release
Microsoft Edge Current version as of release
Apple Safari Current version as of release
How helpful was this page?

If you leave us your email, we may contact you regarding your feedback. For more information on how Puppet uses your personal information, see our privacy policy.

Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.