Upgrading the agent relay running as a container

You can upgrade agent relays that are running as containers by preparing a backup and using helm upgrade.

Before you begin

You must have a maintenance window in place, as scaling the statefulset results in temporary downtime.

Procedure

  1. Prepare a backup:
    1. Cancel or wait for all running deployment processes to complete.
    2. Set the agent relay statefulset resource to 0 to stop the agent relay.
    3. Back up the conf Persistent Volume.
    4. Scale the agent relay statefulset resource back to 1 to restart the agent relay.
  2. Perform a Helm upgrade on the agent relay.
  3. Verify that deployment processes operate correctly.
    If issues arise, proceed to the rollback steps.
  4. Roll back the upgrade, if required:
    1. Cancel or wait for all running deployment processes to complete.
    2. Set the agent relay statefulset resource to 0 to stop the agent relay.
    3. Restore the conf directory backup to the Persistent Volume.
    4. Perform a Helm rollback to the previous revision of the agent relay.
    5. Set the agent relay statefulset to 1 and verify that your deployment processes operate correctly after the rollback.

Results

You have upgraded the agent relay to the new version.