Upgrade Red Hat Quay

1. 3.0.5 → 3.1.3
2. 3.1.3 → 3.2.2
3. 3.2.2 → 3.3.4
4. 3.3.4 → 3.4.z
5. 3.4.z → 3.5.z

Procedure

1. Add "quay-operator/migrate": "true" to the metadata.labels of the QuayEcosystem.

   $ oc edit quayecosystem <quayecosystemname>

   metadata:
     labels:
       quay-operator/migrate: "true"

2. Wait for a QuayRegistry to be created with the same metadata.name as your QuayEcosystem. The QuayEcosystem will be marked with the label "quay-operator/migration-complete": "true".
3. After the status.registryEndpoint of the new QuayRegistry is set, access Red Hat Quay and confirm that all data and settings were migrated successfully.
4. If everything works correctly, you can delete the QuayEcosystem and Kubernetes garbage collection will clean up all old resources.

Procedure

1. Stop the Red Hat Quay container by entering the following command:

   $ sudo podman stop <quay_container_name>

2. Stop the Clair container by running the following command:

   $ sudo podman stop <clair_container_id>

3. Run the following Podman process from SCLOrg’s Data Migration procedure, which allows for data migration from a remote PostgreSQL server:

   $ sudo podman run -d --name <clair_migration_postgresql_database> 1
     -e POSTGRESQL_MIGRATION_REMOTE_HOST=<container_ip_address> \ 2
     -e POSTGRESQL_MIGRATION_ADMIN_PASSWORD=remoteAdminP@ssword \
     -v </host/data/directory:/var/lib/pgsql/data:Z> \ 3
     [ OPTIONAL_CONFIGURATION_VARIABLES ]
     registry.redhat.io/rhel8/postgresql-15

   1

   Insert a name for your Clair PostgreSQL 15 migration database.

   2

   Your new Clair PostgreSQL 15 database container IP address. Can obtained by running the following command: sudo podman inspect -f "{{.NetworkSettings.IPAddress}}" postgresql-quay.

   3

   You must specify a different volume mount point than the one from your initial Clair PostgreSQL 13 deployment, and modify the access control lists for said directory. For example:

   $ mkdir -p /host/data/clair-postgresql15-directory

   $ setfacl -m u:26:-wx /host/data/clair-postgresql15-directory

   This prevents data from being overwritten by the new container.

4. Stop the Clair PostgreSQL 13 container:

   $ sudo podman stop <clair_postgresql13_container_name>

5. After completing the PostgreSQL migration, run the Clair PostgreSQL 15 container, using the new data volume mount from Step 3, for example, </host/data/clair-postgresql15-directory:/var/lib/postgresql/data>:

   $ sudo podman run -d --rm --name <postgresql15-clairv4> \
     -e POSTGRESQL_USER=<clair_username> \
     -e POSTGRESQL_PASSWORD=<clair_password> \
    	-e POSTGRESQL_DATABASE=<clair_database_name> \
     -e POSTGRESQL_ADMIN_PASSWORD=<admin_password> \
     -p 5433:5432 \
     -v </host/data/clair-postgresql15-directory:/var/lib/postgresql/data:Z> \
       registry.redhat.io/rhel8/postgresql-15

6. Start the Red Hat Quay container by entering the following command:

   $ sudo podman run -d --rm -p 80:8080 -p 443:8443 --name=quay \
   -v /home/<quay_user>/quay-poc/config:/conf/stack:Z \
   -v /home/<quay_user>/quay-poc/storage:/datastorage:Z \
   {productrepo}/{quayimage}:{productminv}

7. Start the Clair container by entering the following command:

   $ sudo podman run -d --name clairv4 \
   -p 8081:8081 -p 8088:8088 \
   -e CLAIR_CONF=/clair/config.yaml \
   -e CLAIR_MODE=combo \
   registry.redhat.io/quay/clair-rhel8:{productminv}