README.md

This repository is a natural successor of https://github.com/julianxhokaxhiu/vps-powered-by-docker

µKube Stack

Easy install script for Kubernetes stack with Nginx Ingress, ACME, Weave.net, Helm and many modules

Stack

• Arch Linux ( as a preference, but you can use your preferred distro if you want )
• IPv4 ( IPv6 will come soon )
• Docker
• Kubernetes
• Weave Net as pod network manager
• Nginx Ingress as Ingress Controller
• kube-lego as Automatic SSL ACME provider
• Helm as Kubernetes Package Manager

Modules

• Kubernetes Dashboard ( dashboard.lan.sh )
• Poste ( mail.lan.sh )
• WebDAV ( webdav.lan.sh )

Requirements

A clean Arch Linux install with SSH capability as root user ( or any user which has sudo powers ).

Installation

wget https://github.com/uKube/stack/archive/master.zip
unzip master.zip && cd stack-master
find ./ -name "*.sh" -exec chmod +x {} \;
./install.sh

Remember to configure the LEGO_EMAIL with your own email.

Module setup

Edit the configuration variables to fit your needs, inside config.tpl.yaml on every module, then

./path/to/module/<module_name>.sh
# example ./modules/kubernetes-dashboard/dashboard.lan.sh

WARNING: Within this stack every module is configured to get an automatic LE HTTPS certificate, if the FQDN is accepted on LE side. If yes, your HTTP domain will be redirected to HTTPS in automatic as soon as the certificate is there.

Performance monitoring

Take a look at this awesome article: https://sysdig.com/blog/monitoring-kubernetes-with-sysdig-cloud/

Disclaimer

• The mapping of the domains to the Host IP is considered done already externally to this project ( through DNS Server or statically inside your hosts file )