Stackit changes by Nidhi251289 · Pull Request #11208 · mendix/docs

Nidhi251289 · 2026-05-18T15:08:38Z

Stack it changes

katarzyna-koltun-mx

Reviewed and waiting for the go ahead.

walkline · 2026-05-21T11:42:24Z

+| User                | Username for the registry robot account                                                        |
+| Password            | Token (password) for the robot account                                                         |
+
+Before pushing images to container registry, you must first create the repository.


I think repositories automatically created when pushing to them.

@walkline https://mendix.slack.com/archives/C0B2Y7ZQ3K4/p1778569861394009
here, gauarav created the registry before
and then u were able to use it

fixed. Replaced repository with registry

walkline · 2026-05-21T11:47:51Z

+Example:
+
+   ```shell
+   kubectl patch serviceaccount default -n <namespace> -p '{"imagePullSecrets": [{"name": "<secret-name>"}]}'


Maybe we should mention somewhere that mxpc-cli or the Helm chart will create a secret with the registry credentials, so they can use that secret. Usually, the secret has a name similar to this: mendix-generic-registry-secret.

walkline · 2026-05-21T11:53:26Z

 If your provider is Azure, [Postgres managed identity authentication](#database-postgres-azwi) can be used instead to increase security.

+{{% alert color="info" %}}
+The Mendix on-demand PostgreSQL provisioner cannot be used directly. STACKIT PostgreSQL Flex does not expose the `CREATEROLE` privilege, which is necessary for Mendix to automatically create database users with SQL commands. In order to facilitate the use of Postgres, switch to [JDBC plan](#database-jdbc) and create a dedicated database user for the new Mendix environment using the STACKIT CLI or API.


Maybe we should add something like this at the beginning: This limitation applies only to STACKIT PostgreSQL Flex databases. Because Reading just the first santace can lead to a false impression.

walkline · 2026-05-21T11:57:31Z

+
+#### Prerequisites
+
+* A Ceph or S3-compatible bucket.


Why are we mentioning Ceph storage here (and several lines below)? I only tested the S3-compatible interface for STACKIT Object Storage.

This was already there
I just moved ceph storage in next section

walkline · 2026-05-21T12:02:15Z

+
+#### Configuring the Plan
+
+In the Ceph plan configuration, enter the following details:


Ceph not needed here?

walkline · 2026-05-21T12:08:14Z

 {{% /alert %}}

+{{% alert color="info" %}}
+The Mendix on-demand PostgreSQL provisioner cannot be used directly. STACKIT PostgreSQL Flex does not expose the CREATEROLE privilege, which is necessary for Mendix to automatically create database users via SQL commands. Hence, a databaser user needs to be created per environment before deployment.


The same comment: Maybe we should add something like this at the beginning: This limitation applies only to STACKIT PostgreSQL Flex databases. Because Reading just the first santace can lead to a false impression.

…n' into stackItdocumentation emote commit for stackit

walkline

Looks good to me, thanks!

katarzyna-koltun-mx · 2026-05-21T13:51:50Z

On hold until June, waiting for the go ahead

MXClyde

Review Summary

Thank you for adding STACKIT support documentation. This is a great addition. However, the changes need several revisions before merging.

Findings:

MUST FIX: Brand-name casing throughout: "STACKIT" (not "Stackit" or "StackIt"), "STACKIT Kubernetes Engine", "STACKIT PostgreSQL Flex", "STACKIT Container Registry", "STACKIT Object Storage". STACKIT is consistently rendered all-caps in their own brand and product naming.
MUST FIX: The release note entry is too thin and underspecified — readers learn nothing about scope, prerequisites, or the SKE-specific limitations that already exist elsewhere in this PR. I've suggested a complete rewrite that surfaces those limitations and links into the relevant sections.
MUST FIX: Duplicate field list in the STACKIT Object Storage configuration section (private-cloud-storage-plans.md).
SHOULD FIX: Several grammar/typo issues in the new prose (fail to start the and deployment, By creating dedicated bucket for all the environment, double-space option and the bucket).
SHOULD FIX: Add an explicit "unmanaged" statement to the SKE entry
SHOULD FIX: Add a Kubernetes-version statement for SKE (any SKE-offered version within our supported range).
SHOULD FIX: Whitespace-only reindent of the unrelated gcloud block in private-cloud-registry.md should be reverted — it pulls the fenced block out of its list-item indentation and is unrelated to STACKIT.
SHOULD FIX: Trailing whitespace in the new STACKIT registry table (private-cloud-registry.md).
PENDING (please clarify): The /metrics line removal in private-cloud-license-manager.md looks unrelated to STACKIT. Either revert, or split into a separate PR with a rationale.

See inline comments for the specific edits.

MXClyde · 2026-06-02T14:19:41Z

+### May 20, 2026
+
+#### StackIt support
+


MUST FIX (casing): Change StackIt support to STACKIT Support. STACKIT's own brand and product naming uses all-caps consistently.

MXClyde · 2026-06-02T14:19:41Z

+#### StackIt support
+
+* We now officially support app deployments in Stackit kubernetes environments.
+


MUST FIX (casing): Stackit kubernetes environments should be STACKIT Kubernetes Engine — both "STACKIT" and the product name "Kubernetes Engine" need correct capitalization.

MXClyde · 2026-06-02T14:19:41Z

+#### StackIt support
+
+* We now officially support app deployments in Stackit kubernetes environments.
+


MUST FIX (rewrite): This release note is too thin. It doesn't tell readers what's actually supported, what the limitations are, or where to find configuration details — and it omits the SKE-specific caveats that this same PR adds elsewhere. Please replace the heading + bullet with the following:

### STACKIT Kubernetes Engine Support Mendix on Kubernetes now supports deployment to STACKIT Kubernetes Engine (SKE). See [Supported Environments](/developerportal/deploy/private-cloud-supported-environments/#supported-clusters) for details. **Limitations:** - STACKIT PostgreSQL Flex requires JDBC plan (CREATEROLE not exposed) - STACKIT Object Storage requires manual bucket and user creation - Container registry repositories must be created before pushing images For configuration details, see [Storage Plans](/developerportal/deploy/private-cloud-cluster/private-cloud-storage-plans/#stackit-object-storage) and [Container Registry](/developerportal/deploy/private-cloud-cluster/private-cloud-registry/#stackit-container-registry).

MXClyde · 2026-06-02T14:19:41Z

 * [Google Cloud SQL for PostgreSQL](https://cloud.google.com/sql/docs/postgres).
 * [Amazon RDS Aurora for PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.AuroraPostgreSQL.html)
+* [Stackit Postgres Flex](https://stackit.com/en/products/database/stackit-postgresql-flex)



MUST FIX (casing): Stackit Postgres Flex should be STACKIT PostgreSQL Flex — matches both STACKIT's brand casing and their own product naming (PostgreSQL, not Postgres).

MXClyde · 2026-06-02T14:19:42Z

 * [Google Cloud Platform](https://cloud.google.com/)
 * [Google Kubernetes Engine- Autopilot](https://cloud.google.com/kubernetes-engine/docs/concepts/autopilot-overview). For more information, see [Mendix on Kubernetes Cluster: GKE Autopilot Workarounds](/developerportal/deploy/private-cloud-cluster/#gke-autopilot-workarounds)
+* [STACKIT Kubernetes Engine](https://stackit.com/en/products/runtime/stackit-kubernetes-engine)



SHOULD FIX (clarity — add unmanaged statement): STACKIT is unmanaged on our side — customers self-provision the cluster and dependencies. Please add the following sentence after the SKE bullet so readers understand the scope up front:

For STACKIT Kubernetes Engine, customers provision the SKE cluster, PostgreSQL Flex database(s), and Object Storage bucket(s) themselves before deploying Mendix.

MXClyde · 2026-06-02T14:19:42Z

+* **Access Key** and **Secret Key** - The credentials for the environment user account.
+* **Autogenerate prefix** - Leave it empty
+* **Share bucket between environments** - Specifies if the bucket can be shared between environments (create an on-demand storage plan); Enable this option and  the bucket will be shared between multiple environments. 
+


SHOULD FIX (whitespace): Enable this option and the bucket will be shared has a double space between and and the. Please collapse to a single space.

MXClyde · 2026-06-02T14:19:42Z

+            --member "serviceAccount:PROJECT_ID.svc.id.goog[K8S_NAMESPACE/KSA_NAME]" \
+            GSA_NAME@PROJECT_ID.iam.gserviceaccount.com
+        ```



SHOULD FIX (unrelated whitespace change): The gcloud fenced block (positions 13–24 of this hunk) has been re-indented from 4 spaces to 8 spaces. This is unrelated to STACKIT support and pulls the code block out of its list-item indentation context, which can affect rendering. Please revert the whitespace change in this block.

MXClyde · 2026-06-02T14:19:42Z

+| Push URL            | registry.onstackit.cloud                                                                       |
+| Pull URL            | registry.onstackit.cloud                                                                       |         
+| Registry name       | `<stackitregistry>/<repository>`, where `<stackitregistry>` is the registry created in stackit |
+| With authentication | enabled                                                                                        |


SHOULD FIX (grammar + casing): where <stackitregistry> is the registry created in stackit → where <stackitregistry> is the registry you created in STACKIT.

MXClyde · 2026-06-02T14:19:42Z

+| ------------------- | -----------------------------------------------------------------------------------------------|
+| Push URL            | registry.onstackit.cloud                                                                       |
+| Pull URL            | registry.onstackit.cloud                                                                       |         
+| Registry name       | `<stackitregistry>/<repository>`, where `<stackitregistry>` is the registry created in stackit |


SHOULD FIX (formatting): This row of the new STACKIT registry table has trailing whitespace after the closing |. Please clean up trailing whitespace across the table rows for consistency.

MXClyde · 2026-06-02T14:19:42Z


 * `http<s>://pclm.<domain>/health` should return `HTTP 200 OK`
-* `https<s>://pclm.<domain>/metrics` should return `HTTP 200 OK` together with the collected server metrics
+


PENDING (please clarify): Was this /metrics line removal intentional? It seems unrelated to STACKIT support. Please revert if unintentional, or move to a separate PR with a rationale if it was deliberate.

@MXClyde for PENDING (please clarify): The /metrics line removal in private-cloud-license-manager.md looks unrelated to STACKIT. Either revert, or split into a separate PR with a rationale.

yes, the change was minimal, so thought of specifying it in the same PR. We dont have metrics endpoint for PCLM anymore.

Nidhi251289 · 2026-06-02T14:24:52Z

@katarzyna-koltun-mx can u please incorporate above changes from Clyde

MXClyde · 2026-06-02T14:36:50Z

Proposed Fixes Available

@katarzyna-koltun-mx For your convenience, I've applied all the review fixes in a separate PR that targets mendix/docs:development directly:

→ #11290

You can review the changes there and, if they look good, this PR (#11208) can be closed in favor of the new one. This includes:

✅ All STACKIT casing standardized to all-caps
✅ Release note rewritten with limitations and links
✅ Unmanaged provisioning description added
✅ Kubernetes version statement added
✅ Duplicate field list removed
✅ Grammar/typo fixes
✅ Unrelated changes reverted (gcloud whitespace, /metrics removal)

Feel free to cherry-pick specific commits or merge the whole thing. Let me know if you have questions!

Nidhi251289 added 2 commits May 18, 2026 17:08

Stackit changes

f1e92b7

command for patching service account added

f62abc6

MariaShaposhnikova assigned katarzyna-koltun-mx May 19, 2026

MariaShaposhnikova requested a review from katarzyna-koltun-mx May 19, 2026 12:32

katarzyna-koltun-mx added 7 commits May 20, 2026 10:09

Update _index.md

f79ef99

Update private-cloud-registry.md

b2ac848

Correct casing for STACKIT container registry

e9c055d

Update _index.md

fc99974

Update private-cloud-storage-plans.md

439b709

Update private-cloud-supported-environments.md

ebd1572

Update private-cloud-supported-environments.md

329cdf3

katarzyna-koltun-mx approved these changes May 20, 2026

View reviewed changes

removed the metrics endpoint for PCLM

ba2e675

walkline reviewed May 21, 2026

View reviewed changes

Nidhi251289 added 2 commits May 21, 2026 14:31

Merge remote-tracking branch 'refs/remotes/origin/stackItdocumentatio…

09c9a5f

…n' into stackItdocumentation emote commit for stackit

Antons feedback

daeb398

walkline approved these changes May 21, 2026

View reviewed changes

MXClyde suggested changes Jun 2, 2026

View reviewed changes

MXClyde mentioned this pull request Jun 2, 2026

Fix STACKIT documentation issues from review Nidhi251289/docs#2

Closed

7 tasks

MXClyde mentioned this pull request Jun 2, 2026

Fix STACKIT documentation issues #11290

Open

7 tasks


		#### Configuring the Plan

		In the Ceph plan configuration, enter the following details:

		#### StackIt support

		* We now officially support app deployments in Stackit kubernetes environments.


		* `http<s>://pclm.<domain>/health` should return `HTTP 200 OK`
		* `https<s>://pclm.<domain>/metrics` should return `HTTP 200 OK` together with the collected server metrics

Conversation

Nidhi251289 commented May 18, 2026

Uh oh!

katarzyna-koltun-mx left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

walkline left a comment

Choose a reason for hiding this comment

Uh oh!

katarzyna-koltun-mx commented May 21, 2026

Uh oh!

MXClyde left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Review Summary

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

MXClyde Jun 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Nidhi251289 commented Jun 2, 2026

Uh oh!

MXClyde commented Jun 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Proposed Fixes Available

MXClyde left a comment •

edited

Loading

MXClyde Jun 2, 2026 •

edited

Loading

MXClyde commented Jun 2, 2026 •

edited

Loading