Skip to main content

Commands

Every command of hivepaas, from its own help: hivepaas <command> --help says the same.

CommandWhat it does
hivepaas apiCall any endpoint of the API, with the context's URL and key
hivepaas appAn environment's apps
hivepaas backupAn app's data backups: snapshots of its volumes, and what restores them
hivepaas completionGenerate the autocompletion script for the specified shell
hivepaas composeDocker Compose files: their services as apps
hivepaas config-fileConfig files: files HivePaaS keeps, mounted into apps' containers
hivepaas contextThe installations the CLI is logged in to
hivepaas cpCopy a file or a directory into an app's container, or out of it
hivepaas deployDeploy an app, and wait for the result while following its logs
hivepaas domainAn app's domains
hivepaas envAn app's environment variables
hivepaas execOpen a shell in an app's container
hivepaas functionFunctions: code HivePaaS runs on a runtime, a handler answering one request
hivepaas jobAn app's scheduled jobs: list them, run one now, turn one on or off
hivepaas linkTie this directory to an app, so commands run in it need no flags
hivepaas loginLog in to an installation with an API key
hivepaas logoutForget the current context, or the one --context names, and its key's secret
hivepaas logsShow an app's logs, a deployment's or a task's
hivepaas openOpen an app's address in the browser
hivepaas previewAn app's previews: copies of it for a branch or a pull request
hivepaas projectProjects and their environments
hivepaas psList an app's replicas: where each runs, its state, and why one failed
hivepaas restartRestart an app
hivepaas secretSecrets: values kept hidden, given to apps as ${secrets.KEY} or as files
hivepaas statusWhat needs attention on the installation: apps not running, nodes down
hivepaas taskAn app's tasks: its jobs' runs, and what else runs in the background for it
hivepaas templateThe template store
hivepaas unlinkRemove this directory's link
hivepaas updateInstall a newer release of this CLI
hivepaas versionThe CLI's version and API level, and the current installation's
hivepaas whoamiWho the key acts as, on which installation

Global flags​

Every command takes these:

FlagDescription
-a, --app stringapp, by name, key or id
--context stringthe installation to use, instead of the current one
--debuglog each request to stderr
-e, --env stringenvironment, by name
--no-colorno colors
-o, --output stringtable, json or yaml (default: table)
-p, --project stringproject, by name, key or id