Skip to content

feat: rework flavors explanation#285

Open
l0wl3vel wants to merge 4 commits into
mainfrom
feat/flavors
Open

feat: rework flavors explanation#285
l0wl3vel wants to merge 4 commits into
mainfrom
feat/flavors

Conversation

@l0wl3vel

Copy link
Copy Markdown

Description

Make flavors explanation a bit easier to read

Used AI-Tools ✨

  • none used for generation

@l0wl3vel l0wl3vel requested a review from a team as a code owner June 10, 2026 09:57
@metal-robot metal-robot Bot added the area: documentation Affects the documentation area. label Jun 10, 2026
@l0wl3vel l0wl3vel requested a review from simcod June 10, 2026 09:58
@netlify

netlify Bot commented Jun 10, 2026

Copy link
Copy Markdown

Deploy Preview for metal-stack-io ready!

Name Link
🔨 Latest commit 33e5a72
🔍 Latest deploy log https://app.netlify.com/projects/metal-stack-io/deploys/6a29350a43ceba0009b67590
😎 Deploy Preview https://deploy-preview-285--metal-stack-io.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify

netlify Bot commented Jun 10, 2026

Copy link
Copy Markdown

Deploy Preview for metal-stack-io ready!

Name Link
🔨 Latest commit 0a8a135
🔍 Latest deploy log https://app.netlify.com/projects/metal-stack-io/deploys/6a2a8b9b368416000969ebf7
😎 Deploy Preview https://deploy-preview-285--metal-stack-io.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@simcod simcod left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thank for updating this section! Just some comments and suggestions from my side.

Comment thread docs/02-General/04-flavors-of-metalstack.md Outdated
Comment thread docs/02-General/04-flavors-of-metalstack.md Outdated
Comment thread docs/02-General/04-flavors-of-metalstack.md Outdated
Comment thread docs/02-General/04-flavors-of-metalstack.md Outdated
Comment thread docs/02-General/04-flavors-of-metalstack.md
Comment thread docs/02-General/04-flavors-of-metalstack.md Outdated
Comment thread docs/02-General/04-flavors-of-metalstack.md Outdated
l0wl3vel and others added 3 commits June 11, 2026 09:55
Signed-off-by: Benjamin Ritter <benjamin.ritter@x-cellent.com>
Co-authored-by: Simon Mayer <49491825+simcod@users.noreply.github.com>
Co-authored-by: Simon Mayer <49491825+simcod@users.noreply.github.com>
Signed-off-by: Benjamin Ritter <benjamin.ritter@x-cellent.com>
@l0wl3vel l0wl3vel requested a review from simcod June 12, 2026 07:52
Comment thread docs/02-General/04-flavors-of-metalstack.md
Our [Cluster API integration](../05-Concepts/04-Kubernetes/02-cluster-api.md) is a more verbose approach to provide Kubernetes clusters with metal-stack. Our implementation is still in early development. It is based on the [Cluster API](https://cluster-api.sigs.k8s.io/) project.

Resulting clusters are as minimal as possible and need to be configured manually after creation. With this approach there is no concept of service clusters. Each cluster is manually created and managed.
Configuring Cluster API is very verbose and will be basically unusable for end users. It requires additional tooling to provide a good developer experience. Cluster API will give you building blocks to build a Kubernetes-as-a-service platform on top of it, but no more. We do not recommend you use Cluster API, unless you already have a large platform engineering team, that is very experienced in bare-metal K8s operations and they agree that your specific requirements cannot be modelled with Gardener. In any other case, you will have more success with Gardener. No newline at end of file

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I recommend removing: and will be basically unusable for end users.
Your explanation of the flavors make it clear, that Gardener is more mature and with "batteries-included".

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: documentation Affects the documentation area.

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

2 participants