Restore to new infrastructure

When necessary, you can use a backup file to restore your Continuous Delivery (CD) installation to new infrastructure.

If you are restoring Continuous Delivery onto a new host, update the following items in your Bolt project before running the install plan:

  • Update the resolvable_hostname in data/common.yaml to the new hostname.

  • Update inventory.yaml to the new target host information.

  • Update the leaf certificate in ssl_cert_chain in Hiera to point to the new resolvable_hostname.

To restore your Continuous Delivery (CD) installation to a new server:

  1. Install Continuous Delivery (CD) on the new system. From the root of your Continuous Delivery (CD) Bolt project run:
    Copy
    bolt plan run cd4peadm::install
  2. Copy the backup tarball you wish to restore to /var/lib/puppetlabs/cd4pe/backups on the new system.
  3. Restore the backup on the new system. From the root of your Continuous Delivery (CD) Bolt project run:
    Copy
    bolt plan run cd4peadm::restore backup=<backup tarball name>.zip

    Include the .zip file extension in the backup name. Wait for the restore to finish before moving to the next step.

  4. Update the installation with the database passwords. From the root of your Continuous Delivery (CD) Bolt project run:
    Copy
    bolt plan run cd4peadm::apply_configuration

After the restore, update any webhooks that reference the previous hostname. For more information, see Troubleshooting Continuous Delivery (CD).