provisioning-outreach/presentations/pres-prvng/demos/README.md

1 line
7.9 KiB
Markdown
Raw Normal View History

# Provisioning Platform - Live Demonstration Scripts\n\nComplete, ready-to-run demonstration scripts for presenting the Provisioning Platform to developers and decision makers.\n\n## Overview\n\nThree demonstration scenarios showing core capabilities:\n\n1. **Server Creation** (30 seconds) - Configuration validation and cost estimation\n2. **Kubernetes Deployment** (1 minute) - Type-safe configuration and parallel execution\n3. **Batch Workflow** (2 minutes) - Multi-cloud orchestration with real-time progress\n\n**Total Demo Duration**: ~3.5 minutes introduction + demonstrations\n\n## Prerequisites\n\n- Bash shell (or compatible)\n- `provisioning` CLI installed (or modify scripts to use paths)\n- Optional: Real infrastructure (UpCloud + AWS accounts) for actual deployment\n- **Note**: All scripts use `--check` flag for dry-runs (no actual changes)\n\n## Running the Demonstrations\n\n### Quick Start (Recommended)\n\n```bash\n# Make scripts executable\nchmod +x demos/*.sh\n\n# Run in sequence\n./demos/01-server-creation-demo.sh\n./demos/02-kubernetes-deployment-demo.sh\n./demos/03-batch-workflow-demo.sh\n```\n\n### Individual Demonstrations\n\n**Demo 1: Server Creation**\n\n```bash\n./demos/01-server-creation-demo.sh\n```\n\n- Shows: Configuration validation, cost estimation, deployment planning\n- Time: ~30 seconds\n- Audience: All levels\n\n**Demo 2: Kubernetes Deployment**\n\n```bash\n./demos/02-kubernetes-deployment-demo.sh\n```\n\n- Shows: KCL schema validation, dependency resolution, parallel execution\n- Time: ~1 minute\n- Audience: Developers, DevOps\n\n**Demo 3: Batch Multi-Cloud Workflow**\n\n```bash\n./demos/03-batch-workflow-demo.sh\n```\n\n- Shows: Multi-provider orchestration, real-time monitoring, audit trail\n- Time: ~2 minutes\n- Audience: Architects, DevOps, CTOs\n\n## Demonstration Flow\n\n### For 15-Minute Developer Intro + Live Demo\n\n1. **Show presentation** (demo-intro.md): 10 minutes\n2. **Run live demos** (scripts below): ~3.5 minutes\n3. **Q&A**: 2 minutes\n\n**Total**: 15-17 minutes\n\n### For 30-Minute Technical Talk\n\n1. **Show presentation** (talk.md): 20 minutes\n2. **Run 1-2 live demos**: 5-7 minutes\n3. **Q&A**: 3-5 minutes\n\n**Total**: 28-32 minutes\n\n### For Workshop Sessions\n\n1. **Show presentation** (workshop.md): 60 minutes\n2. **Run all demos with explanation**: 15 minutes\n3. **Hands-on exercises**: 45 minutes\n4. **Q&A and discussion**: 20 minutes\n\n**Total**: 140 minutes (2+ hours)\n\n## How to Use in Presentations\n\n### In Slidev/reveal.js\n\nWhen showing demo slides, you can:\n\n1. **Split screen**: Show presentation on left, run script on right\n2. **Full screen**: Run script with presentation window minimized\n3. **Record**: Run script and record terminal output for video playback\n\n### Terminal Setup\n\nFor best visual effect:\n\n```bash\n# Maximize terminal\n# Increase font size for visibility\n# Light terminal background recommended\n# Run with: bash demos/01-server-creation-demo.sh\n```\n\n### Real-Time Execution\n\nIf you have actual provisioning infrastructure:\n\n```bash\n# Replace simulation with actual command\n# provisioning server create web-01 --check\n\n# Show actual output from your environment\n```\n\n## Customizing Demonstrations\n\n### Modify for Your Infrastructure\n\nEdit scripts to reference your actual:\n\n- Infrastructure names (`--infra demo` → `--infra production`)\n- Server names, zones, plans\n- Provider configurations\n- Cost figures\n\nExample:\n\n```bash\n# Change from\n--infra demo\n# to\n--infra my-company-prod\n```\n\n### Add Your Branding\n\nEdit banner text:\n\n```bash\necho "╔════════════════════════════════════════════════════════╗"\necho "║ Your Company - Demo: Server Creation ║"\n```\n\n### Include Real Examples\n\nReplace simulation data with actual outputs:\n\n```bash\n# Option 1: Redirect real command output\nprovisioning server create web-01 --check >> actual_output.txt\n\n# Option 2: Copy ou