Prepare backend for Railway deployment

- Create separate backend directory with all necessary files
- Add Railway-specific Dockerfile with Docker CLI support
- Configure railway.json for deployment settings
- Add comprehensive deployment documentation
- Update package.json with Railway build commands
- Frontend already configured to use NEXT_PUBLIC_WS_URL

Ready for Railway deployment - just need to:
1. Create Railway project from backend/ directory
2. Set FRONTEND_URL environment variable
3. Deploy frontend to Netlify with NEXT_PUBLIC_WS_URL

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: alanops

DEPLOY-RAILWAY.md

@@ -0,0 +1,69 @@
+# Deploying to Railway + Netlify
+
+This guide shows how to deploy the DevOps Learn platform using Railway for the backend and Netlify for the frontend.
+
+## Architecture
+
+- **Frontend**: Static Next.js site deployed to Netlify
+- **Backend**: Node.js WebSocket server deployed to Railway with Docker support
+
+## Step 1: Deploy Backend to Railway
+
+1. **Create Railway Account**: Go to [railway.app](https://railway.app) and sign up
+2. **Create New Project**: Click "New Project" → "Deploy from GitHub repo"
+3. **Connect Repository**: Select your backend repository
+4. **Configure Environment Variables**:
+   ```
+   FRONTEND_URL=https://your-netlify-site.netlify.app
+   NODE_ENV=production
+   ```
+5. **Deploy**: Railway will automatically detect the Dockerfile and deploy
+
+## Step 2: Deploy Frontend to Netlify
+
+1. **Build Settings**:
+   - Build command: `npm run build`
+   - Publish directory: `out`
+   
+2. **Environment Variables**:
+   ```
+   NEXT_PUBLIC_WS_URL=wss://your-railway-app.railway.app
+   ```
+
+3. **Deploy**: Connect your GitHub repo and deploy
+
+## Step 3: Update CORS
+
+After deployment, update the Railway backend environment variable:
+```
+FRONTEND_URL=https://your-actual-netlify-domain.netlify.app
+```
+
+## Local Development
+
+1. **Backend**:
+   ```bash
+   cd backend
+   npm install
+   npm run dev
+   ```
+
+2. **Frontend**:
+   ```bash
+   npm install
+   NEXT_PUBLIC_WS_URL=ws://localhost:3001 npm run dev
+   ```
+
+## Cost Breakdown
+
+- **Railway**: $5/month free credit (should cover small projects)
+- **Netlify**: Free tier (100GB bandwidth, unlimited sites)
+- **Total**: $0/month for starter projects
+
+## Benefits
+
+- ✅ No time limits (unlike Heroku)
+- ✅ Auto-scaling
+- ✅ Docker support for scenarios
+- ✅ WebSocket support
+- ✅ Free tier generous enough for learning projects

backend/Dockerfile

@@ -0,0 +1,28 @@
+# Multi-stage build for Railway deployment
+FROM node:18-alpine AS base
+
+# Install Docker CLI for scenario management
+RUN apk add --no-cache docker-cli
+
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install dependencies
+RUN npm ci --only=production
+
+# Copy source code
+COPY . .
+
+# Build TypeScript
+RUN npm run build
+
+# Expose the port Railway expects
+EXPOSE $PORT
+
+# Set environment variables
+ENV NODE_ENV=production
+
+# Start the server
+CMD ["npm", "start"]

backend/Makefile

@@ -0,0 +1,57 @@
+.PHONY: help install dev build start stop clean test lint scenario-build
+
+help:
+	@echo "DevOps Learning Platform - Available commands:"
+	@echo "  make install        - Install dependencies"
+	@echo "  make dev           - Start development environment"
+	@echo "  make build         - Build production images"
+	@echo "  make start         - Start production environment"
+	@echo "  make stop          - Stop all services"
+	@echo "  make clean         - Clean up containers and volumes"
+	@echo "  make test          - Run tests"
+	@echo "  make lint          - Run linting"
+	@echo "  make scenario-build - Build all scenario images"
+
+install:
+	npm install
+	cd src/server && npm install
+
+dev:
+	docker-compose up -d
+	@echo "Frontend: http://localhost:3000"
+	@echo "Backend: http://localhost:3001"
+
+build:
+	docker-compose build
+	$(MAKE) scenario-build
+
+start:
+	docker-compose up -d --build
+
+stop:
+	docker-compose down
+
+clean:
+	docker-compose down -v
+	docker rmi $$(docker images -q 'devopslearn/*') 2>/dev/null || true
+
+test:
+	npm test
+	cd src/server && npm test
+
+lint:
+	npm run lint
+	npm run typecheck
+
+scenario-build:
+	@echo "Building scenario base image..."
+	docker build -t devopslearn/scenario-base:latest -f docker/Dockerfile.scenario-base .
+	@echo "Building Keycloak CrashLoop scenario..."
+	docker build -t devopslearn/scenario-keycloak-crashloop:latest -f scenarios/kubernetes/keycloak-crashloop/Dockerfile scenarios/kubernetes/keycloak-crashloop/
+	@echo "Scenario images built successfully!"
+
+logs:
+	docker-compose logs -f
+
+ps:
+	docker-compose ps

backend/README.md

@@ -0,0 +1,39 @@
+# DevOps Learn - Backend
+
+WebSocket server for the DevOps Learning Platform that manages interactive scenario containers.
+
+## Features
+
+- WebSocket server for real-time terminal communication
+- Docker container management for scenarios
+- Kubernetes scenario support with kind clusters
+- Automatic Docker network creation
+- Image validation and error handling
+
+## Railway Deployment
+
+This backend is designed to be deployed on Railway with Docker support.
+
+### Environment Variables
+
+- `PORT` - Server port (automatically set by Railway)
+- `FRONTEND_URL` - Frontend URL for CORS (set to your Netlify URL)
+
+### Deployment Steps
+
+1. Connect this repository to Railway
+2. Set environment variables
+3. Deploy automatically
+
+## Local Development
+
+```bash
+npm install
+npm run dev
+```
+
+## Building Scenario Images
+
+```bash
+make scenario-build
+```

backend/docker/Dockerfile.backend

@@ -0,0 +1,24 @@
+FROM node:18-alpine
+
+# Install Docker CLI
+RUN apk add --no-cache docker-cli
+
+WORKDIR /app
+
+# Copy package files
+COPY src/server/package*.json ./
+
+# Install dependencies
+RUN npm ci
+
+# Copy server files
+COPY src/server ./
+
+# Create TypeScript config for server
+RUN echo '{"compilerOptions":{"target":"es2020","module":"commonjs","outDir":"./dist","strict":true,"esModuleInterop":true,"skipLibCheck":true,"forceConsistentCasingInFileNames":true}}' > tsconfig.json
+
+# Expose port
+EXPOSE 3001
+
+# Start server
+CMD ["npm", "run", "dev"]

backend/docker/Dockerfile.frontend

@@ -0,0 +1,23 @@
+FROM node:18-alpine
+
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+COPY tsconfig.json ./
+COPY next.config.js ./
+COPY tailwind.config.js ./
+COPY postcss.config.js ./
+
+# Install dependencies
+RUN npm ci
+
+# Copy source files
+COPY src ./src
+COPY public ./public
+
+# Expose port
+EXPOSE 3000
+
+# Start development server
+CMD ["npm", "run", "dev"]

backend/docker/Dockerfile.scenario-base

@@ -0,0 +1,32 @@
+FROM ubuntu:22.04
+
+RUN apt-get update && apt-get install -y curl gnupg
+RUN curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.28/deb/Release.key | gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
+RUN echo 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.28/deb/ /' | tee /etc/apt/sources.list.d/kubernetes.list
+
+# Install base tools
+RUN apt-get update && apt-get install -y     curl     wget     git     vim     nano     htop     net-tools     dnsutils     traceroute     telnet     jq     python3     python3-pip     nodejs     npm     docker.io     kubectl     lsb-release     unzip     && rm -rf /var/lib/apt/lists/*
+
+# Install Terraform
+RUN wget -O- https://apt.releases.hashicorp.com/gpg | apt-key add - \
+    && echo "deb [arch=amd64] https://apt.releases.hashicorp.com $(lsb_release -cs) main" > /etc/apt/sources.list.d/hashicorp.list \
+    && apt-get update && apt-get install -y terraform
+
+# Install AWS CLI
+RUN curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" \
+    && unzip awscliv2.zip \
+    && ./aws/install \
+    && rm -rf awscliv2.zip aws
+
+# Install Helm
+RUN curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
+
+# Create scenario user
+RUN useradd -m -s /bin/bash devops
+USER devops
+WORKDIR /home/devops
+
+# Set up shell prompt
+RUN echo 'PS1="\\[\\033[01;32m\\]devops@dojo\\[\\033[00m\\]:\\[\\033[01;34m\\]\\w\\[\\033[00m\\]\\$ "' >> ~/.bashrc
+
+CMD ["/bin/bash"]