Skip to content

Latest commit

 

History

History
74 lines (51 loc) · 2.57 KB

README.md

File metadata and controls

74 lines (51 loc) · 2.57 KB

BOSH release for k3s

k3s Logo

bosh Logo

This BOSH release and deployment manifest deploy a cluster of k3s

Lightweight Kubernetes. 5 less than k8s. https://k3s.io.

The aim of the bosh release:

  • offer a very thin layer on top of k3 binary

  • reduced memory footprint wrt existing k8s bosh release

  • enrich k3 experience with bosh goodies

    • reproductible / stable OS provided as stemcell
    • easy cluster deployment (multi-vm, multi-master, correcly wired master / agent)
    • multi-iaas capability (vpshere/openstack/gcp/azure/ ... )
    • credhub secrets generation (k3s-token)
  • day 2 operations (persistend disk resize, stemcell rotation)

  • ease of dev / operations

design overview

Provide a lightweight bosh packaging of Rancher k3s kubernetes distribution

Includes

  • Rancher k3s binary
  • k9S binary

The bosh release offers 2 jobs to build a full k3s bosh deployment:

  • k3s-server job.
  • k3s-agent job.

Usage

This repository includes base manifests and operator files. They can be used for initial deployments and subsequently used for updating your deployments:

export BOSH_ENVIRONMENT=<bosh-alias>
export BOSH_DEPLOYMENT=k3s
git clone https://github.com/cloudfoundry-community/k3s-boshrelease.git
bosh deploy k3s-boshrelease/manifests/k3s.yml

If your BOSH does not have Credhub/Config Server, then remember --vars-store to allow generation of passwords and certificates.

Update

When new versions of k3s-boshrelease are released the manifests/k3s.yml file will be updated. This means you can easily git pull and bosh deploy to upgrade.

export BOSH_ENVIRONMENT=<bosh-alias>
export BOSH_DEPLOYMENT=k3s
cd k3s-boshrelease
git pull
cd -
bosh deploy k3s-boshrelease/manifests/k3s.yml

Full fledge usage sample

this bosh release usage can be seen in action in https://github.com/orange-cloudfoundry/paas-templates/tree/manual-drop/shared-operators/k3s