Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Releasing v0.6.0 #77

Merged
merged 4 commits into from
Jan 23, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
# To re-generate a bundle for another specific version without changing the standard setup, you can:
# - use the VERSION as arg of the bundle target (e.g make bundle VERSION=0.0.2)
# - use environment variables to overwrite this value (e.g export VERSION=0.0.2)
VERSION ?= v0.5.0
VERSION ?= v0.6.0

# CHANNELS define the bundle channels used in the bundle.
# Add a new line here if you would like to change its default config. (E.g CHANNELS = "candidate,fast,stable")
Expand Down
88 changes: 69 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,21 @@
# Kamaji Cluster API Control Plane provider
![Kamaji Cluster API Control Plane provider](./assets/cover.png)

The Kamaji Control Plane provider implementation of the Cluster Management API.
## Kamaji Cluster API Control Plane provider

## What is Kamaji?
The Kamaji Control Plane provider implementation of the [Cluster Management API](https://cluster-api.sigs.k8s.io/).

### 🤔 What is Kamaji?

[Kamaji](http://github.com/clastix/kamaji) is an Open-Source project offering hosted Kubernetes control planes.
tl;dr; the Control Plane is running in a management cluster as regular pods.

You can refer to the [official documentation website](https://kamaji.clastix.io/).

## Supported CAPI infrastructure providers
### 📄 Documentation

The Kamaji Cluster API Control Plane provider documentation is referenced in the [Kamaji documentation](https://kamaji.clastix.io/) website.

### 🚀 Supported CAPI infrastructure providers

| Infrastructure Provider | Version |
|-----------------------------------------------------------------------------------------------------------------------------------------|---------------|
Expand All @@ -25,23 +31,67 @@ You can refer to the [official documentation website](https://kamaji.clastix.io/
> Please, engage with the community on the [#kamaji](https://kubernetes.slack.com/archives/C03GLTTMWNN) Kubernetes Slack
> workspace channel, or using the **GitHub Discussion** section.

## Compatibility matrix
### 🛠 Development

This document describes how to use kind and [Tilt](https://tilt.dev/) for a simplified workflow that offers easy deployments and rapid iterative builds.
Before the next steps, make sure the initial setup for development environment steps is complete.

1. Create a `kind` cluster according to the [CAPI Infrastructure Provider requirements](https://cluster-api.sigs.k8s.io/user/quick-start#install-andor-configure-a-kubernetes-cluster) you're planning to use
2. [Install Cluster API](https://cluster-api.sigs.k8s.io/user/quick-start#initialize-the-management-cluster) with the `clusterctl` CLI
3. Install Kamaji (for the sake of simplicity, we suggest [Helm](https://github.com/clastix/kamaji/tree/master/charts/kamaji#install-kamaji))
4. Get the source of the Kamaji Control Plane provider and place in your desired `LOCATION`
5. Run the _Kamaji Cluster API Control Plane Provider_ as you prefer, as well as with `dlv` to debug it
6. Run Tilt by issuing `tilt up`
7. You have a full development environment

### 🏷️ Versioning

Versioning adheres to the [Semantic Versioning](http://semver.org/) principles.
A full list of the available release is available in the GitHub repository's [**Release** section](https://github.com/clastix/cluster-api-control-plane-provider-kamaji/releases).

### 📄 Compatibility matrix

The Control Plane provider has several dependencies, such as Cluster API and Kamaji.

The following compatibility matrix is useful to match them according to the Control Plane provider version you're planning to run.

| CP provider | Cluster API | Kamaji | TCP API version |
|-------------|-------------|---------|-----------------|
| v0.5.0 | v1.5.x | ~v0.4.0 | `v1alpha1` |
| v0.4.2 | v1.5.x | ~v0.3.2 | `v1alpha1` |
| v0.4.1 | v1.5.x | ~v0.3.2 | `v1alpha1` |
| v0.4.0 | v1.5.x | ~v0.3.2 | `v1alpha1` |
| v0.3.1 | v1.5.x | ~v0.3.2 | `v1alpha1` |
| v0.3.0 | v1.5.x | ~v0.3.2 | `v1alpha1` |
| v0.2.2 | v1.5.x | ~v0.3.2 | `v1alpha1` |
| v0.2.1 | v1.5.x | v0.3.1 | `v1alpha1` |
| v0.2.0 | v1.4.x | v0.3.x | `v1alpha1` |
| v0.2.0 | v1.4.x | v0.3.x | `v1alpha1` |
| v0.1.1 | v1.4.x | v0.3.x | `v1alpha1` |
| v0.1.0 | v1.4.x | v0.3.x | `v1alpha1` |
| CP provider | Cluster API | Kamaji | TCP API version |
|-------------|----------------|---------|-----------------|
| v0.6.0 | v1.5.x, v1.6.x | ~v0.4.0 | `v1alpha1` |
| v0.5.0 | v1.5.x | ~v0.4.0 | `v1alpha1` |
| v0.4.2 | v1.5.x | ~v0.3.2 | `v1alpha1` |
| v0.4.1 | v1.5.x | ~v0.3.2 | `v1alpha1` |
| v0.4.0 | v1.5.x | ~v0.3.2 | `v1alpha1` |
| v0.3.1 | v1.5.x | ~v0.3.2 | `v1alpha1` |
| v0.3.0 | v1.5.x | ~v0.3.2 | `v1alpha1` |
| v0.2.2 | v1.5.x | ~v0.3.2 | `v1alpha1` |
| v0.2.1 | v1.5.x | v0.3.1 | `v1alpha1` |
| v0.2.0 | v1.4.x | v0.3.x | `v1alpha1` |
| v0.2.0 | v1.4.x | v0.3.x | `v1alpha1` |
| v0.1.1 | v1.4.x | v0.3.x | `v1alpha1` |
| v0.1.0 | v1.4.x | v0.3.x | `v1alpha1` |

### 🤝 Contributions

Contributions are highly appreciated and very welcomed!

In case of bugs, please, check if the issue has been already opened by checking the [GitHub Issues](https://github.com/clastix/cluster-api-control-plane-provider-kamaji/issues) section.
In case it isn't, you can open a new one: a detailed report will help us to replicate it, assess it, and work on a fix.

You can express your intention in working on the fix on your own.
The commit messages are checked according to the described [semantics](https://github.com/projectcapsule/capsule/blob/main/CONTRIBUTING.md#semantics).
Commits are used to generate the changelog, and their author will be referenced in it.

### 📝 License

The Kamaji Cluster API Control Plane provider is licensed under Apache 2.0.
The code is provided as-is with no warranties.

### 🛟 Commercial Support

[CLASTIX](https://clastix.io/) is the commercial company behind Kamaji and the Cluster API Control Plane provider.

If you're looking to run Kamaji in production and would like to learn more, **CLASTIX** can help by offering [Open Source support plans](https://clastix.io/support),
as well as providing a comprehensive Enterprise Platform named [CLASTIX Enterprise Platform](https://clastix.cloud/), built on top of the Kamaji and [Capsule](https://capsule.clastix.io/) project (now donated to CNCF as a Sandbox project).

Feel free to get in touch with the provided [Contact form](https://clastix.io/contact).
Binary file added assets/cover.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion config/control-plane-components.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4308,7 +4308,7 @@ spec:
- --leader-elect
command:
- /manager
image: docker.io/clastix/cluster-api-control-plane-provider-kamaji:v0.5.0
image: docker.io/clastix/cluster-api-control-plane-provider-kamaji:v0.6.0
livenessProbe:
httpGet:
path: /healthz
Expand Down
2 changes: 1 addition & 1 deletion config/manager/kustomization.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,4 @@ kind: Kustomization
images:
- name: controller
newName: docker.io/clastix/cluster-api-control-plane-provider-kamaji
newTag: v0.5.0
newTag: v0.6.0
3 changes: 3 additions & 0 deletions config/metadata.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,9 @@
# update this file only when a new major or minor version is released
apiVersion: clusterctl.cluster.x-k8s.io/v1alpha3
releaseSeries:
- major: 0
minor: 6
contract: v1beta1
- major: 0
minor: 5
contract: v1beta1
Expand Down
Loading