From ad69362dc5401f96911c952b3e303242db59ba2b Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 13 May 2026 13:58:26 +0000 Subject: [PATCH 1/2] Document GKE cluster name restrictions for reserved substrings Generated-By: mintlify-agent --- cloud-accounts/creating-a-cluster.mdx | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/cloud-accounts/creating-a-cluster.mdx b/cloud-accounts/creating-a-cluster.mdx index 1a4321e..0263680 100644 --- a/cloud-accounts/creating-a-cluster.mdx +++ b/cloud-accounts/creating-a-cluster.mdx @@ -107,6 +107,12 @@ After [connecting your cloud account](/cloud-accounts/connecting-a-cloud-account You can customize these settings or accept the defaults. + + + **GKE cluster name restrictions**: If you customize the cluster name, it must start with a letter, end with a letter or number, and contain only lowercase letters, numbers, and hyphens. It must also **not contain** any of the following substrings: `google`, `g00gle`, `goog`, or `g00g`. + + These substrings are reserved by Google Cloud Storage (GCS) and are blocked in bucket names. Because Porter derives bucket names for cluster-internal storage (for example, Loki logs) from the cluster name, using a reserved substring will cause provisioning to fail. Porter rejects these names up front so you fail fast at cluster creation rather than mid-install. + Click **Provision** to start creating your infrastructure. @@ -120,6 +126,18 @@ After [connecting your cloud account](/cloud-accounts/connecting-a-cloud-account ### Troubleshooting + + GKE cluster names must follow these rules: + + - Start with a lowercase letter + - End with a lowercase letter or number + - Contain only lowercase letters, numbers, and hyphens + - Must **not** contain `google`, `g00gle`, `goog`, or `g00g` (reserved by Google Cloud Storage) + + For example, `prod-cluster` and `rajeev-gke` are valid, but `rajeev-google` or `goog-cluster` are rejected. + + Rename the cluster to something that satisfies the rules above and retry provisioning. + If your cluster has been provisioning for more than 45 minutes: From 386f2a24b59221008c717e9fab705e6473b0e3ab Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 13 May 2026 14:36:44 +0000 Subject: [PATCH 2/2] Revert GKE cluster name restrictions after upstream validation moved to bucket layer Generated-By: mintlify-agent --- cloud-accounts/creating-a-cluster.mdx | 18 ------------------ 1 file changed, 18 deletions(-) diff --git a/cloud-accounts/creating-a-cluster.mdx b/cloud-accounts/creating-a-cluster.mdx index 0263680..1a4321e 100644 --- a/cloud-accounts/creating-a-cluster.mdx +++ b/cloud-accounts/creating-a-cluster.mdx @@ -107,12 +107,6 @@ After [connecting your cloud account](/cloud-accounts/connecting-a-cloud-account You can customize these settings or accept the defaults. - - - **GKE cluster name restrictions**: If you customize the cluster name, it must start with a letter, end with a letter or number, and contain only lowercase letters, numbers, and hyphens. It must also **not contain** any of the following substrings: `google`, `g00gle`, `goog`, or `g00g`. - - These substrings are reserved by Google Cloud Storage (GCS) and are blocked in bucket names. Because Porter derives bucket names for cluster-internal storage (for example, Loki logs) from the cluster name, using a reserved substring will cause provisioning to fail. Porter rejects these names up front so you fail fast at cluster creation rather than mid-install. - Click **Provision** to start creating your infrastructure. @@ -126,18 +120,6 @@ After [connecting your cloud account](/cloud-accounts/connecting-a-cloud-account ### Troubleshooting - - GKE cluster names must follow these rules: - - - Start with a lowercase letter - - End with a lowercase letter or number - - Contain only lowercase letters, numbers, and hyphens - - Must **not** contain `google`, `g00gle`, `goog`, or `g00g` (reserved by Google Cloud Storage) - - For example, `prod-cluster` and `rajeev-gke` are valid, but `rajeev-google` or `goog-cluster` are rejected. - - Rename the cluster to something that satisfies the rules above and retry provisioning. - If your cluster has been provisioning for more than 45 minutes: