Skip to content

Commit 37d6f44

Browse files
authored
🌱 Add basic readme (#7)
Adding readme that explains the basic components and functionality of the operator and gives references to related projects Signed-off-by: janiskemper <[email protected]>
1 parent f111200 commit 37d6f44

File tree

1 file changed

+25
-1
lines changed

1 file changed

+25
-1
lines changed

README.md

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,25 @@
1-
# SCS Cluster Stack Operator
1+
# Cluster Stack Operator
2+
3+
## Get started
4+
5+
The Cluster Stack Operator works with [Cluster Stacks](https://github.com/SovereignCloudStack/cluster-stacks) and creates Kubernetes clusters in an easy and [Cluster-API](https://github.com/kubernetes-sigs/cluster-api)-native way.
6+
7+
The operator can be used with any repository that contains releases of cluster stacks. For more details of how to implement them, have a look at the [cluster-stacks repository](https://github.com/SovereignCloudStack/cluster-stacks).
8+
9+
To try out this operator and cluster stacks, have a look at this [demo](https://github.com/SovereignCloudStack/cluster-stacks-demo).
10+
11+
## What is the Cluster Stack Operator?
12+
13+
The Cluster Stack Operator facilitates the manual work that needs to be done to use cluster stacks.
14+
15+
There are three components of a cluster stack:
16+
17+
1. Cluster addons: The cluster addons (CNI, CSI, CCM) have to be applied in each workload cluster that the user starts
18+
2. Cluster API objects: The `ClusterClass` object makes it easier to use Cluster-API. The cluster stack contains a `ClusterClass` object and other Cluster-API objects that are necessary in order to use the `ClusterClass`. These objects have to be applied in the management cluster.
19+
3. Node images: Node images can be provided to the user in different form. They are released and tested together with the other two components of the cluster stack.
20+
21+
The first two are handled by this operator here. The node images, on the other hand, have to be handled by separate provider integrations, similar to the ones that [Cluster-API uses](https://cluster-api.sigs.k8s.io/developer/providers/implementers-guide/overview).
22+
23+
## Implementing a provider integration
24+
25+
Further information and documentation on how to implement a provider integration will follow soon.

0 commit comments

Comments
 (0)