Chapter 3. Standalone upgrade
In general, Red Hat Quay supports upgrades from a prior (N-1) minor version only. For example, upgrading directly from Red Hat Quay 3.0.5 to the latest version of 3.5 is not supported. Instead, users would have to upgrade as follows:
-
3.0.5
3.1.3 -
3.1.3
3.2.2 -
3.2.2
3.3.4 -
3.3.4
3.4.z -
3.4.z
3.5.z
This is required to ensure that any necessary database migrations are done correctly and in the right order during the upgrade.
In some cases, Red Hat Quay supports direct, single-step upgrades from prior (N-2, N-3) minor versions. This exception to the normal, prior minor version-only, upgrade simplifies the upgrade procedure for customers on older releases. The following upgrade paths are supported for Red Hat Quay 3.11:
-
3.9.z
3.11.z -
3.10.z
3.11.z
Upgrading from 3.8.z to 3.11 is unsupported. Users must first upgrade to 3.9 or 3.10, and then upgrade to 3.11.
For users wanting to upgrade the Red Hat Quay Operator, see Upgrading the Red Hat Quay Operator Overview.
This document describes the steps needed to perform each individual upgrade. Determine your current version and then follow the steps in sequential order, starting with your current version and working up to your desired target version.
See the Red Hat Quay Release Notes for information on features for individual releases.
The general procedure for a manual upgrade consists of the following steps:
- Stop the Quay and Clair containers.
- Backup the database and image storage (optional but recommended).
- Start Clair using the new version of the image.
- Wait until Clair is ready to accept connections before starting the new version of Quay.
3.1. Accessing images
Red Hat Quay image from version 3.4.0 and later are available from registry.redhat.io and registry.access.redhat.com, with authentication set up as described in Red Hat Container Registry Authentication.
3.2. Upgrade to 3.11.z from 3.10.z
3.2.1. Target images
- Quay: registry.redhat.io/quay/quay-rhel8:v3.11.1
- Clair: registry.redhat.io/quay/clair-rhel8:v3.11.1
- PostgreSQL: registry.redhat.io/rhel8/postgresql-13:1-109
- Redis: registry.redhat.io/rhel8/redis-6:1-110
3.3. Upgrade to 3.11.z from 3.9.z
3.3.1. Target images
- Quay: registry.redhat.io/quay/quay-rhel8:v3.11.1
- Clair: registry.redhat.io/quay/clair-rhel8:v3.11.1
- PostgreSQL: registry.redhat.io/rhel8/postgresql-13:1-109
- Redis: registry.redhat.io/rhel8/redis-6:1-110
3.4. Upgrade to 3.10.z from 3.9.z
3.4.1. Target images
- Quay: registry.redhat.io/quay/quay-rhel8:v3.10.0
- Clair: registry.redhat.io/quay/clair-rhel8:v3.10.0
- PostgreSQL: registry.redhat.io/rhel8/postgresql-13:1-109
- Redis: registry.redhat.io/rhel8/redis-6:1-110
3.5. Upgrade to 3.10.z from 3.8.z
3.5.1. Target images
- Quay: registry.redhat.io/quay/quay-rhel8:v3.10.0
- Clair: registry.redhat.io/quay/clair-rhel8:v3.10.0
- PostgreSQL: registry.redhat.io/rhel8/postgresql-13:1-109
- Redis: registry.redhat.io/rhel8/redis-6:1-110
3.6. Upgrade to 3.10.z from 3.7.z
3.6.1. Target images
- Quay: registry.redhat.io/quay/quay-rhel8:v3.10.0
- Clair: registry.redhat.io/quay/clair-rhel8:v3.10.0
- PostgreSQL: registry.redhat.io/rhel8/postgresql-13:1-109
- Redis: registry.redhat.io/rhel8/redis-6:1-110
