whatisgithub

What is turing-pi-2-cluster?

geerlingguy/turing-pi-2-cluster — explained in plain English

Analysis updated 2026-08-01 · repo last pushed 2023-01-13

179JinjaAudience · developerComplexity · 4/5DormantSetup · hard

In one sentence

Automation scripts that set up a mini Kubernetes cluster on a Turing Pi 2 board with multiple Raspberry Pi compute modules. Deprecated in favor of a newer repository.

Mindmap

mindmap
  root((repo))
    What it does
      Automates cluster setup
      Configures multiple Pis
      Installs lightweight Kubernetes
    Tech stack
      Ansible
      K3s
      ZFS
      Prometheus and Grafana
    Use cases
      Learn distributed systems
      Off-grid remote cluster
      Test Kubernetes apps
    Audience
      Hobbyists and makers
      YouTube followers
    Caveats
      Deprecated project
      Pre-production hardware

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get a working Kubernetes cluster running on a Turing Pi 2 with four Raspberry Pi compute modules in an afternoon.

USE CASE 2

Set up a remote off-grid cluster with 4G LTE modem connectivity and reverse SSH tunnel access from anywhere.

USE CASE 3

Monitor cluster health with Prometheus and Grafana dashboards deployed automatically by the scripts.

USE CASE 4

Verify your cluster works by deploying a sample Drupal website included in the automation.

What is it built with?

AnsibleK3sZFSPrometheusGrafanaDrupal

How does it compare?

geerlingguy/turing-pi-2-clusterjlevy/simple-modern-uvfarama-foundation/gymnasium-env-template
Stars17928123
LanguageJinjaJinjaJinja
Last pushed2023-01-132024-10-16
MaintenanceDormantStale
Setup difficultyhardeasymoderate
Complexity4/52/53/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires physical Turing Pi 2 hardware with Raspberry Pi compute modules, network configuration, and the project is deprecated in favor of a newer repository.

No license information is provided in the repository, so default copyright restrictions apply and usage rights are unclear.

So what is it?

This repository, created by Jeff Geerling, is a set of automation scripts for setting up a mini-computer cluster on a Turing Pi 2 board. A Turing Pi 2 lets you plug multiple Raspberry Pi compute modules into a single board, essentially creating a tiny, self-contained data center. The scripts automate all the tedious setup work, from configuring the network to installing software, so you end up with a working cluster that can run applications across multiple computers. Note that this project is deprecated, meaning the author has moved active development to a newer repository. The automation is built with Ansible, a tool that lets you control multiple computers from a single workstation. You provide Ansible with a list of your computers (in this case, four Raspberry Pis named turing-node-1 through turing-node-4) and some basic configuration details. When you run the provided playbooks (which are basically instruction files), Ansible connects to each Pi over your network and configures them automatically. It sets up one Pi as the "control plane" (the leader) and the rest as worker nodes, then installs K3s, a lightweight version of Kubernetes that coordinates the cluster. The setup goes beyond basic cluster installation. It can configure a custom network so the cluster operates on its own isolated subnet, which is useful if you want to run it remotely. In fact, the author includes configurations for connecting a 4G LTE modem for off-grid internet, and even sets up a reverse SSH tunnel so you can remotely access the cluster from anywhere. It also configures storage using ZFS, sets up Prometheus and Grafana for monitoring the cluster's health, and deploys a sample Drupal website so you can verify everything works. This is aimed at hobbyists and makers who want to experiment with clustered computing and Kubernetes on physical hardware without spending thousands on enterprise gear. A concrete example would be someone who bought a Turing Pi 2 to learn how distributed systems work, they could use these scripts to get a functional cluster running in an afternoon rather than manually configuring each Pi. The author also used this setup for YouTube videos, so viewers could follow along and replicate his environment. One notable tradeoff: the README warns that the hardware used was a pre-production prototype, so behavior may differ on production boards. The project is also explicitly deprecated in favor of a newer pi-cluster repository, so anyone using it today should be aware it won't receive updates.

Copy-paste prompts

Prompt 1
Set up a Turing Pi 2 with four Raspberry Pi compute modules as a Kubernetes cluster using Ansible, with one control plane node and three worker nodes running K3s.
Prompt 2
Configure a Turing Pi 2 cluster for off-grid remote access by adding a 4G LTE modem, setting up an isolated subnet, and enabling reverse SSH tunnel so I can reach the cluster from anywhere.
Prompt 3
Install Prometheus and Grafana monitoring on a Turing Pi 2 K3s cluster using the Ansible playbooks from this repository, and deploy the sample Drupal site to verify the cluster works.
Prompt 4
Explain what these deprecated Turing Pi 2 cluster Ansible scripts do and how to migrate to the newer pi-cluster repository that replaced them.

Frequently asked questions

What is turing-pi-2-cluster?

Automation scripts that set up a mini Kubernetes cluster on a Turing Pi 2 board with multiple Raspberry Pi compute modules. Deprecated in favor of a newer repository.

What language is turing-pi-2-cluster written in?

Mainly Jinja. The stack also includes Ansible, K3s, ZFS.

Is turing-pi-2-cluster actively maintained?

Dormant — no commits in 2+ years (last push 2023-01-13).

What license does turing-pi-2-cluster use?

No license information is provided in the repository, so default copyright restrictions apply and usage rights are unclear.

How hard is turing-pi-2-cluster to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is turing-pi-2-cluster for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.