refactor: clean up workshop for Science in the City event

- Update workshop name from 'CODE CRISPIES' to 'SCIENCE IN THE CITY'
- Remove all Hetzner cloud deployment references and commands
- Focus documentation on local USB/VM workshop environment
- Remove cloud server connection functionality
- Update WiFi credentials for workshop network
- Clean up AGENTS.md to reflect local-only development workflow
- Remove misleading cloud infrastructure references
- Update help commands and learning flow for local practice only

This commit prepares the workshop materials for the Science in the City event,
focusing exclusively on local Co-op Cloud deployment practice without cloud
infrastructure dependencies.
This commit is contained in:
2025-09-16 19:02:03 +02:00
parent c996924055
commit eaf7667728
4 changed files with 65 additions and 77 deletions

View File

@@ -1,6 +1,6 @@
# 🚀 DIGITAL INDEPENDENCE DAY Workshop Infrastructure
# 🚀 SCIENCE IN THE CITY Workshop Infrastructure
Single-participant learning environments with local practice and cloud deployment capabilities.
Single-participant learning environments for hands-on Co-op Cloud deployment practice.
## 🚀 Quick Start
@@ -12,9 +12,8 @@ make vm
make usb-build
make usb-flash USB_DEVICE=/dev/sdX
# 3. Deploy cloud infrastructure
export HCLOUD_TOKEN="your_token"
make deploy-cloud
# 3. Test your USB build
make usb-test
```
## 🎯 Learning Flow
@@ -27,12 +26,10 @@ deploy wordpress # Deploy locally
browser wordpress # Open directly in Firefox
```
### Cloud Deployment
### Local Practice Only
```bash
connect hopper # SSH to cloud server
# Same abra commands work here
abra app new wordpress -S --domain=blog.hopper.codecrispi.es
abra app deploy blog.hopper.codecrispi.es
# Focus on local development and testing
# All deployment happens locally on your USB/VM
```
## 🗃️ Architecture
@@ -41,7 +38,7 @@ abra app deploy blog.hopper.codecrispi.es
- **USB Boot**: Bootable NixOS with Docker + abra for hands-on learning
- **Local VM**: Identical environment for development/testing
- **Cloud Servers**: 15 production servers (hopper, curie, lovelace, etc.)
- **Local Environment**: Self-contained workshop environment
- **Wildcard DNS**: `*.workshop.local` resolves to `127.0.0.1` via dnsmasq
## 💾 USB Environment
@@ -60,14 +57,13 @@ make usb-build
make usb-flash USB_DEVICE=/dev/sdb
```
## 🌐 Cloud Deployment
## 🧪 Testing & Validation
Creates 15 Hetzner VMs at `{name}.codecrispi.es`:
Test your workshop environment:
```bash
export HCLOUD_TOKEN="your_token"
make deploy-cloud
make status-cloud # Check health
make usb-test # Test ISO in QEMU
make status-local # Check local services
```
## 🖥️ Local Development
@@ -131,7 +127,7 @@ Based on Co-op Cloud with quality scoring:
- `recipes` - Show complete Co-op Cloud catalog
- `deploy <app>` - Deploy locally with tab completion
- `browser [app]` - Launch Firefox [to specific app]
- `connect <server>` - SSH to cloud server with tab completion
- `connect <server>` - SSH connection helper (local use only)
- `desktop` - Start GUI session
- `help` - Show all commands and debug info
@@ -146,15 +142,15 @@ browser # Opens Firefox with blank page
# Use tab completion
deploy <TAB> # Shows all available recipes
connect <TAB> # Shows all available servers
browser <TAB> # Shows deployed applications
```
## 🔧 Prerequisites
- Nix with flakes enabled
- SSH key at `~/.ssh/id_ed25519.pub`
- HCLOUD_TOKEN for cloud deployment
- 2GB+ RAM for VM testing
- USB drive (8GB+) for workshop distribution
## 🛠️ Development Tools
@@ -170,7 +166,6 @@ make opencode # Start opencode in dev shell
```bash
make clean # Clean build artifacts (./build/ and ./result/)
make destroy-cloud # Cloud infrastructure
```
## 🔍 Troubleshooting