docs: document changes in external services

README.md

@@ -284,6 +284,7 @@ The following table reflects the recommended and supported versions of these dat
 
 | Codefresh version | MongoDB | PostgreSQL | Redis | RabbitMQ | Nats | Consul |
 | :---              | :---    | :---       | :---  | :---     | :--- | :---   |
+| 2.11.x            | \>=4.2 \<=7.x <br> Recommended: 7.x (`featureCompatibilityVersion: 7.0`)| \>= 16.x \<= 17.x <br> Recommended: 17.x | \>= 7.x \<= 8.x <br> Recommended: 8\.x | 3.13.x \| 4.0.x \| 4.1.x <br> Recommended: 4.1.x | 2.11.x <br> Recommended: 2.11.x | 1.21.x <br> Recommended: 1.21.x |
 | 2.10.x            | \>=4.2 \<=7.x <br> Recommended: 7.x (`featureCompatibilityVersion: 7.0`)| \>= 16.x \<= 17.x <br> Recommended: 17.x | \>= 7.x \<= 8.x <br> Recommended: 8\.x | 3.13.x \| 4.0.x \| 4.1.x <br> Recommended: 4.1.x | 2.11.x <br> Recommended: 2.11.x | 1.21.x <br> Recommended: 1.21.x |
 | 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.11.x <br> Recommended: 2.11.x | 1.21.x <br> Recommended: 1.21.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.11.x <br> Recommended: 2.11.x | 1.21.x <br> Recommended: 1.21.x |
@@ -317,6 +318,9 @@ To use external services like [MongoDB Atlas Database](https://www.mongodb.com/a
 > Ref: <br>
 > [Create Users in Atlas](https://www.mongodb.com/docs/atlas/security-add-mongodb-users/#configure-database-users)
 
+> [!IMPORTANT]
+> By default, Zstd network compression is enabled in Codefresh for MongodDB. Please ensure that Zstd compression is supported and enabled on your MongoDB server. If you'd like to opt out, you can disable it via `.Values.global.env.MONGO_ENABLE_ZSTD_NETWORK_COMPRESSION=false`. Disabling compression is not recommended however, as it may significantly increase amount of traffic and corresponding costs.
+
 `values.yaml` for external MongoDB:
 
 ```yaml
@@ -2632,6 +2636,10 @@ Changes in collections: following collections can be safely dropped *after* the
 - Support for New Relic instrumentation is discontinued and disabled by default via `.Values.global.env.NEW_RELIC_ENABLED=false`. If you are relying on New Relic for monitoring, please reach out to Support team for alternatives.
 - Zstd compression is enabled by default for MongoDB traffic. Please ensure that Zstd compression is supported and enabled on your MongoDB server. If you'd like to opt out, you can disable it via `.Values.global.env.MONGO_ENABLE_ZSTD_NETWORK_COMPRESSION=false`.
 
+#### Changes in MongoDB schema:
+
+- Changes in indexes: follow [Maintaining MongoDB indexes](#maintaining-mongodb-indexes) guide to meet index requirements *before* the upgrade process.
+
 ## Troubleshooting
 
 ### Error: Failed to validate connection to Docker daemon; caused by Error: certificate has expired

README.md.gotmpl

@@ -286,6 +286,7 @@ The following table reflects the recommended and supported versions of these dat
 
 | Codefresh version | MongoDB | PostgreSQL | Redis | RabbitMQ | Nats | Consul |
 | :---              | :---    | :---       | :---  | :---     | :--- | :---   |
+| 2.11.x            | \>=4.2 \<=7.x <br> Recommended: 7.x (`featureCompatibilityVersion: 7.0`)| \>= 16.x \<= 17.x <br> Recommended: 17.x | \>= 7.x \<= 8.x <br> Recommended: 8\.x | 3.13.x \| 4.0.x \| 4.1.x <br> Recommended: 4.1.x | 2.11.x <br> Recommended: 2.11.x | 1.21.x <br> Recommended: 1.21.x |
 | 2.10.x            | \>=4.2 \<=7.x <br> Recommended: 7.x (`featureCompatibilityVersion: 7.0`)| \>= 16.x \<= 17.x <br> Recommended: 17.x | \>= 7.x \<= 8.x <br> Recommended: 8\.x | 3.13.x \| 4.0.x \| 4.1.x <br> Recommended: 4.1.x | 2.11.x <br> Recommended: 2.11.x | 1.21.x <br> Recommended: 1.21.x |
 | 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.11.x <br> Recommended: 2.11.x | 1.21.x <br> Recommended: 1.21.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.11.x <br> Recommended: 2.11.x | 1.21.x <br> Recommended: 1.21.x |
@@ -319,6 +320,9 @@ To use external services like [MongoDB Atlas Database](https://www.mongodb.com/a
 > Ref: <br>
 > [Create Users in Atlas](https://www.mongodb.com/docs/atlas/security-add-mongodb-users/#configure-database-users)
 
+> [!IMPORTANT]
+> By default, Zstd network compression is enabled in Codefresh for MongodDB. Please ensure that Zstd compression is supported and enabled on your MongoDB server. If you'd like to opt out, you can disable it via `.Values.global.env.MONGO_ENABLE_ZSTD_NETWORK_COMPRESSION=false`. Disabling compression is not recommended however, as it may significantly increase amount of traffic and corresponding costs.
+
 `values.yaml` for external MongoDB:
 
 ```yaml
@@ -2647,6 +2651,10 @@ Changes in collections: following collections can be safely dropped *after* the
 - Support for New Relic instrumentation is discontinued and disabled by default via `.Values.global.env.NEW_RELIC_ENABLED=false`. If you are relying on New Relic for monitoring, please reach out to Support team for alternatives.
 - Zstd compression is enabled by default for MongoDB traffic. Please ensure that Zstd compression is supported and enabled on your MongoDB server. If you'd like to opt out, you can disable it via `.Values.global.env.MONGO_ENABLE_ZSTD_NETWORK_COMPRESSION=false`.
 
+#### Changes in MongoDB schema:
+
+- Changes in indexes: follow [Maintaining MongoDB indexes](#maintaining-mongodb-indexes) guide to meet index requirements *before* the upgrade process.
+
 
 ## Troubleshooting
 

indexes/read-models/applications.json

@@ -0,0 +1,214 @@
+[
+  {
+    "key": {
+      "projects": 1
+    }
+  },
+  {
+    "key": {
+      "referencedBy.name": 1
+    }
+  },
+  {
+    "key": {
+      "references.name": 1
+    }
+  },
+  {
+    "key": {
+      "metadata.name": 1
+    }
+  },
+  {
+    "key": {
+      "metadata.labels": 1
+    }
+  },
+  {
+    "key": {
+      "metadata.accountId": 1
+    }
+  },
+  {
+    "key": {
+      "source.syncStartedAt": 1
+    }
+  },
+  {
+    "key": {
+      "__passiveReferencedBy.name": 1
+    }
+  },
+  {
+    "key": {
+      "__passiveReferencedBy.name": 1,
+      "__passiveReferencedBy.kind": 1,
+      "__passiveReferencedBy.namespace": 1,
+      "__passiveReferencedBy.group": 1,
+      "__passiveReferencedBy.version": 1
+    }
+  },
+  {
+    "key": {
+      "__passiveReferences.name": 1
+    }
+  },
+  {
+    "key": {
+      "__passiveReferences.name": 1,
+      "__passiveReferences.kind": 1,
+      "__passiveReferences.namespace": 1,
+      "__passiveReferences.group": 1,
+      "__passiveReferences.version": 1
+    }
+  },
+  {
+    "key": {
+      "__inferredReferencedBy.name": 1
+    }
+  },
+  {
+    "key": {
+      "__inferredReferencedBy.name": 1,
+      "__inferredReferencedBy.kind": 1,
+      "__inferredReferencedBy.namespace": 1,
+      "__inferredReferencedBy.group": 1,
+      "__inferredReferencedBy.version": 1
+    }
+  },
+  {
+    "key": {
+      "__inferredReferences.name": 1
+    }
+  },
+  {
+    "key": {
+      "__inferredReferences.name": 1,
+      "__inferredReferences.kind": 1,
+      "__inferredReferences.namespace": 1,
+      "__inferredReferences.group": 1,
+      "__inferredReferences.version": 1
+    }
+  },
+  {
+    "key": {
+      "createdAt": 1
+    }
+  },
+  {
+    "key": {
+      "updatedAt": 1
+    },
+    "collation": {
+      "locale": "en_US",
+      "caseLevel": false,
+      "caseFirst": "off",
+      "strength": 1,
+      "numericOrdering": false,
+      "alternate": "non-ignorable",
+      "maxVariable": "punct",
+      "normalization": false,
+      "backwards": false
+    }
+  },
+  {
+    "key": {
+      "favorites": 1
+    },
+    "collation": {
+      "locale": "en_US",
+      "caseLevel": false,
+      "caseFirst": "off",
+      "strength": 1,
+      "numericOrdering": false,
+      "alternate": "non-ignorable",
+      "maxVariable": "punct",
+      "normalization": false,
+      "backwards": false
+    }
+  },
+  {
+    "key": {
+      "source.gitSource": 1
+    },
+    "collation": {
+      "locale": "en_US",
+      "caseLevel": false,
+      "caseFirst": "off",
+      "strength": 1,
+      "numericOrdering": false,
+      "alternate": "non-ignorable",
+      "maxVariable": "punct",
+      "normalization": false,
+      "backwards": false
+    }
+  },
+  {
+    "key": {
+      "metadata.accountId": 1,
+      "metadata.runtime": 1,
+      "metadata.cluster": 1,
+      "metadata.namespace": 1,
+      "metadata.group": 1,
+      "metadata.version": 1,
+      "metadata.kind": 1,
+      "metadata.name": 1
+    },
+    "unique": true,
+    "collation": {
+      "locale": "en_US",
+      "caseLevel": false,
+      "caseFirst": "off",
+      "strength": 1,
+      "numericOrdering": false,
+      "alternate": "non-ignorable",
+      "maxVariable": "punct",
+      "normalization": false,
+      "backwards": false
+    }
+  },
+  {
+    "key": {
+      "source.gitSourceUID": 1
+    },
+    "collation": {
+      "locale": "en_US",
+      "caseLevel": false,
+      "caseFirst": "off",
+      "strength": 1,
+      "numericOrdering": false,
+      "alternate": "non-ignorable",
+      "maxVariable": "punct",
+      "normalization": false,
+      "backwards": false
+    }
+  },
+  {
+    "key": {
+      "source.gitSourceNamespace": 1
+    },
+    "collation": {
+      "locale": "en_US",
+      "caseLevel": false,
+      "caseFirst": "off",
+      "strength": 1,
+      "numericOrdering": false,
+      "alternate": "non-ignorable",
+      "maxVariable": "punct",
+      "normalization": false,
+      "backwards": false
+    }
+  },
+  {
+    "key": {
+      "_id": 1
+    }
+  },
+  {
+    "key": {
+      "__inferredReferencedBy.kind": 1,
+      "__inferredReferencedBy.name": 1,
+      "metadata.accountId": 1
+    }
+  }
+]