f357ecd551
Create deployment.md how-to page covering local preview, GitHub Pages, Netlify, Cloudflare Pages, and generic static hosts. Add cross-links from homepage and getting-started Next Steps. Reference security.md for CSP headers.
76 lines
1.9 KiB
Markdown
76 lines
1.9 KiB
Markdown
---
|
|
title: Deployment
|
|
description: Deploy your sukr site to any static hosting platform
|
|
weight: 1
|
|
---
|
|
|
|
sukr builds your site to `public/`. This directory contains self-contained static HTML, CSS, and assets — no server-side runtime needed. Upload it anywhere that serves static files.
|
|
|
|
## Local Preview
|
|
|
|
Preview your site locally before deploying:
|
|
|
|
```bash
|
|
cd public
|
|
python3 -m http.server 8000
|
|
```
|
|
|
|
Open `http://localhost:8000` in your browser.
|
|
|
|
## GitHub Pages
|
|
|
|
1. Push your repository to GitHub
|
|
2. Build your site: `sukr`
|
|
3. Deploy the `public/` directory using one of:
|
|
- **GitHub Actions** — add a workflow that runs `sukr` and deploys `public/` to Pages
|
|
- **Manual** — push the `public/` contents to a `gh-pages` branch
|
|
|
|
Example workflow (`.github/workflows/deploy.yml`):
|
|
|
|
```yaml
|
|
name: Deploy
|
|
on:
|
|
push:
|
|
branches: [main]
|
|
jobs:
|
|
deploy:
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
- run: cargo install --path .
|
|
- run: sukr
|
|
- uses: peaceiris/actions-gh-pages@v4
|
|
with:
|
|
github_token: ${{ secrets.GITHUB_TOKEN }}
|
|
publish_dir: ./public
|
|
```
|
|
|
|
## Netlify
|
|
|
|
1. Connect your repository in the Netlify dashboard
|
|
2. Set build command: `cargo install --path . && sukr`
|
|
3. Set publish directory: `public`
|
|
|
|
Netlify detects changes and rebuilds automatically on push.
|
|
|
|
## Cloudflare Pages
|
|
|
|
1. Connect your repository in the Cloudflare Pages dashboard
|
|
2. Set build command: `cargo install --path . && sukr`
|
|
3. Set build output directory: `public`
|
|
|
|
## Any Static Host
|
|
|
|
For any host that serves static files (S3, DigitalOcean Spaces, a VPS):
|
|
|
|
```bash
|
|
sukr
|
|
rsync -avz public/ user@server:/var/www/mysite/
|
|
```
|
|
|
|
Or use `scp`, `aws s3 sync`, or your host's CLI tool.
|
|
|
|
## Security Headers
|
|
|
|
sukr outputs zero JavaScript, which means you can set a strict Content Security Policy that blocks all script execution. See [Security](security.html) for recommended CSP headers and platform-specific configuration.
|