Configure global shared job hardware

All workspaces in your Continuous Delivery installation can use global shared job hardware. The root user or a super user must set up these special job hardware servers in the root console.

Before you begin:
Review the Job hardware requirements sizing guide.
  1. Install a Puppet agent on each node you want to use as global shared job hardware. The PE documentation provides instructions for Installing agents.
  2. Make sure your Continuous Delivery user role in PE has permission to run the cd4pe_jobs::run_cd4pe_job task.
  3. Install the puppetlabs-cd4pe_jobs module from the Forge. This module is required to run Continuous Delivery jobs on your nodes.
    1. Add the puppetlabs-cd4pe_jobs module to:
      • The Puppetfile for the production environment on the PE primary server that manages the agent nodes you've selected as job hardware.
      • The Puppetfile on the main branch of the control repo associated with the PE primary server managing the agent nodes you've selected as job hardware.

        A sample Puppetfile entry:

        mod 'puppetlabs-cd4pe_jobs', '1.6.0'
    2. Run puppet code deploy production --wait to deploy the updated code to the production environment.
  4. Install and configure Docker or podman on your selected global shared job hardware nodes. Instructions are available in the podman or Docker documentation.
  5. In the Continuous Delivery root console, click Hardware.
  6. You must assign all global shared job hardware servers to the Containerized capability, which Continuous Delivery automatically creates for you. Locate the Containerized capability and click Edit.
  7. Assign all your global shared job hardware servers to the Containerized capability. Select the PE instance that manages the nodes you've selected as job hardware, and then select the global shared job hardware nodes.
    Selected nodes appear in the Hardware with this capability list.
  8. After selecting all the global shared job hardware nodes, click Save.
  9. Optional: Create additional capabilities for your global job hardware servers, as explained in Add job hardware capabilities.
Results
Your global shared job hardware is configured. Users in all workspaces now see a Run on shared hardware option when creating or editing a job. Jobs configured to run on your global shared job hardware have the Containerized capability automatically selected, and these jobs run on the global shared job hardware assigned to the Containerized capability.
For instructions using containerized jobs in an airgapped environment, see Install container images on offline nodes.