🍪 CODE CRISPIES Workshop Infrastructure

This repository contains the infrastructure for the Co-op Cloud workshop, providing three distinct deployment environments.

🚀 Quick Start

# 1. Start the local development virtual machine (15 containers)
make local-vm-run

# 2. Build & flash USB drives for participants
make build-usb
make flash-usb USB_DEVICE=/dev/sdX

# 3. Deploy the production cloud infrastructure
export HCLOUD_TOKEN="your_token_here"
make deploy-cloud

📁 Project Structure

├── flake.nix              # All Nix configurations (USB, VM)
├── terraform/             # Hetzner Cloud infrastructure
├── scripts/deploy.sh      # Cloud setup automation
├── docs/USB_BOOT_INSTRUCTIONS.md
└── Makefile              # Build & deploy commands

🌍 Three Environments

1. Cloud (Production)

What: 15 Hetzner VMs named hopper.codecrispi.es, curie.codecrispi.es, etc.
Purpose: The live environment for workshop participants.
Participants: hopper, curie, lovelace, noether, hamilton, franklin, johnson, clarke, goldberg, liskov, wing, rosen, shaw, karp, rich

2. USB Boot (Workshop)

What: A bootable NixOS live environment with SSH client tools.
Purpose: Used by participants to connect to their cloud servers.
Features: Pre-configured with helper functions like connect hopper, recipes command, and workshop-specific tooling.

3. Local (Development)

What: A self-contained Virtual Machine (VM) that runs on your local computer with all 15 containers.
Purpose: Complete local testing environment that mirrors production setup without needing cloud servers.
Resources: Creates 15 containers (heavy resource usage - ensure adequate RAM/CPU)

🔧 Local Development Workflow

Start the VM Run the following command. A new window will open and automatically boot into a lightweight desktop.
```
make local-vm-run
```
Work Inside the VM All testing is now done inside the VM's graphical desktop.
- Open the Terminal to run commands.
- Open Firefox to view the deployed web applications.
Example: Deploying WordPress
- In the VM's Terminal, get a root shell and SSH into a participant's container:
```
# Become root (no password needed)
sudo -i

# Connect to participant 1 (hopper)
connect hopper

# Or direct SSH
ssh root@192.168.100.11
```
- Inside the container, deploy a WordPress site with abra:
```
abra app new wordpress -S --domain=blog.hopper.local
abra app deploy blog.hopper.local
```
- In the VM's Firefox, navigate to http://blog.hopper.local. You will see the WordPress installation screen.

Available Helper Commands

sudo containers    # List all 15 containers with IPs
sudo logs          # Show setup logs for all containers  
sudo recipes       # Display available Co-op Cloud recipes
sudo help          # Show all available commands

🌐 Cloud Deployment

The cloud environment creates 15 production servers:

# Set required environment variables
export HCLOUD_TOKEN="your_hetzner_token"
export HETZNER_DNS_TOKEN="your_dns_token"  
export DNS_ZONE_ID="your_zone_id"

# Deploy all 15 servers
make deploy-cloud

# Check server status
make status-cloud

Each server is accessible at:

hopper.codecrispi.es
curie.codecrispi.es
lovelace.codecrispi.es
... (15 total)

💾 USB Workshop Environment

Build bootable USB drives for participants:

# Build the ISO
make build-usb

# Flash to USB drive (replace /dev/sdX with your device)
make flash-usb USB_DEVICE=/dev/sdb

The USB environment includes:

Pre-configured SSH client
connect <name> command to SSH into assigned servers
recipes command showing available Co-op Cloud applications
Workshop-specific networking and WiFi helpers

🧹 Cleanup

# Clean local build artifacts
make clean

# Destroy Hetzner cloud infrastructure  
make destroy-cloud

# To stop the local VM, simply close its window

🔑 Prerequisites

SSH Key: Ed25519 key at ~/.ssh/id_ed25519.pub
```
ssh-keygen -t ed25519
```
Nix: NixOS or Nix package manager with flakes enabled
Cloud Tokens: Hetzner Cloud API token for deployment
Resources: For local VM: 8GB+ RAM recommended (runs 15 containers)

🎯 Workshop Flow

Preparation: Deploy cloud infrastructure with make deploy-cloud
Distribution: Flash USB drives for participants with make build-usb && make flash-usb
Workshop: Participants boot from USB and connect to their assigned cloud servers
Development: Use local VM (make local-vm-run) for testing and development

The architecture ensures participants get identical environments whether connecting from USB boot drives to cloud servers, or testing locally in the development VM.

4.9 KiB Raw Blame History