Merge branch 'main' into CR-31145-onprem-2-9-document-changes-in-mongodb-schema

Author: masontikhonov

README.md

@@ -204,14 +204,21 @@ helm show values codefresh/codefresh
 
 ### Persistent services
 
-The following table displays the list of **persistent** services created as part of the on-premises installation:
+Codefresh relies on several persistent services to store its data:
 
-| Database      | Purpose | Required version     |
-| :---        | :----   |  :--- |
-| MongoDB      | Stores all account data (account settings, users, projects, pipelines, builds etc.)       | 7.x   |
-| Postgresql   | Stores data about events for the account (pipeline updates, deletes, etc.). The audit log uses the data from this database.        | 16.x or 17.x      |
-| Redis   | Used for caching, and as a key-value store for cron trigger manager.        | 7.0.x      |
-| RabbitMQ  | Used for message queueing.        | 3.13 \| 4.0.x      |
+- **MongoDB**: Stores all account data (account settings, users, projects, pipelines, builds etc.)
+- **PostgreSQL**: Stores data about events for the account (pipeline updates, deletes, etc.). The audit log uses the data from this database.
+- **Redis**: Used for caching, and as a key-value store for cron trigger manager.
+- **RabbitMQ**: Used for message queueing.
+
+The following table reflects the recommended and supported versions of these databases for different Codefresh releases:
+
+| Codefresh version | MongoDB | PostgreSQL | Redis | RabbitMQ |
+| :---              | :---    | :---       | :---  | :---     |
+| 2.9.x             | \>=4.2 \<=7.x <br> Recommended: 7.x (`featureCompatibilityVersion: 7.0`)| \>= 16.x \<= 17.x <br> Recommended: 17.x | \>= 7.0.x \<= 7.4.x <br> Recommended: 7.4.x | 3.13.x \| 4.0.x \| 4.1.x <br> Recommended: 4.1.x |
+| 2.8.x             | \>=4.2 \<=7.x <br> Recommended: 7.x (`featureCompatibilityVersion: 6.0`)| \>= 13.x \<= 17.x <br> Recommended: 16.x \| 17.x | \>= 7.0.x \<= 7.4.x <br> Recommended: 7.4.x | 3.13.x \| 4.0.x \| 4.1.x <br> Recommended: 4.0.x |
+| 2.7.x             | \>=4.2 \<=6.x <br> Recommended: 6.x (`featureCompatibilityVersion: 6.0`)| 13.x | 7.0.x | 3.13.x |
+| 2.6.x             | \>=4.2 \<=6.x <br> Recommended: 6.x (`featureCompatibilityVersion: 5.0`)| 13.x | 7.0.x | 3.13.x |
 
 > Running on netfs (nfs, cifs) is not recommended.
 
@@ -2372,6 +2379,13 @@ For built-in RabbitMQ `bitnami/rabbitmq` subchart, pre-upgrade hook was added to
 
 ### To 2-9-0
 
+> [!WARNING]
+> **BREAKING CHANGES**
+>
+> Default DinD image has been upgraded to 28.x, which removes support for pushing and pulling with legacy image manifest v2 schema 1 ([ref](https://docs.docker.com/engine/deprecated/#pushing-and-pulling-with-image-manifest-v2-schema-1)).
+>
+> Before upgrading Codefresh, please follow the instruction in [this doc](https://codefresh.io/docs/docs/kb/articles/upgrade-deprecated-docker-images/) to identify deprecated images, upgrade them, and then proceed with upgrading the platform.
+
 ####  Affected values
 
 - `.Values.runner` is removed

README.md.gotmpl

@@ -205,14 +205,21 @@ helm show values codefresh/codefresh
 
 ### Persistent services
 
-The following table displays the list of **persistent** services created as part of the on-premises installation:
+Codefresh relies on several persistent services to store its data:
 
-| Database      | Purpose | Required version     |
-| :---        | :----   |  :--- |
-| MongoDB      | Stores all account data (account settings, users, projects, pipelines, builds etc.)       | 7.x   |
-| Postgresql   | Stores data about events for the account (pipeline updates, deletes, etc.). The audit log uses the data from this database.        | 16.x or 17.x      |
-| Redis   | Used for caching, and as a key-value store for cron trigger manager.        | 7.0.x      |
-| RabbitMQ  | Used for message queueing.        | 3.13 \| 4.0.x      |
+- **MongoDB**: Stores all account data (account settings, users, projects, pipelines, builds etc.)
+- **PostgreSQL**: Stores data about events for the account (pipeline updates, deletes, etc.). The audit log uses the data from this database.
+- **Redis**: Used for caching, and as a key-value store for cron trigger manager.
+- **RabbitMQ**: Used for message queueing.
+
+The following table reflects the recommended and supported versions of these databases for different Codefresh releases:
+
+| Codefresh version | MongoDB | PostgreSQL | Redis | RabbitMQ |
+| :---              | :---    | :---       | :---  | :---     |
+| 2.9.x             | \>=4.2 \<=7.x <br> Recommended: 7.x (`featureCompatibilityVersion: 7.0`)| \>= 16.x \<= 17.x <br> Recommended: 17.x | \>= 7.0.x \<= 7.4.x <br> Recommended: 7.4.x | 3.13.x \| 4.0.x \| 4.1.x <br> Recommended: 4.1.x |
+| 2.8.x             | \>=4.2 \<=7.x <br> Recommended: 7.x (`featureCompatibilityVersion: 6.0`)| \>= 13.x \<= 17.x <br> Recommended: 16.x \| 17.x | \>= 7.0.x \<= 7.4.x <br> Recommended: 7.4.x | 3.13.x \| 4.0.x \| 4.1.x <br> Recommended: 4.0.x |
+| 2.7.x             | \>=4.2 \<=6.x <br> Recommended: 6.x (`featureCompatibilityVersion: 6.0`)| 13.x | 7.0.x | 3.13.x |
+| 2.6.x             | \>=4.2 \<=6.x <br> Recommended: 6.x (`featureCompatibilityVersion: 5.0`)| 13.x | 7.0.x | 3.13.x |
 
 > Running on netfs (nfs, cifs) is not recommended.
 
@@ -2382,6 +2389,13 @@ For built-in RabbitMQ `bitnami/rabbitmq` subchart, pre-upgrade hook was added to
 
 ### To 2-9-0
 
+> [!WARNING]
+> **BREAKING CHANGES**
+> 
+> Default DinD image has been upgraded to 28.x, which removes support for pushing and pulling with legacy image manifest v2 schema 1 ([ref](https://docs.docker.com/engine/deprecated/#pushing-and-pulling-with-image-manifest-v2-schema-1)).
+>
+> Before upgrading Codefresh, please follow the instruction in [this doc](https://codefresh.io/docs/docs/kb/articles/upgrade-deprecated-docker-images/) to identify deprecated images, upgrade them, and then proceed with upgrading the platform.
+
 ####  Affected values
 
 - `.Values.runner` is removed