From 2e3e1e9d5deef9e2ca45ffff670c1f7ba696688b Mon Sep 17 00:00:00 2001 From: Steven Smith <77019920+stevsmit@users.noreply.github.com> Date: Fri, 18 Oct 2024 14:26:24 -0400 Subject: [PATCH] Adds important postgresql note (#1131) Co-authored-by: Steven Smith --- modules/operator-unmanaged-postgres.adoc | 5 +++++ modules/unmanaging-clair-database.adoc | 5 +++++ 2 files changed, 10 insertions(+) diff --git a/modules/operator-unmanaged-postgres.adoc b/modules/operator-unmanaged-postgres.adoc index 8748c0d0e..e5a559684 100644 --- a/modules/operator-unmanaged-postgres.adoc +++ b/modules/operator-unmanaged-postgres.adoc @@ -4,6 +4,11 @@ If you are using an externally managed PostgreSQL database, you must manually enable the `pg_trgm` extension for a successful deployment. +[IMPORTANT] +==== +You must not use the same externally managed PostgreSQL database for both {productname} and Clair deployments. Your PostgreSQL database must also not be shared with other workloads, as it might exhaust the natural connection limit on the PostgreSQL side when connection-intensive workloads, like {productname} or Clair, contend for resources. Additionally, pgBouncer is not supported with {productname} or Clair, so it is not an option to resolve this issue. +==== + Use the following procedure to deploy an existing PostgreSQL database. .Procedure diff --git a/modules/unmanaging-clair-database.adoc b/modules/unmanaging-clair-database.adoc index 99929ee33..1d2acd13b 100644 --- a/modules/unmanaging-clair-database.adoc +++ b/modules/unmanaging-clair-database.adoc @@ -8,6 +8,11 @@ Use the following procedure to set your Clair database to unmanaged. +[IMPORTANT] +==== +You must not use the same externally managed PostgreSQL database for both {productname} and Clair deployments. Your PostgreSQL database must also not be shared with other workloads, as it might exhaust the natural connection limit on the PostgreSQL side when connection-intensive workloads, like {productname} or Clair, contend for resources. Additionally, pgBouncer is not supported with {productname} or Clair, so it is not an option to resolve this issue. +==== + .Procedure * In the Quay Operator, set the `clairpostgres` component of the `QuayRegistry` custom resource to `managed: false`: