Workspace API
vessl.read_workspace(
workspace_id: int, **kwargs
)
Read workspace in the default organization. If you want to override the default organization, then pass
organization_name
as **kwargs
.Args
workspace_id
(int) : Workspace ID.
Example
vessl.read_workspace(
workspace_id=123456,
)
vessl.list_workspaces(
cluster_id: int = None, statuses: List[str] = None, mine: bool = True, **kwargs
)
List workspaces in the default organization. If you want to override the default organization, then pass
organization_name
as **kwargs
.Args
cluster_id
(int) : Defaults to None.statuses
(List[str]) : A list of status filter. Defaults to None.mine
(bool) : True if list only my workspaces, False otherwise. Defaults to True.
Example
vessl.list_workspaces(
cluster_id=123456,
statuses=["running"],
)
vessl.create_workspace(
name: str, cluster_name: str, cluster_node_names: List[str] = None,
kernel_resource_spec_name: str = None, processor_type: str = None,
cpu_limit: float = None, memory_limit: str = None, gpu_type: str = None,
gpu_limit: int = None, kernel_image_url: str = None, max_hours: int = 24,
dataset_mounts: List[str] = None, local_files: List[str] = None,
root_volume_size: str = '100Gi', ports: List[Dict[str, Any]] = None,
init_script: str = None, **kwargs
)
Create workspace in the default organization. If you want to override the default organization, then pass
organization_name
as **kwargs
.Args
name
(str) : Workspace name.cluster_name
(str) : Cluster name(must be specified before other options).cluster_node_names
(List[str]) : A list of candidate cluster node names. Defaults to None.kernel_resource_spec_name
(str) : Resource type to run an experiment (for managed cluster only). Defaults to None.cpu_limit
(float) : Number of vCPUs (for custom cluster only). Defaults to None.memory_limit
(str) : Memory limit in GiB (for custom cluster only). Defaults to None.gpu_type
(str) : GPU type (for custom cluster only). Defaults to None.gpu_limit
(int) : Number of GPU cores (for custom cluster only). Defaults to None.kernel_image_url
(str) : Kernel docker image URL. Defaults to None.max_hours
(int) : Max hours limit to run. Defaults to 24.dataset_mounts
(List[str]) : A list of dataset mounts. Defaults to None.local_files
(List[str]) : A list of local file mounts. Defaults to None.root_volume_size
(str) : Root volume size. Defaults to "100Gi".ports
(List[Dict[str, Any]]) : Port numbers to expose. Defaults to None. processor_type(str) cpu or gpu (for custom cluster only). Defaults to None. init_script(str) Custom init script. Defaults to None.
Example
vessl.create_workspace(
name="modern-kick",
cluster_name="aws-apne2-prod1",
kernel_resource_spec_name="v1.cpu-0.mem-1",
kernel_image_url="public.ecr.aws/vessl/kernels:py36.full-cpu.jupyter",
)
vessl.list_workspace_logs(
workspace_id: int, tail: int = 200, **kwargs
)
List experiment logs in the default organization. If you want to override the default organization, then pass
organization_name
as **kwargs
.Args
workspace_id
(int) : Workspace ID.tail
(int) : The number of lines to display from the end. Display all if -1. Defaults to 200.
Example
vessl.list_workspace_logs(
workspace_id=123456,
)
vessl.start_workspace(
workspace_id: int, **kwargs
)
Start the workspace container in the default organization. If you want to override the default organization, then pass
organization_name
as **kwargs
.Args
workspace_id
(int) : Workspace ID.
Example
vessl.start_workspace(
workspace_id=123456,
)
vessl.stop_workspace(
workspace_id: int, **kwargs
)
Stop the workspace container in the default organization. If you want to override the default organization, then pass
organization_name
as **kwargs
.Args
workspace_id
(int) : Workspace ID.
Example
vessl.stop_workspace(
workspace_id=123456,
)
vessl.terminate_workspace(
workspace_id: int, **kwargs
)
Terminate the workspace container in the default organization. If you want to override the default organization, then pass
organization_name
as **kwargs
.Args
workspace_id
(int) : Workspace ID.
Example
vessl.terminate_workspace(
workspace_id=123456,
)
vessl.backup_workspace()
Backup the home directory of the workspace. This command should be called inside a workspace.
Example
vessl.backup_workspace()
vessl.restore_workspace()
Restore the home directory from the previous backup. This command should be called inside a workspace.
Example
vessl.restore_workspace()
vessl.connect_workspace_ssh(
private_key_path: str
)
Connect to a running workspace via SSH.
Args
private_key_path
(str) : SSH private key path
Example
vessl.connect_workspace_ssh(
private_key_path="~/.ssh/key_path",
)
vessl.update_vscode_remote_ssh(
private_key_path: str
)
Update .ssh/config file for VSCode Remote-SSH plugin.
Args
private_key_path
(str) : SSH private key path
Example
vessl.update_vscode_remote_ssh(
private_key_path="~/.ssh/key_path",
)
Last modified 11mo ago