Home

Awesome

<!-- markdownlint-disable MD033 MD045 --> <h1 align="center"> <img src="docs/assets/fury-epta-white.png" width="200px"/><br/> Kubernetes Fury Distribution </h1> <p align="center">Kubernetes Fury Distribution (KFD) is a certified battle-tested Kubernetes distribution based purely on upstream Kubernetes.</p> <!-- markdownlint-enable MD033 MD045 -->

Build Status Release Slack License

Overview

Kubernetes Fury Distribution (KFD) is a CNCF certified battle-tested Kubernetes distribution based purely on upstream Kubernetes.

It is developed and maintained by SIGHUP and the community, and it is fully open source.

🎯 The goal of Fury is to turn any standard Kubernetes cluster into a fully-configured production-grade cluster.

Un-distribution model 🧬

KFD uses an un-distribution model. This means that we:

Architecture 🏗

<!-- markdownlint-disable MD033 MD045 --> <p align="center"> <img src="docs/assets/kfd-architecture-v2.png" width="800px"/> </p> <!-- markdownlint-enable MD033 MD045 -->

Kubernetes Fury Distribution is structured on modules, and each module has a set of packages.

All modules are open source, widely used, easily customizable, and pre-configured with sane defaults and tested to work well together.

The standard way to deploy KFD is to:

See the getting started section below for more information.

Recommended Hardware Requirements

KFD is a modular and composable system, so hardware requirements ultimately depend on the modules and configuration chosen. Having said that, for a production-grade cluster a good starting point would be:

A KFD production grade cluster will be composed of 3 node pools:

Nodes sizing

Node RoleCPU (cores)RAM (GB)Disk (GB)Qty.
Control Plane28503
Infrastructure416503
Load Balancer22502

Storage

Some modules rely on persistent storage via PersistentVolumeClaims, by default (but configurable) the following capacity will be used:

DescriptionSize (GB)
Prometheus (metrics storage)150
MinIO Monitoring (metrics storage, 20GBx6)120
MinIO Logging (logs storage, 20GBx6)120
OpenSearch (logs storage)30
MinIO Tracing (traces storage)120
Total540

Core Modules 📦

Core modules provide essential functionality to the distribution for production-grade clusters.

ModuleIncluded ReleaseDescription
NetworkingVersionNetworking functionality via Calico or Cilium CNIs
IngressVersionFast and reliable Ingress Controller and TLS certificate management
LoggingVersionA centralized logging solution based on the LoggingOperator + OpenSearch or Loki stacks
MonitoringVersionMonitoring and alerting functionality based on Prometheus, AlertManager and Grafana
TracingVersionTracing functionality based on Tempo
Disaster RecoveryVersionBackup and disaster recovery solution using Velero
OPAVersionPolicy and Governance for your cluster using OPA Gatekeeper and Gatekeeper Policy Manager or Kyverno
AuthVersionImproved auth for your Kubernetes Cluster and its applications

Add-on Modules 📦

Add-on modules provide additional functionality to the distribution. Their release cycle is independent of KFD's.

ModuleDescription
KongAdd Kong API Gateway for Kubernetes applications via Kong Ingress Controller
Service MeshDeploy a service mesh on top of KFD
RegistryIntegrate a Container Registry solution
StorageRook (Ceph Operator) based Storage solution on Kubernetes
KafkaApache Kafka event streaming for your Cluster

Get started with KFD 🚀

To get started with KFD, please head to the quickstart guides on the documentation site.

Issues 🐛

In case you experience any issues feel free to open a new issue.

If the problem is related to a specific module, open the issue in the module repository.

Commercial Support 🛟

If you are looking to run KFD in production and would like to learn more, SIGHUP (the company behind the Fury ecosystem) can help. Feel free to email us or check out our website.

Support & Compatibility 🪢

Current supported versions of KFD are:

KFD VersionKubernetes Version
1.29.41.29.x
1.28.41.28.x
1.27.91.27.x

Check the compatibility matrix for additional information about previous releases of the Distribution and the compatibility with furyctl.

Also, check the versioning documentation file to know more about the versioning scheme of the distribution and the upgrade path.

CNCF Certified 🎓

Each version of the Kubernetes Fury Distribution that introduces compatibility with a new version of Kubernetes goes through a conformance certification process with the CNCF. Certified solutions are validated to ensure a set of guarantees such as consistency, timely updates and confirmability.

KFD has been certified by the CNCF (Cloud Native Computing Foundation) as a Certified Kubernetes Distribution for all Kubernetes versions since Kubernetes 1.12. Clicking on the badge below you can see the certification process for the latest version of KFD:

<!-- markdownlint-disable MD033 --> <p align="center"> <a href="https://github.com/cncf/k8s-conformance/pull/3124"> <img src="https://raw.githubusercontent.com/cncf/artwork/main/projects/kubernetes/certified-kubernetes/versionless/pantone/certified-kubernetes-pantone.svg" width="120" alt="KFD is CNCF Certified Kubernetes 1.29 - click to see the certification PR"/> </a> </p> <!-- markdownlint-enable MD033 -->

Roadmap

Find the updated roadmap in the ROADMAP.md file.

Contributing 🤝

If you wish to contribute please read the Contributing Guidelines.

License

KFD is open-source software and it's released under the following LICENSE

<!-- Core Modules --> <!-- Addon Modules --> <!-- Misc -->