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.

Table of Contents

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, 1.23).

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 📖

This project follows the all-contributors specification. Contributions of any kind welcome!