Install Continuous Delivery for PE

After installing Bolt, specify your initial configuration setting and deploy Continuous Delivery for Puppet Enterprise (PE) for the first time.

Before you begin

Unlike version 4.x, Continuous Delivery for Puppet Enterprise (PE) 5.x uses Bolt for installation, configuration, and administration instead of PAM.

Before migrating, please make sure the system you plan to install Bolt on has internet access as well as SSH access to the system on which you intend to install Continuous Delivery for PE 5.x. In addition, because Bolt is installed on one or more systems and used to manage one centralized Continuous Delivery for PE installation, it may be a good idea to maintain the Bolt project in its own VCS repo.

  1. Install Bolt version 3.27.2 or later on a jumphost. This can be the intended Continuous Delivery for PE 5.x host, or any other system.
  2. Create the Continuous Delivery for PE Bolt project and switch to that directory. 
    mkdir cd4pe-bolt-project 
cd cd4pe-bolt-project
bolt project init cd4pe_bolt_project
  3. Edit the bolt-project.yaml file and change the modules section to: 
    modules:
  - name: puppetlabs/cd4peadm
    version_requirement: 5.y.z
  4. If you have not done so, update the module-install section as described in Configuring Bolt to enable access to premium modules on the Puppet Forge.
  5. Install the cd4peadm module using the command: bolt module install.
  6. Create an inventory.yaml file with the connection information for the host on which Continuous Delivery for PE 5.x is to be installed. For example: 
    ---
groups:
  - name: cd4pe-nodes
    config:
      transport: ssh
      ssh:
        host-key-check: false
        user: root
    targets:
      - cd4pev5.<yourcompany.com>
    If you are installing on a localhost, use the following inventory.yaml instead:
    ---
groups:
  - name: cd4pe-nodes
    config:
      transport: local
      local:
        bundled-ruby: false
    targets:
      - uri: localhost
  7. Install Continuous Delivery for PE on the target host using: bolt plan run cd4peadm::install.
    This plan gives you option to either do a new install or to migrate data from a 4.x instance.
  8. Select the new install option.
Results
You can now log into the application at the resolvable hostname and admin username and password you provided during the installation.