From 77aa119f81024c8055b510b6833608e0025d1aac Mon Sep 17 00:00:00 2001 From: Muslim Al Ali Date: Mon, 8 Sep 2025 13:12:02 +0200 Subject: [PATCH 1/5] Updating secret management page Adding more information regarding the secret limits in the cloud portal. --- .../project-features/secrets-management.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md b/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md index 1d1fed02fd1..7d3c925c601 100644 --- a/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md +++ b/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md @@ -37,6 +37,21 @@ Starter Plans have a limit of 5 secrets per environment, whereas higher-tiered p When adding a secret to your environment it will restart. {% endhint %} +{% hint style="warning" %} + +## Important + +Secrets are stored as environment variables in your project. +The underlying platform has a maximum size limit for all environment variables combined. +If too many secrets are added, or if secret values are very large, your project may fail to start. + +We Recommend: + +- Keeping secrets small and concise. +- Storing only sensitive values as secrets (e.g. API keys, connection strings). +- Using appsettings.json for general configuration values. +{% endhint %} + To add a secret to your environment follow these steps: 1. Go to your Umbraco Cloud project From d491cea83c1e16d137fd071992ed0a9a2e356726 Mon Sep 17 00:00:00 2001 From: Muslim Al Ali Date: Mon, 8 Sep 2025 13:17:48 +0200 Subject: [PATCH 2/5] resolving valve hints checks failed because of a specific word - so I changed it --- .../project-features/secrets-management.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md b/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md index 7d3c925c601..1ebc024e60a 100644 --- a/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md +++ b/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md @@ -43,7 +43,7 @@ When adding a secret to your environment it will restart. Secrets are stored as environment variables in your project. The underlying platform has a maximum size limit for all environment variables combined. -If too many secrets are added, or if secret values are very large, your project may fail to start. +If too many secrets are added, or if secret values are too large, your project may fail to start. We Recommend: From 61a3f76525455fcf83e13ba63ff0eab1a0fad03d Mon Sep 17 00:00:00 2001 From: Muslim Al Ali Date: Mon, 8 Sep 2025 13:20:34 +0200 Subject: [PATCH 3/5] secretes management page resolving more issues from vale checks --- .../project-features/secrets-management.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md b/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md index 1ebc024e60a..a534ef68183 100644 --- a/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md +++ b/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md @@ -48,7 +48,7 @@ If too many secrets are added, or if secret values are too large, your project m We Recommend: - Keeping secrets small and concise. -- Storing only sensitive values as secrets (e.g. API keys, connection strings). +- Storing only sensitive values as secrets (for example: API keys, connection strings). - Using appsettings.json for general configuration values. {% endhint %} From 2fdea6a121d3a45b9f92ae2641aadc40928fd0d9 Mon Sep 17 00:00:00 2001 From: Muslim Al Ali Date: Mon, 8 Sep 2025 13:57:24 +0200 Subject: [PATCH 4/5] updating secret management page refactoring merging lines together and cleaning up a bit. --- .../project-features/secrets-management.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md b/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md index a534ef68183..61d2937bf50 100644 --- a/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md +++ b/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md @@ -33,17 +33,15 @@ Starter Plans have a limit of 5 secrets per environment, whereas higher-tiered p ## How to add secrets -{% hint style="warning" %} -When adding a secret to your environment it will restart. -{% endhint %} - {% hint style="warning" %} ## Important -Secrets are stored as environment variables in your project. +When adding a secret to your environment, it will restart. + +Secrets are stored as environment variables. The underlying platform has a maximum size limit for all environment variables combined. -If too many secrets are added, or if secret values are too large, your project may fail to start. +If too many secrets are added, or if secret values are too large, your environment may fail to start. We Recommend: @@ -52,7 +50,7 @@ We Recommend: - Using appsettings.json for general configuration values. {% endhint %} -To add a secret to your environment follow these steps: +To add a secret to your environment, follow these steps: 1. Go to your Umbraco Cloud project 2. Go to the Settings section and go to Secret Management From 98f7f93ac4dec8fc35e025e1e985cf1c2debef72 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Tue, 9 Sep 2025 08:50:07 +0200 Subject: [PATCH 5/5] Update umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md --- .../project-features/secrets-management.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md b/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md index 61d2937bf50..82ada5efd1b 100644 --- a/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md +++ b/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management.md @@ -43,11 +43,11 @@ Secrets are stored as environment variables. The underlying platform has a maximum size limit for all environment variables combined. If too many secrets are added, or if secret values are too large, your environment may fail to start. -We Recommend: +It is recommended to: -- Keeping secrets small and concise. -- Storing only sensitive values as secrets (for example: API keys, connection strings). -- Using appsettings.json for general configuration values. +- Keep secrets small and concise. +- Store only sensitive values as secrets (for example: API keys, connection strings). +- Use `appsettings.json` for general configuration values. {% endhint %} To add a secret to your environment, follow these steps: