This project is aimed 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.

Official documentation is available at Agorakube Website

Master branch is stable.

If you want to install Kubernetes V1.19+, please use the "core" branch.(Support v16 to v19)

Read this in French

Since November 2019, Agorakube has been certified by the "Kubernetes Conformance Program" and is a project of the cncf landscape.

This is a list of points that will be explained in this Readme file for the AgoraKube project :

• What is AgoraKube
• How to install
• How to give feedback
• How to contribute
• Community
• Licensing

AgoraKube is an easy-to-use, stable Kubernetes distribution (Kubernetes v1.15, 1.16, 1.17, 1.18).

By its symplicity, AgoraKube provide a good 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 and fit to your needs :

• OS : Ubuntu-18.04/20.04-amd64 and Centos 7.X-amd64, Debian-10-amd64
• DNS Service: CoreDNS
• Ingress Controller Traefik (Default) & HA-Proxy & Nginx
• Container Runtime: Containerd (Default) & Docker
• Certificats: Self Signed PKI
• Service-Mesh: available: Linkerd
• Storage: Rook Ceph Block with StorageClass, and MinIO for Object Storage
• Registry: Harbor full featured
• Monitoring: Prometheus/Grafana
• CNI plugin: Flannel, Calico, Kube-router
• Packaging: Helm
• Self service application portal: Kubeapps
• ...

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

We regularly use a machine to deploy every cluster. We only use it for deployment.

Execute this command in order to install Ansible and clone the repository :

bash <(curl -s https://raw.githubusercontent.com/ilkilab/agorakube/master/setup-deploy.sh)

Execute this command on each node to update them and install the last version of Python :

bash <(curl -s https://raw.githubusercontent.com/ilkilab/agorakube/master/setup-hosts.sh)

To deploy your K8S cluster follow these instructions.

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

You can also give use vulnerability reports by this way.

See our Code Of Conduct and CONTRIBUTING for more information.

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

Channels :

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

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 the 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)".

Like almost all software today, this software 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 prevent licensing issues using various processes (see CONTRIBUTING).