Deployment¶

Run 2.0 supports multiple deployment targets for your WASI components.

Deployment Targets¶

Local Deployment¶

Package components for local deployment:

run v2 deploy --target local

This creates a deployment bundle:

dist/deploy/
├── deploy.json       # Manifest with checksums
├── run.toml          # Configuration
├── api.wasm          # Component binaries
└── worker.wasm

Custom Output¶

run v2 deploy --target local --output ./release

Deploy Profile¶

Configure in run.toml:

[deploy.local]
target_type = "local"

[deploy.local.options]
output_dir = "dist/release"

Use:

run v2 deploy --profile local

Registry Deployment¶

Publish to the component registry:

# Same as `run v2 publish`
run v2 deploy --target registry --build

See Registry for details.

Edge Deployment¶

Deploy to serverless edge platforms.

Supported Providers¶

Cloudflare Workers¶

1. Set up credentials:

export CLOUDFLARE_API_TOKEN=your-token
export CLOUDFLARE_ACCOUNT_ID=your-account-id

1. Configure run.toml:

[deploy.edge]
target_type = "edge"
provider = "cloudflare"

[deploy.edge.options]
workers_dev = true
# Or specify a zone:
# zone_id = "your-zone-id"
# route = "example.com/*"

1. Deploy:

run v2 build --release
run v2 deploy --target edge --provider cloudflare

Deploy Profiles¶

Define multiple deployment configurations:

[deploy.staging]
target_type = "edge"
provider = "cloudflare"

[deploy.staging.options]
workers_dev = true
name_suffix = "-staging"

[deploy.production]
target_type = "edge"
provider = "cloudflare"

[deploy.production.options]
zone_id = "abc123"
route = "api.example.com/*"

Deploy to staging:

run v2 deploy --profile staging

Deploy to production:

run v2 deploy --profile production

CI/CD Integration¶

GitHub Actions¶

name: Deploy

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable

      - name: Install Run
        run: cargo install run-kit --features v2

      - name: Build
        run: run v2 build --release --reproducible

      - name: Deploy to Registry
        env:
          RUN_AUTH_TOKEN: ${{ secrets.REGISTRY_TOKEN }}
        run: run v2 publish

      - name: Deploy to Edge
        env:
          CLOUDFLARE_API_TOKEN: ${{ secrets.CF_TOKEN }}
          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CF_ACCOUNT }}
        run: run v2 deploy --target edge --provider cloudflare

Reproducible Builds¶

For consistent CI/CD builds:

1. Lock toolchains:

run v2 toolchain sync
git add run.lock.toml
git commit -m "Lock toolchain versions"

1. Build with reproducibility:

run v2 build --reproducible

1. Verify:

run v2 verify

Build Before Deploy¶

Always build before deploying:

# Explicit build
run v2 build --release
run v2 deploy --target edge

# Or use --build flag
run v2 deploy --target edge --build

Component Selection¶

Deploy specific components:

# Deploy only the API component
run v2 deploy --target edge --component api

Deployment Manifest¶

The deploy.json manifest includes:

{
  "project": "my-app",
  "version": "1.0.0",
  "target": "local",
  "created_at": 1704067200,
  "components": [
    {
      "name": "api",
      "path": "api.wasm",
      "sha256": "abc123...",
      "size": 524288,
      "language": "rust"
    }
  ]
}

Use this for:

• Deployment verification
• Rollback tracking
• Audit logging