public/malta-workshop
2
0
Fork 0
Code Pull Requests Activity
Files
c2003b349ebcb5bbea46a98a9908194d214bd8bb
malta-workshop/README.md
Michael Czechowski 625c970af0 switch to xcfe
2025-08-12 00:30:50 +02:00

2.8 KiB
Raw Blame History

🍪 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
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)

  • [cite_start]What: Hetzner VMs named hopper.codecrispi.es, curie.codecrispi.es, etc. [cite: 52]
  • Purpose: The live environment for workshop participants.

2. USB Boot (Workshop)

  • [cite_start]What: A bootable NixOS live environment. [cite: 4]
  • Purpose: Used by participants to connect to their cloud servers. [cite_start]It includes helper functions like connect hopper. [cite: 12]

3. Local (Development)

  • What: A self-contained Virtual Machine (VM) that runs on your local computer.
  • Purpose: The VM hosts simulated participant containers (e.g., hopper.local) and includes a lightweight desktop with a web browser, providing a perfect, isolated environment to test the entire workshop flow without needing cloud servers.

🔧 Local Development Workflow

  1. Start the VM Run the following command. A new window will open and automatically boot into a lightweight desktop.

    make local-vm-run

  2. 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.

  3. Example: Deploying WordPress

    • In the VM's Terminal, get a root shell and SSH into the first participant's container: 
      # Become root (no password needed)
sudo -i

# Connect to participant 1 (hopper.local)
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 the address http://blog.hopper.local. You will see the WordPress installation screen.

🧹 Cleanup

# Clean local build artifacts
make clean

# Destroy Hetzner cloud infrastructure
make destroy-cloud

# To stop the local VM, simply close its window.