Fit for Git

This is a toolbox for organizing Git workshops / training events. It contains step-by-step instructions for setting up the infrastructure, as well as workshop content that is automatically converted to a presentation and to an online copy as reference for participants.

Setting up the server

Installing the base OS on VM/workstation

We only need a minimal Linux installation and Python on both server and client.

Installing the base OS on Raspberry PI

1. Download the Raspberry PI unattended installer

2. create a FAT32 partition on an empty SD card

   sudo parted /dev/mmcblk0 -- mkpart primary fat32 1 -1 sudo mkfs -t msdos /dev/mmcblk0p1

3. unzip raspberrypi-ua-netinst-*.zip to the SD card

4. on the SD card, create a directory raspberrypi-ua-netinst/config and copy rpi/installer-config.txt from this repository to the directory you created

5. edit raspberrypi-ua-netinst/config/installer-config.txt and choose a custom root password (recommended); the default one is fitforgit

6. insert SD card into the pi, connect network and power, wait about 10-20 minutes

You should now be able to log in to the pi as root with the password you chose in step 5.

Setting up server and clients

You will need at least a server host, and optionally one or more clients. You need to be able to SSH as root into each before you proceed.

First, generate an SSH identity (if you don't already have one), add it to the running ssh-agent and distribute it to the target machines. This allows us to avoid entering the root password(s) repeatedly. If you've cloned this repository directly to the server and you're not setting up clients, you can skip this step.

ssh-keygen -t ed25519
ssh-add ~/.ssh/id_ed25519
ssh-copy-id -i ~/.ssh/id_ed25519 root@ffg

Repeat the last command with ffg replaced by each client you want to set up in turn.

We'll be using Ansible for automating the installation and configuration process. You will only need to install it on the machine from which you SSH into the server and clients. Install it using your distribution's package manager or, if you don't have root access, using pip:

pip install ansible
export PATH=~/.local/bin:$PATH

Edit the file settings.ini and change admin_pw to a password of your choice (unless you want to risk inquisitive participants taking over your infrastructure). If you want to install the server on a machine other than the one where you cloned this repository, replace localhost with the name of the server. Optionally, add client hostnames and/or adjust the other settings.

Now we're ready to start the installation (your current working directory must be the root of this repository):

ansible-galaxy install -r ansible/requirements.yml
ansible-playboook setup.yml

After the playbook has finished, head over to http://ffg (replace ffg with the name of your server). If everything went well, you should be seeing the FitForGit welcome page.

Setting up via Android device

Install Termux, open a Termux session and enter the following commands:

packages install git python python-dev openssl-dev libffi-dev openssh clang
CONFIG_SHELL=$PREFIX/bin/sh pip install ansible

Creating slides

Install Pandoc (package manager, or to your home directory using the installation instructions). Then:

git clone --depth=1 https://github.com/hakimel/reveal.js
pandoc -s --self-contained -t revealjs docs/index.md docs/0* -o slides.html

See Pandoc User's Guide for alternative slideshow formats.

Creating an online copy

Install MkDocs (package manager or pip install mkdocs), then:

mkdocs build

If you make changes to the docs, you can run mkdocs serve to get a live preview of the rendered version.