C3OS

Create Decentralized Kubernetes clusters

Automatic Node discovery - Automatic VPN - K3s

---

A cOS derivative with k3s based on openSUSE and Alpine.

Documentation available here.

Run

Download the ISO from the latest releases.

Installation

Boot the ISO and follow the instructions on screen. The openSUSE variant supports automatic peer discovery and device pairing.

Use the c3os CLI to register and handle node installation remotely, check out the documentation.

Manual

Install c3os with cos-install --config <config-file> or either place it in /oem after install. The config file can be a cloud-init file, or a URL pointing to a cloud-init file.

Build

Needs only docker.

Run build.sh, should produce a docker image along with an ISO

Cloud-init examples

c3os supports the standard cloud-init syntax and the extended one from the cOS toolkit.

Examples using the extended notation for running k3s as agent or server are in examples/.

Upgrades

c3os supports both manual and upgrades within kubernetes with system-upgrade-controller.

For an example of how to trigger an upgrade, see the cOS toolkit documentation.

Default user

The system have an hardcoded username/password when running from the LiveCD:

user: c3os
pass: c3os

Note, after the upgrade the password login is disabled, so users and ssh keys to login must be configured via cloud-init.