c006d03075
- Update deployment scripts to use Docker with static files baked in - Remove host volume mount in favor of self-contained Docker image - Add verification script to ensure correct content is deployed - Update documentation to reflect new deployment architecture - Ensure build process produces correct output without manual copying Closes ELF-268 Co-Authored-By: Paperclip <noreply@paperclip.ing>
1.9 KiB
1.9 KiB
Deployment Checklist
Quick reference for deploying the hatch.surf homepage.
Pre-Deployment
- Changes are in
site/directory - All assets load locally
- No console errors in browser
- Mobile responsive design works
Deployment Methods
1. Automated (Recommended)
Push to main branch:
git push origin main
GitHub Actions will automatically:
- Deploy to GitHub Pages
- Build Docker image and deploy to hatch.surf server
2. Manual (From Remote Machine)
# Dry run first
./scripts/deploy-site.sh --dry-run
# Deploy
./scripts/deploy-site.sh
3. Docker Commands (On Server)
# Build image
docker build -t hatch-homepage:latest ./site
# Run container
docker run -d \
--name hatch-homepage \
--restart unless-stopped \
-p 127.0.0.1:3000:80 \
hatch-homepage:latest
# Check status
docker ps | grep hatch-homepage
Post-Deployment Verification
- https://hatch.surf loads (HTTP 200)
- Anime.js magical background renders
- Scroll animations work (data-animate attributes)
- All static assets load:
- style.css
- main.js
- brand/og/default.png
- Google Fonts (Inter, JetBrains Mono)
- Mobile viewport works (390px width)
- No console errors
Troubleshooting
Container Not Running
# Check container status
docker ps -a | grep hatch-homepage
# View logs
docker logs hatch-homepage
# Restart container
docker restart hatch-homepage
Assets Not Loading
# Check files in container
docker exec hatch-homepage ls -la /usr/share/nginx/html/
# Rebuild image
docker build -t hatch-homepage:latest ./site
docker restart hatch-homepage
SSL Issues
Caddy handles TLS automatically. Check Caddy status:
docker ps | grep caddy
docker logs caddy