Chapter 11. Upgrading Quay

The full list of Quay versions can be found on the Red Hat Quay Release Notes page.

11.1. Special Note

Note

If you are upgrading from a version of Quay older than 2.0.0, you must upgrade to Quay 2.0.0 first. Please follow the Upgrade to Quay 2.0.0 instructions to upgrade to Quay 2.0.0, and then follow the instructions below to upgrade from 2.0.0 to the latest version you’d like.

11.2. Upgrading Note

Note

We highly recommend performing upgrades during a scheduled maintenance window, as it will require taking the existing cluster down temporarily. We are working to remove this restriction in a future release.

11.3. The upgrade process

  1. Visit the Red Hat Quay Release Notes page and note the latest version of Quay.
  2. Shutdown the Quay cluster: Remove all containers from service.
  3. On a single node, run the newer version of Quay.
  4. Quay will perform any necessary database migrations before bringing itself back into service.

  5. Watch the logs of the running container to determine when the upgrade has completed: 

    # docker logs -f {containerId}
  6. Update all other nodes to refer to the new tag and bring them back into service.