https://github.com/skippbox/k8sonpi

Kubernetes on RaspberryPi
https://github.com/skippbox/k8sonpi

Last synced: 4 days ago
JSON representation

Kubernetes on RaspberryPi

• Host: GitHub
• URL: https://github.com/skippbox/k8sonpi
• Owner: skippbox
• License: apache-2.0
• Created: 2015-09-10T14:45:12.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2015-11-05T09:14:38.000Z (about 9 years ago)
• Last Synced: 2024-08-02T12:51:23.541Z (3 months ago)
• Language: Shell
• Homepage:
• Size: 9.33 MB
• Stars: 28
• Watchers: 5
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - skippbox/k8sonpi - Kubernetes on RaspberryPi (others)

README

        


Kubernetes on RaspberryPI

=========================

This sets up a one node Kubernetes cluster on a RaspberryPI. This is based on the [Hypriot](http://blog.hypriot.com) Docker image for RPi.

Why ? Because it is the easiest way to start experimenting with containers on ARM architectures which can be extremely useful for the IoT and Embedded business.

It can also be a great platform to investigate scalability issues of both Docker and Kubernetes.

Requirements

------------

You will need a RaspberryPi and you will need to have installed the Hypriot OS [image](http://blog.hypriot.com/getting-started-with-docker-on-your-arm-device/) on it

For the impatient:

------------------

1. Clone this repository on your Pi

     `$ git clone https://github.com/runseb/k8s4pi.git`

     `$ cd ./k8s4pi`

2. Run the `build.sh` script

     `$ ./build.sh`

3. Enjoy

The longer version:

-------------------

We use the Kubernetes `kubelet` running as a systemd unit to monitor a few Docker containers that make up the Kubernetes _cluster_.

The Kubelet binary for ARM is downloaded and installed in `/usr/bin/kubelet`, a manifest is copied to `/etc/kubernetes/manifests/kubernetes.yaml` which represents a Kubernetes Pod that make up all the required containers.

In this pod we have:

1. An `etcd` container. Which we run by building an etcd image from scratch on the PI.

2. Several containers based on the Hyperkube image. Hyperkube is a single binary that can start all the Kubernetes components: API server, controller, scheduler.

We build a local Hyperkube image.

3. Then a little trick. Kubernetes does assume that you will run the nodes on x86_64 and automatically pulls an image called the _pause_ container. This container is used to get an IP and share that IP with all the containers in the pod. For the PI, we need to run this pause container on ARM, we trick Kubernetes by building the image `gcr.io/google_containers/pause:0.8.0` locally after having compiled the pause Golang code for ARM.

4. Finally, we download the Kubernetes client `kubectl` for ARM from the official release:

     `$ curl -fsSL -o kubectl https://storage.googleapis.com/kubernetes-release/release/v1.0.3/bin/linux/arm/kubectl`

The ARM binaries for the `kubelet` and `hyperkube` are downloaded from https://github.com/andrewpsuedonym/Kubernetes-Arm-Binaries.git