Install Continuous Delivery

After installing Bolt, specify your initial configuration setting and deploy Continuous Delivery for the first time.

1. Install Bolt version 3.27.4 or later on a Linux jumphost. This can be the intended Continuous Delivery 5.x host, or any other system.
2. Create the Continuous Delivery Bolt project and switch to that directory.
   Copy

   mkdir cd4pe-bolt-project 
   cd cd4pe-bolt-project
   bolt project init cd4pe_bolt_project

3. Edit the bolt-project.yaml file’s modules and module-install sections. Replace the version_requirement with the version you wish to install, for example you would use 5.9.0 for the latest version. Add your Forge API token in authorization_token.
   Copy

   # bolt-project.yaml
   modules:
     - name: puppetlabs/cd4peadm
       version_requirement: <version to install>
   
   module-install:
     forge:
        authorization_token: 'Bearer <your API token>'
        baseurl: https://forgeapi.puppet.com
   

4. Optional: Enable log append mode for Bolt logging to simplify debugging efforts in the case of problems. Add the following to bolt-project.yaml:
   Copy

   # bolt-project.yaml
   log:
     bolt-debug.log:
       append: true
       level: debug            

   Enabling logging causes bolt-debug.log to grow over time. You can safely delete this file to free space as needed.
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 5.x is to be installed. Do not install Continuous Delivery on the same host you've installed Puppet Enterprise on. For example:
   Copy

   ---
   groups:
     - name: cd4pe-nodes
       config:
         transport: ssh
         ssh:
           host-key-check: false
           native-ssh: true
           ssh-command: <Path to SSH command>
           user: root
       targets:
         - cd4pev5.<yourcompany.com>

   If you are installing on a localhost, use the following inventory.yaml instead:

   Copy

   ---
   groups:
     - name: cd4pe-nodes
       config:
         transport: local
       targets:
         - uri: localhost

   If you need to change your resolvable hostname for some reason, see Update your resolvable hostname.
7. Optional: If you have a license file, create a directory named files and copy the license file to files/license.lic. A license file is required to access the premium features of Continuous Delivery.
8. Install Continuous Delivery on the target host using: bolt plan run cd4peadm::install.
   If you prefer to install Continuous Delivery noninteractively, instead of using bolt plan run cd4peadm::install do the following:

   1. Generate a configuration file manually using:
      Copy

         bolt plan run cd4peadm::generate_config \ 
         admin_password=perforce! \
         inventory_aio_target="cd4pe_host" \
         resolvable_hostname="cd4pev5.mycompany.net"

      This generates a configuration file at data/common.yaml. If you would like to see all of the configuration options, use bolt plan show cd4peadm::generate_config.

   2. Install Continuous Delivery on the target host using: bolt plan run cd4peadm::install_from_config.