CLI and API

Deploy from the terminal or from your pipeline

The sura command line and API tokens do from the terminal what you do in the dashboard: deploy, logs, variables, stop and start.

The documentation is in Portuguese for now.

$ sura apps
NAME       STATE    DEPLOY   URL
minha-api  running  running  https://minha-api.suracloud.app
loja-bot   running  running  -
$ sura env set minha-api FEATURE_X=on
$ sura deploy minha-api
Deployment 3f9a1c2e of minha-api started.
Deployed: https://minha-api.suracloud.app
$ sura logs minha-api --tail 50

Deploy from GitHub Actions

- run: sura deploy minha-api
  env:
    SURA_API: https://app.suracloud.dev
    SURA_TOKEN: ${{ secrets.SURA_TOKEN }}
Illustrative example.

What comes with it

A single binary

For Linux, macOS and Windows, with no dependencies. The installer checks the file SHA-256 before installing.

Deploy that follows the build

sura deploy streams the build log and exits with an error if the deploy fails, so it works straight in your CI.

Logs and variables

Follow logs live and list, change or delete variables, with values hidden by default.

Tokens with two locks

Full or read-only access, valid for 30, 90 or 365 days. The secret shows once and is stored only as a digest.

Browser things stay in the browser

Deleting the account, deleting a live app and exporting data stay in the dashboard, with a recent confirmation.

Ready for GitHub Actions

With SURA_API and SURA_TOKEN in the environment, a deploy step fits in one line.