SDK command line

We present below the different command lines provided by our SDK.

All relative paths from the CLI are relative to the directory the command was launched in.

Interactivity

The CLI is interactive by default. If a mandatory option is missing, then you will be asked to input its value. You will also be asked confirmation before some operations.

The --force option disable the interactivity. With this option, project or environment will be automatically created with the given name if the don't exist.

In a non interactive shell, a command might fail without the --force option if all projects and environments specified doesn't exists.

Options can also be omitted if you use a configuration file. Note that the CLI overrides values from a configuration file. See Configuration file.

Help

To get a list of commands, run:

npx warp help
npx warp -h

To get details about a command's options, run:

npx warp help [command]
npx warp <command> -h

Working session

login

Log into your ScaleDynamics account.

npx warp login [e-mail] [org]

Create an account on your ScaleDynamics Console.

Arguments

Argument	Description	Default
[e-mail]	e-mail	interactive
[org]	organization you want to log into (only available if you specified an e-mail)	interactive

Options

Option	Description	Default
-p, --password <password>	password	interactive
--api-key <api-key>	api-key

Warning Useful if you want to use a CI/CD but be careful, the password can be read in plain text in different systems.

logout

Log out of your ScaleDynamics account.

npx warp logout

whoami

Print your credential info.

npx warp whoami

whereami

Print your working session project and environment you selected.

npx warp whereami

project

create

Create a project.

npx warp project create [name]

Arguments

Argument	Description	Default
[name]	project name	interactive

delete

Delete a project.

npx warp project delete [options] [name]

Arguments

Argument	Description	Default
[name]	project name	interactive

Options

Option	Description	Default
--force	delete the given project without confirmation

select

Select a project.

npx warp project select [name]

Arguments

Argument	Description	Default
[name]	project name	interactive

deselect

Remove the selected project.

npx warp project deselect

info

Print info on project.

npx warp project info [options]

Options

Option	Description	Default
--project <name>	project name	selected project or interactive

list

List projects.

npx warp project list

env

create

Create an environment.

npx warp env create [options] [name]

Arguments

Argument	Description	Default
[name]	environment name	interactive

Options

Option	Description	Default
--project <name>	project name	selected project or interactive

delete

Delete an environment.

npx warp env delete [options] [name]

Arguments

Argument	Description	Default
[name]	environment name	interactive

Options

Option	Description	Default
--project <name>	project name	selected project or interactive
--force	delete the given environment without confirmation

select

Select an environment.

npx warp env select [options] [name]

Arguments

Argument	Description	Default
[name]	environment name	interactive

Options

Option	Description	Default
--project <name>	project name	selected project or interactive

deselect

Remove the selected environment.

npx warp env deselect

info

Print info on environment.

npx warp env info [options]

Options

Option	Description	Default
--project <name>	project name	selected project or interactive
--env <name>	environment name	selected environment or interactive

list

List environments.

npx warp env list [options]

Options

Option	Description	Default
--project <name>	project name	selected project or interactive

base-url

add

Add a base URL for the environment

npx warp env base-url add [id] [hostname] [options]

Arguments

Argument	Description	Default
[id]	base URL ID	interactive
[hostname]	fully qualified hostname for base URL	interactive

Unless you customize it in the warp configuration, when deploying, the base URL IDs server for a server and hosting for a hosting will be used by default. See hosting and server configuration.

Options

Option	Description	Default
--project <name>	project name	selected project or interactive
--env <name>	environment name	selected environment or interactive

auth

Manage authentication in your environment. By default, no authentication is required in an environment. See authorization documentation here

basic

See basic authentication here

add

Add an authorized user.

npx warp env auth basic add [user] [password] [options]

Arguments

Argument	Description	Default
[user]	user name	interactive
[password]	password	interactive

Options

Option	Description	Default
--project <name>	project name	selected project or interactive
--env <name>	environment name	selected environment or interactive

delete

Remove an authorized user.

npx warp env auth basic delete [user] [options]

Arguments

Argument	Description	Default
[user]	user name	interactive

Options

Option	Description	Default
--project <name>	project name	selected project or interactive
--env <name>	environment name	selected environment or interactive

deploy

Build and deploy one or multiple containers.

npx warp deploy [options] [config-file...] [directories...]

Arguments

Argument	Description
[directories...]	path to one or multiple container directory
[config-file...]	path to one or multiple configuration file

Options

Option	Description	Default
--project <name>	project name	selected project or interactive
--name <name>	deployment name	randomly generated
--env <name>	environment name	selected environment or interactive
--arg <key>=<value>	set a config argument, repeatable

deployment

info

Print info on deployment.

npx warp deployment info [name] [options]

Arguments

Argument	Description	Default
[name]	deployment name	<interactive>

Options

Option	Description	Default
--project <name>	project name	selected project or interactive
--env <name>	environment name	selected environment or interactive

list

List deployments.

npx warp deployment list [options]

Options

Option	Description	Default
--project <name>	project name	selected project or interactive
--env <name>	environment name	selected environment or interactive

logs

Print the logs of your deployed services.

npx warp deployment logs [name] [options]

Arguments

Argument	Description	Default
[name]	deployment name	<interactive>

Options

Option	Description	Default
--project <name>	project name	selected project or interactive
--env <name>	environment name	selected environment or interactive
--follow	monitor the logs and display each logs as they are added
--timestamps [format]	show the reception timestamps of the logs by warp, can be in ISO 8601 format if iso is specified
--runner	show runner name
--since <time>	show logs from the given date or time
--until <time>	show logs before the given date or time
--tail <number>	only display the last number of lines
--level <levels>	list of levels to display, separated by a comma
--no-color	disable color usage
--raw	output raw log messages (without timestamps or level) to stdout or stderr according to their level

The --since and --until options takes either an ISO 8601 date, a UNIX timestamp (number of milliseconds elapsed since January 1, 1970 00:00:00 UTC), or a duration string.

The ISO 8061 date format corresponds to the YYYY-MM-DDTHH:mm:ss.sssZ format where:

• YYYY is the year.
• MM is the month of the year.
• DD is the day of the month.
• T indicates the beginning of the time element, and thus appears literally in the string.
• HH indicates the number of hours, from 00 to 24.
• mm indicates the number of minutes.
• ss indicates the number of seconds.
• sss indicates the number of milliseconds.
• Z indicates the UTC offset representation specified as "Z" (for UTC with no offset) or an offset of either "+" or "-" followed by a time expression HH:mm (indicating local time ahead of or behind UTC, respectively).

See here for more information on the date format.

A duration string is a sequence of decimal numbers, each with optional fraction and a unit suffix. Valid time units are:

Unit	Diminutive
milliseconds	ms
seconds	s or sec
minutes	m or min
hours	h or hr
days	d
weeks	w or wk
months	none

By default the --timestamps option display a human-readable date. If you want a ISO 8601 date, you can add the format like this: --timestamps iso.

version

Print version.

npx warp version