Sevalla GitHub Action

Deploy and promote Sevalla apps and static sites from GitHub Actions.

---

A GitHub Action that triggers deployments and promotions on Sevalla infrastructure. Supports application deployments (via API token or deploy hook), static site deployments, and pipeline promotions with optional polling until completion.

Quick Start

- uses: sevalla-hosting/sevalla-deploy@v2.0.0
  with:
    action: deploy-app
    sevalla-token: ${{ secrets.SEVALLA_TOKEN }}
    app-id: your-app-id
    wait-for-finish: true

Get your API key from app.sevalla.com/api-keys.

Inputs

Name	Required	Description
action	Yes	deploy-app, promote-app, or deploy-static-site
sevalla-token	Yes*	Sevalla API token
app-id	—	Application ID (for deploy-app)
static-site-id	—	Static site ID (for deploy-static-site)
pipeline-id	—	Pipeline ID (for promote-app)
source-app-id	—	Source application ID (for promote-app)
target-app-ids	—	Comma-separated target app IDs (for promote-app)
branch	—	Git branch to deploy
docker-image	—	Docker image to deploy
is-restart	—	Restart without building (true/false, default false)
wait-for-finish	—	Poll until deployment completes (true/false, default false)
deploy-hook-url	—	Deploy hook URL (alternative to sevalla-token + app-id)

*Not required when using deploy-hook-url without wait-for-finish.

Outputs

Name	Description
deployment-id	Deployment ID (for deploy-app and deploy-static-site)
deployment-ids	Deployment IDs (for promote-app)

Examples

Deploy an App

jobs:
  deploy-app:
    runs-on: ubuntu-latest
    steps:
      - uses: sevalla-hosting/sevalla-deploy@v2.0.0
        with:
          action: deploy-app
          sevalla-token: ${{ secrets.SEVALLA_TOKEN }}
          app-id: your-app-id
          branch: main
          wait-for-finish: true

Deploy via Deploy Hook

jobs:
  deploy-app:
    runs-on: ubuntu-latest
    steps:
      - uses: sevalla-hosting/sevalla-deploy@v2.0.0
        with:
          action: deploy-app
          sevalla-token: ${{ secrets.SEVALLA_TOKEN }}
          deploy-hook-url: https://api.sevalla.com/hooks/xyz
          wait-for-finish: true

Promote an App

jobs:
  promote-app:
    runs-on: ubuntu-latest
    steps:
      - uses: sevalla-hosting/sevalla-deploy@v2.0.0
        with:
          action: promote-app
          sevalla-token: ${{ secrets.SEVALLA_TOKEN }}
          pipeline-id: your-pipeline-id
          source-app-id: staging-app-id
          target-app-ids: production-app-id
          wait-for-finish: true

Deploy a Static Site

jobs:
  deploy-static-site:
    runs-on: ubuntu-latest
    steps:
      - uses: sevalla-hosting/sevalla-deploy@v2.0.0
        with:
          action: deploy-static-site
          sevalla-token: ${{ secrets.SEVALLA_TOKEN }}
          static-site-id: your-static-site-id
          branch: main
          wait-for-finish: true

How It Works

GitHub Actions Workflow
       │
       │  action: deploy-app | promote-app | deploy-static-site
       ▼
┌──────────────────────────────────────────────────────────────────┐
│  sevalla-deploy                                                  │
│                                                                  │
│  deploy-app          POST /v3/applications/{id}/deployments      │
│  promote-app         POST /v3/pipelines/{id}/promote             │
│  deploy-static-site  POST /v3/static-sites/{id}/deployments      │
│                                                                  │
│  wait-for-finish     GET  /v3/.../deployments/{deployment_id}    │
└──────────────────────────────────────────────────────────────────┘

When wait-for-finish is enabled, the action polls every 5 seconds until the deployment reaches a terminal status (success, failed, cancelled, or skipped). The action fails if the deployment doesn't succeed.

License

MIT