Links

vessl workspace

Overview

Run vessl workspace --help to view the list of commands, or vessl workspace [COMMAND] --help to view individual command instructions.

Create a workspace

vessl workspace create [OPTIONS] NAME
Argument
Description
NAME
workspace name
Option
Description
-c, --cluster
Cluster name (must be specified before other options)
--node
Cluster nodes. Defaults to all nodes in cluster.
-r, --resource
Resource type to run an experiment (for managed cluster only)
--processor-type
CPU or GPU (for custom cluster only)
--cpu-limit
Number of vCPUs (for custom cluster only)
--memory-limit
Memory limit in GiB (for custom cluster only)
--gpu-type
GPU type (for custom cluster only)
ex. Tesla-K80
--gpu-limit
Number of GPU cores (for custom cluster only)
-i, --image-url
Kernel docker image URL
ex. vessl/kernels:py36.full-cpu
--max-hours
Maximum number of hours to run workspace. Defaults to 24.
--dataset (multiple)
Dataset mounts in the form of [mount_path]:[dataset_name]
ex. --dataset /input:mnist
--upload-local-file (multiple)
Upload local file. Format: [local_path] or [local_path]:[remote_path].
ex. --upload-local-file my-project:/root/my-project
--root-volume-size
Root volume size (defaults to 100Gi)
-p, --port (multiple)
Format: [expose_type] [port] [name], ex. -p 'tcp 22 ssh'. Jupyter and SSH ports exist by default.
--init-script
Custom init script

Connect to a running workspace

vessl workspace ssh [OPTIONS]
Option
Description
--key-path
SSH private key path
$ vessl workspace ssh
The authenticity of host '[tcp.apne2-prod1-cluster.vessl.com]:31123 ([52.78.240.117]:31123)' can't be established.
ECDSA key fingerprint is SHA256:ugLx91zLE9ELAqT19uNjQ.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added '[tcp.apne2.vessl.com]:31123,[52.78.240.117]:31123' (ECDSA) to the list of known hosts.
Linux workspace-x1hczjvygiql-0 4.14.225-169.362.amzn2.x86_64 #1 SMP Mon Mar 22 20:14:50 UTC 2021 x86_64
The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.
Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.

Connect to workspaces via VSCode Remote-SSH

vessl workspace vscode [OPTIONS]
Option
Description
--key-path
SSH private key path
$ vessl workspace vscode
Updated '/Users/johndoe/.ssh/config'.

Backup the home directory of the workspace

Create a zip file at /tmp/workspace-backup.zip and uploads the backup to VESSL server.
You should run this command inside a running workspace.
vessl workspace backup
$ vessl workspace backup
Successfully uploaded 1 out of 1 file(s).

Restore workspace home directory from a backup.

Download the zip file to /tmp/workspace-backup.zip and extract to /root/.
You should run this command inside a running workspace.
vessl workspace restore
$ vessl workspace restore
[?] Select workspace: rash-uncle (backup created 13 minutes ago)
> rash-uncle (backup created 13 minutes ago)
hazel-saver (backup created 2 days ago)
Successfully downloaded 1 out of 1 file(s).

List all workspaces

vessl workspace list

View information on the workspace

vessl workspace read ID
Argument
Description
ID
Workspace ID

View logs of the workspace container

vessl workspace logs ID
Argument
Description
ID
Workspace ID
Option
Description
--tail
Number of lines to display from the end (defaults to 200)

Start a workspace container

vessl workspace start ID
Argument
Description
ID
Workspace ID

Stop a workspace container

vessl workspace stop ID
Argument
Description
ID
Workspace ID

Terminate a workspace container

vessl workspace terminate ID
Argument
Description
ID
Workspace ID