Skip to content

ptrivedi/cluster-api-provider-tinkerbell

 
 

Repository files navigation

Cluster API Provider Tinkerbell

Go Reference CRD - reference Go Report Card


This repository is Experimental meaning that it's based on untested ideas or techniques and not yet established or finalized or involves a radically new and innovative style! This means that support is best effort (at best!) and we strongly encourage you to NOT use this in production.

Kubernetes-native declarative infrastructure for Kubernetes clusters on Tinkerbell.


What is the Cluster API Provider Tinkerbell

The Cluster API brings declarative, Kubernetes-style APIs to Kubernetes cluster creation, configuration and management.

The API itself is shared across multiple cloud providers allowing for true hybrid deployments of Kubernetes, both on-premises and off.


Quick Start

See the Quick Start


Compatibility with Cluster API and Kubernetes Versions

This provider's versions are compatible with the following versions of Cluster API:

v1beta1 (v1.0)
Tinkerbell Provider v1beta1 (v0.1)

This provider's versions are able to install and manage the following versions of Kubernetes:

v1.19 v1.20 v1.21 v1.22
Tinkerbell Provider v1beta1 (v0.1)

Each version of Cluster API for Tinkerbell will attempt to support all community supported Kubernetes versions during it's maintenance cycle; e.g., Cluster API for Tinkerbell v0.1 supports Kubernetes 1.19, 1.20, 1.21, 1.22 etc.

NOTE: As the versioning for this project is tied to the versioning of Cluster API, future modifications to this policy may be made to more closely align with other providers in the Cluster API ecosystem.


Kubernetes versions with published Images

Pre-built images are pushed to the GitHub Container Registry. We currently publish images for Ubuntu 18.04 and Ubuntu 20.04.


Current state

Currently, it is possible to bootstrap both single instance and multiple instance Control Plane workload clusters using hardware managed by Tinkerbell.

Integration with PBnJ for remote power management and secure deprovisioning of instances is still outstanding and must be handled externally.

See docs/README.md for more information on setting up a development environment.


Technical preview

This project is under active development and you should expect issues, pull requests and conversation ongoing in the bi-weekly community meeting. Feel free to join if you are curious or if you have any question.

About

Cluster API Infrastructure Provider for Tinkerbell

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 86.2%
  • Makefile 4.6%
  • Shell 4.4%
  • Python 4.2%
  • Dockerfile 0.6%