Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/flexkube/libflexkube
Go library for installing and managing Kubernetes clusters
https://github.com/flexkube/libflexkube
etcd-management helm kubelet kubernetes kubernetes-cluster self-hosted ssh
Last synced: 2 months ago
JSON representation
Go library for installing and managing Kubernetes clusters
- Host: GitHub
- URL: https://github.com/flexkube/libflexkube
- Owner: flexkube
- License: apache-2.0
- Created: 2019-11-09T20:17:12.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-09-11T11:10:24.000Z (4 months ago)
- Last Synced: 2024-09-11T16:37:54.983Z (4 months ago)
- Topics: etcd-management, helm, kubelet, kubernetes, kubernetes-cluster, self-hosted, ssh
- Language: Go
- Homepage: https://flexkube.github.io/
- Size: 2.88 MB
- Stars: 35
- Watchers: 5
- Forks: 7
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# libflexkube: Go library for deploying Kubernetes
[](https://travis-ci.org/flexkube/libflexkube) [](https://codeclimate.com/github/flexkube/libflexkube/maintainability) [](https://codecov.io/gh/flexkube/libflexkube) [](https://godoc.org/github.com/flexkube/libflexkube) [](https://goreportcard.com/report/github.com/flexkube/libflexkube)
## Table of contents
- [Introduction](#introduction)
- [Documentation](#documentation)
- [Installation and usage](#installation-and-usage)
- [CLI tool](#cli-tool)
- [Terraform](#terraform)
- [Next steps](#next-steps)
- [Characteristics](#characteristics)
- [Features](#features)
- [Known issues, missing features and limitations](#known-issues-missing-features-and-limitations)
- [Contributing](#contributing)
- [Status of the project](#status-of-the-project)
## Introduction
libflexkube is the core part of Flexkube project. It is a Go library, which implements the logic for managing Kubernetes cluster components (e.g. [etcd](https://etcd.io/), [kubelet](https://kubernetes.io/docs/reference/command-line-tools-reference/kubelet/), [certificates](https://kubernetes.io/docs/setup/best-practices/certificates/)) and provides reference implementation of [flexkube](https://flexkube.github.io/documentation/reference/cli/) CLI tool and [Terraform provider](https://registry.terraform.io/providers/flexkube/flexkube/latest/docs).
Flexkube is a minimalistic and flexible Kubernetes distribution, providing tools to manage each main Kubernetes component independently, which can be used together to create Kubernetes clusters.
## Documentation
To see user documentation, visit [flexkube.github.io](https://flexkube.github.io). Please note, that the documentation is still in progress.
For development documentation, see [docs](docs).
## Installation and usage
For quick examples of installation and usage, see the content below. For full documentation, see [Getting started](https://flexkube.github.io/documentation/getting-started/).
### CLI tool
If you have `go` binary available in your system, you can start using Flexkube for creating Kubernetes certificates just by running the following commands:
```sh
echo 'pki:
kubernetes: {}
etcd: {}' > config.yaml
go run github.com/flexkube/libflexkube/cmd/flexkube@latest pki
```
It will create `config.yaml` configuration file which will be consumed by `flexkube` CLI tool, which will then generate the certificates into `state.yaml` file.
### Terraform
If you want to perform the same action using Terraform, execute the following commands:
```sh
cat < main.tf
terraform {
required_providers {
flexkube = {
source = "flexkube/flexkube"
version = "0.9.0"
}
}
}
resource "flexkube_pki" "pki" {
etcd {}
kubernetes {}
}
EOF
terraform init && terraform apply
```
After applying, Kubernetes certificates should be available as Terraform resource attributes of `flexkube_pki.pki` resource.
### Next steps
For more detailed instructions of how to use Flexkube, see the user [guides](https://flexkube.github.io/documentation/guides).
## Characteristics
Flexkube project focuses on simplicity and tries to only do minimal amount of steps in order to get Kubernetes cluster running, while keeping the configuration flexible and extensible. It is also a good material for learning how Kubernetes cluster is set up, as each part of the cluster is managed independently and code contains a lot of comments why specific flag/option is needed and what purpose does it serve.
Parts of this project could possibly be used in other Kubernetes distributions or be used as a configuration reference, as setting up Kubernetes components requires many flags and configuration files to be created.
Flexkube do not manage infrastructure for running Kubernetes clusters, it must be provided by the user.
## Features
Here is the short list of Flexkube project features:
- Minimal host requirements - Use SSH connection forwarding for talking directly to the container runtime on remote machines for managing static containers and configuration files.
- Independent management of etcd, kubelets, static control plane and self-hosted components.
- All self-hosted control plane components managed using Helm 3 (e.g CoreDNS).
- 1st class support for Terraform provider for automation.
- No Public DNS or any other public discovery service is required for getting cluster up and running.
- Others:
- etcd, kubelet and static control plane running as containers.
- Self-hosted control plane.
- Supported container runtimes:
- Docker
- Configuration via YAML or via Terraform.
- Deployment using CLI tools or via Terraform.
- HAProxy for load-balancing and fail-over between Kubernetes API servers.
## Known issues, missing features and limitations
As the project is still in the early stages, here is the list of major existing issues or missing features, which are likely to be implemented in the future:
- gracefully replacing CA certificates (if private key does not change, it should work, but has not been tested)
- no checkpointer for pods/apiserver. If static kube-apiserver container is stopped and node reboots, single node cluster will not come back.
And features, which are not yet implemented:
- network policies for kube-system namespace
- caching port forwarding
- bastion host(s) support for SSH
- parallel deployments across hosts
- removal of configuration files, created data and containers
- automatic shutdown/start of bootstrap control plane
## Contributing
All contributions to this project are welcome. If it does not satisfy your needs, feel free to raise an issue about it or implement the support yourself and create a pull request with the patch, so we can all benefit from it.
If you just want to help the project grow and mature, there are many TODOs spread across the code, which should be addresses sooner or later.
## Status of the project
At the time of writing, this project is in active development state and it is not suitable for production use. Breaking changes might be introduced at any point in time, for both library interface and for existing deployments.