AGORAKUBE KUBERNETES ENGINE

This project aims to provide the simplest way to install Kubernetes on AMD-64 bare-metal, virtual & Cloud environments. Currently, Ubuntu 18.04 & 20.04, Centos 7 and Debian 10 are supported, but several other operating systems will be available soon.

Master branch is stable.

The following items are explained in this Readme file for the Agorakube project :

What is AGORAKUBE
How to install
How to give feedback
How to contribute
Community
Licensing

What is AGORAKUBE

Agorakube is an easy-to-use, stable Kubernetes distribution (Kubernetes v1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22).

Agorakube provides a simple, user-friendly way to deploy and manage K8S Clusters.

Agorakube is based on Ansible scripts that install and configure Kubernetes components (control plane and data plane) quickly on bare-metal / VMs / Cloud Instances, as systemd services.

This distribution is also adaptive by offering the opportunity to customize your deployment to fit your needs :

OS : Ubuntu-18.04/20.04-amd64 and Centos 7.X-amd64, Debian-10-amd64
DNS Service: CoreDNS
Ingress Controller Traefik v2 & HA-Proxy & Nginx (Default)
Container Runtime: Containerd (Default) & Docker
Certificats: Self Signed PKI using OpenSSL
Storage: OpenEBS (Jiva and HostPath)
Monitoring: Prometheus/Grafana/node-Exporter
CNI plugin: Kube-router, Calico (VxLAN Cross-Subnet)
MetalLB (L2/ARP mode for external LB)
Metrics-Server
Kubernetes-Dashboard
Kubernetes ConfigMap and Secret Reloader
Logrotate
OIDC/SSO with Keycloak
Open Policy Agent Gatekeeper
ArgoCD

This project is currently under active development so other customizable options will be added soon.

How to install

To deploy your K8S cluster follow these instructions.

How to give feedback

All feedback is welcome via the GitHub site as issues or pull (merge) requests.

You can also give use vulnerability reports by this way.

How to contribute

See our Code Of Conduct and CONTRIBUTING for more information.

Community

Join Agorakube's community for discussion and ask questions : AGORAKUBE's Slack

Channels :

#general - For general purpose (news, events...)
#developers - For people who contribute to Agorakube by developing features
#end-users - For end users who want to give us feedback
#random - As its name suggests, for random discussions :)

Licensing

All material here is released under the APACHE 2.0 license.
All material that is not executable, including all text when not executed, is also released under APACHE 2.0.
In SPDX terms, everything here is licensed under APACHE 2.0;
if it's not executable, including the text when extracted from code, it's "(APACHE 2.0)".

As with almost all software today, Agorakube depends on many other components with their own licenses.
Not all components we depend on are APACHE 2.0-licensed, but all required components are FLOSS.
We use various processes to prevent licensing issues (see CONTRIBUTING).

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{pranavbaitule} 📖	_{pierre villard} 📖 💻 🧑‍🏫 📆	_gaelfr29 📖 📆 🤔 💼	_{Adrien Huerre} 📖 📆 🤔 💼	_bryanILKI 📖 💻 🚧	_{sabrine-hammami} 📖 💻 🚧	_{Hameedullah Khan} 📖 💻
_{Big Bill} 📖 💻	_{Hussein Fahmy} 📖 💻	_rushilgala 📖 💻	_odidev 💻	_{Aaron Johnson} 📖 💻	_msouvatdy 📖 💻	_tyb3n 📖 💻
_{Eric Stumbo} 💻	_rob-coq 📖 💻	_HaroldIlki 📖 💻	_{Bob Akerson} 📖	_jeremyj563 💻	_{Pratik Raj} 💻	_McgovernJP 📖