Deployment

Deploy your SystemPrompt application to the cloud with a single command. The deployment process builds a Docker image, pushes it to the registry, and starts your services.

Deployment Pipeline

┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
│ Validate │───▶│  Build   │───▶│   Push   │───▶│  Deploy  │───▶│   Sync   │
│  Config  │    │  Image   │    │ Registry │    │ Services │    │ Secrets  │
└──────────┘    └──────────┘    └──────────┘    └──────────┘    └──────────┘

Basic Deployment

Deploy to Production

systemprompt cloud deploy --profile production

Deploy with Options

# Skip building (use existing image)
systemprompt cloud deploy --profile production --skip-build

# Force rebuild
systemprompt cloud deploy --profile production --force

# Dry run (show what would happen)
systemprompt cloud deploy --profile production --dry-run

What Happens During Deploy

1. Validate - Check local configuration for errors
2. Build - Create Docker image with compiled Rust code
3. Push - Upload image to SystemPrompt registry
4. Deploy - Start new containers, drain old ones
5. Sync - Push secrets and configuration to cloud database

Deployment Options

Flag	Description
--profile <name>	Profile to deploy (required)
--skip-build	Skip Docker build, use existing image
--force	Force rebuild even if no changes
--dry-run	Show what would happen without executing
--tag <tag>	Custom image tag

Checking Status

# Current deployment status
systemprompt cloud status

# Deployment logs
systemprompt cloud logs

# Follow logs
systemprompt cloud logs -f

CI/CD Integration

GitHub Actions Example

name: Deploy to Production
on:
  push:
    branches: [main]

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

      - name: Install SystemPrompt CLI
        run: cargo install systemprompt

      - name: Login to Cloud
        run: systemprompt cloud auth login --token ${{ secrets.SP_TOKEN }}

      - name: Deploy
        run: systemprompt cloud deploy --profile production

GitLab CI Example

deploy:
  stage: deploy
  script:
    - cargo install systemprompt
    - systemprompt cloud auth login --token $SP_TOKEN
    - systemprompt cloud deploy --profile production
  only:
    - main

Rollback Strategies

Immediate Rollback

# Rollback to previous deployment
systemprompt cloud rollback

# Rollback to specific version
systemprompt cloud rollback --version v1.2.3

View Deployment History

systemprompt cloud history

Troubleshooting

Issue	Cause	Solution
Build fails	Rust compilation error	Check cargo build locally
Push fails	Authentication expired	Run systemprompt cloud auth login
Deploy fails	Resource limits	Check cloud dashboard for quotas
Sync fails	Database schema mismatch	Run migrations first

Quick Reference

Task	Command
Deploy	systemprompt cloud deploy --profile <name>
Status	systemprompt cloud status
Logs	systemprompt cloud logs -f
Rollback	systemprompt cloud rollback
History	systemprompt cloud history