Skip to content

docs: Update K8s multi-cluster API example with tested European regions#2226

Merged
cb-github-robot merged 2 commits intocloud-barista:mainfrom
hanizang77:Multi-K8s-Prov
Nov 27, 2025
Merged

docs: Update K8s multi-cluster API example with tested European regions#2226
cb-github-robot merged 2 commits intocloud-barista:mainfrom
hanizang77:Multi-K8s-Prov

Conversation

@hanizang77
Copy link
Copy Markdown
Contributor

  • Update PostK8sMultiClusterDynamic API example in Swagger documentation
    • AWS (eu-west-2, UK)
    • Azure (germanywestcentral, Germany) with nodeGroupName parameter
    • GCP (europe-west9, France) with nodeGroupName parameter
  • Add nodeGroupName parameter for Azure/GCP to avoid AKS naming constraint
    (Azure AKS requires node pool names ≤12 chars, lowercase+numbers only)

Update PostK8sMultiClusterDynamic API example in Swagger documentation
@hanizang77
Copy link
Copy Markdown
Contributor Author

Successfully deployed 3 K8s clusters across Europe in parallel: AWS (UK), Azure (Germany), GCP (France) - all Active! 🚀

image

Copy link
Copy Markdown
Member

@seokho-son seokho-son left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@hanizang77

and.. what about other CSPs ?

// @Description ```json
// @Description {
// @Description "namePrefix": "across",
// @Description "namePrefix": "eu-cluster",
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
// @Description "namePrefix": "eu-cluster",
// @Description "namePrefix": "across",

The term is based on very intentional selection. :)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@seokho-son

Tested Alibaba and Tencent as well, but ran into some issues in my personal test environment (Alibaba: spec lookup issue, Tencent: IAM role + SecurityGroup setup needed).

Once I resolve my environment issues, I'll test and add more CSPs!

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@hanizang77 Thanks

Could you explain what is the issue Tencent: IAM role + SecurityGroup setup about?
I am facing that issue also. Where can we find a guide regarding it?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@seokho-son

I figured out that Tencent TKE requires the TKE_QCSRole service role.
I just created this role, and since we share the same Tencent account, you should be able to use it without any additional setup.
As far as I know, there is no separate guide for this yet.

image

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@seokho-son

Tencent TKE cluster successfully deployed in Singapore (ap-singapore) region.

image

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@seokho-son,

I've successfully created K8s clusters across Alibaba, Tencent, and NCP as part of the multi-cloud K8s testing.

Current Status:

✅ Alibaba (ACK): Cluster created successfully, showing "Active" status
✅ Tencent (TKE): Cluster created successfully, showing "Active" status
⚠️ NCP (NKS): Cluster created successfully and running normally, but shows "Inactive" status due to a cb-spider driver issue (see: cloud-barista/cb-spider#1612)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@hanizang77
Thanks for sharing. Soon, we will need thorough documentation, especially for K8s provisioning, since it is quite complex.

@seokho-son
Copy link
Copy Markdown
Member

@hanizang77
Let me merge this PR as is. Please provide further enhancement after this PR. :)

@seokho-son
Copy link
Copy Markdown
Member

/approve

@github-actions github-actions bot added the approved This PR is approved and will be merged soon. label Nov 27, 2025
@cb-github-robot cb-github-robot merged commit fa19bc5 into cloud-barista:main Nov 27, 2025
5 checks passed
@hanizang77 hanizang77 deleted the Multi-K8s-Prov branch November 27, 2025 09:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved This PR is approved and will be merged soon.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants