Workspace

​

read_workspace

vessl.read_workspace(
   workspace_id: int, **kwargs
)

• workspace_id (int) : Workspace ID.

vessl.read_workspace(
    workspace_id=123456,
)

​

list_workspaces

vessl.list_workspaces(
   cluster_id: int = None, statuses: List[str] = None, mine: bool = True, **kwargs
)

• 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.

vessl.list_workspaces(
    cluster_id=123456,
    statuses=["running"],
)

​

create_workspace

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,
   use_vesslignore: bool = True, root_volume_size: str = '100Gi', ports: List[Dict[str,
   Any]] = None, init_script: str = None, **kwargs
)

• 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.
• use_vesslignore (bool) : True if local files matching glob patterns in .vesslignore files should be ignored. Patterns apply relative to the directory containing that .vesslignore file.
• 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.

vessl.create_workspace(
    name="modern-kick",
    cluster_name="aws-apne2",
    kernel_resource_spec_name="v1.cpu-0.mem-1",
    kernel_image_url="public.ecr.aws/vessl/kernels:py36.full-cpu.jupyter",
)

​

list_workspace_logs

vessl.list_workspace_logs(
   workspace_id: int, tail: int = 200, **kwargs
)

• workspace_id (int) : Workspace ID.
• tail (int) : The number of lines to display from the end. Display all if -1. Defaults to 200.

 vessl.list_workspace_logs(
    workspace_id=123456,
 )

​

start_workspace

vessl.start_workspace(
   workspace_id: int, **kwargs
)

• workspace_id (int) : Workspace ID.

vessl.start_workspace(
    workspace_id=123456,
)

​

stop_workspace

vessl.stop_workspace(
   workspace_id: int, **kwargs
)

• workspace_id (int) : Workspace ID.

vessl.stop_workspace(
    workspace_id=123456,
)

​

terminate_workspace

vessl.terminate_workspace(
   workspace_id: int, **kwargs
)

• workspace_id (int) : Workspace ID.

vessl.terminate_workspace(
    workspace_id=123456,
)

​

backup_workspace

vessl.backup_workspace()

vessl.backup_workspace()

​

restore_workspace

vessl.restore_workspace()

vessl.restore_workspace()

​

connect_workspace_ssh

vessl.connect_workspace_ssh(
   private_key_path: str
)

• private_key_path (str) : SSH private key path

vessl.connect_workspace_ssh(
    private_key_path="~/.ssh/key_path",
)

​

update_vscode_remote_ssh

vessl.update_vscode_remote_ssh(
   private_key_path: str
)

• private_key_path (str) : SSH private key path

vessl.update_vscode_remote_ssh(
    private_key_path="~/.ssh/key_path",
)