DevOps & CI/CD

# === Setup (do once) ===
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

# === Start a project ===
git init           # initialize git in current folder
git clone https://github.com/user/repo.git  # copy existing repo

# === Daily workflow ===
git status         # see changed files
git add .          # stage ALL changes
git add file.html  # stage specific file
git commit -m "feat: add contact form"  # save snapshot
git push origin main  # upload to GitHub
git pull           # download latest changes

# === Branching (work without breaking main) ===
git checkout -b feature/dark-mode  # create + switch branch
git checkout main                  # switch back
git merge feature/dark-mode        # merge into main
git branch -d feature/dark-mode    # delete branch

# === Undo mistakes ===
git restore file.html   # undo unsaved changes
git revert HEAD         # undo last commit (safe)
git log --oneline       # see commit history
git stash               # temporarily save changes
git stash pop           # restore stashed changes

# This file lives in .github/workflows/deploy.yml

name: Deploy to Production

# Trigger: run this when code is pushed to main branch
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  # Job 1: Test & Build
  build:
    runs-on: ubuntu-latest

    steps:
      # 1. Check out the code
      - uses: actions/checkout@v4

      # 2. Set up Node.js
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'

      # 3. Install dependencies
      - run: npm ci

      # 4. Run tests
      - run: npm test

      # 5. Build production bundle
      - run: npm run build

      # 6. Upload build artifacts
      - uses: actions/upload-artifact@v4
        with:
          name: dist
          path: dist/

  # Job 2: Deploy (only on main, after build passes)
  deploy:
    needs: build
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'

    steps:
      - uses: actions/checkout@v4

      # Deploy to Vercel using secret token
      - uses: amondnet/vercel-action@v25
        with:
          vercel-token: ${{ secrets.VERCEL_TOKEN }}
          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
          vercel-args: '--prod'

// Cloudflare Worker: runs at the edge worldwide
// Deploy with: wrangler deploy

export default {
  async fetch(request, env) {
    const url = new URL(request.url);

    // Route: API endpoint at the edge
    if (url.pathname === '/api/geo') {
      // Cloudflare gives you the user's location for free!
      const { country, city, latitude, longitude } = request.cf;
      return Response.json({ country, city, latitude, longitude });
    }

    // Redirect old URLs
    if (url.pathname === '/old-page') {
      return Response.redirect('/new-page', 301);
    }

    // Add security headers to all responses
    const response = await fetch(request);
    const newResponse = new Response(response.body, response);
    newResponse.headers.set('X-Frame-Options', 'DENY');
    newResponse.headers.set('X-Content-Type-Options', 'nosniff');
    newResponse.headers.set('Referrer-Policy', 'strict-origin');
    return newResponse;
  }
};

# Install Wrangler (Cloudflare's CLI)
npm install -g wrangler

# Login to Cloudflare
wrangler login

# Create a new Worker project
wrangler init my-worker

# Run locally for testing
wrangler dev

# Deploy to production edge network
wrangler deploy

# Deploy via Wrangler CLI
wrangler pages deploy ./dist

# Or connect via GitHub (recommended):
# Cloudflare Dashboard → Pages → Create a project
# → Connect to Git → Select repo → Configure build:
#   Build command: npm run build
#   Build output directory: dist
# → Save and Deploy

# Every push to main auto-deploys production
# Every PR gets a unique preview URL

# Start from official Node.js image
FROM node:20-alpine

# Set working directory inside container
WORKDIR /app

# Copy package files first (layer caching)
COPY package*.json ./

# Install dependencies
RUN npm ci --only=production

# Copy rest of source code
COPY . .

# Tell Docker which port this app uses
EXPOSE 3000

# Command to run when container starts
CMD ["node", "server.js"]

# Build image from Dockerfile
docker build -t my-app:latest .

# Run container locally
docker run -p 3000:3000 my-app:latest

# Run with environment variables
docker run -p 3000:3000 --env-file .env my-app:latest

# Push to Docker Hub (free)
docker tag my-app:latest yourusername/my-app:latest
docker push yourusername/my-app:latest

# Deploy on any cloud: Railway, Render, Fly.io
# just point at your Docker Hub image