From 291c1ab90ae92a8754346c86499174dc6a898db9 Mon Sep 17 00:00:00 2001 From: revital Date: Tue, 6 May 2025 11:38:34 +0300 Subject: [PATCH] edits --- docs/webapp/applications/apps_jupyter_lab.md | 2 +- docs/webapp/applications/apps_ssh_session.md | 20 ++++++++++++-------- docs/webapp/applications/apps_vscode.md | 2 +- 3 files changed, 14 insertions(+), 10 deletions(-) diff --git a/docs/webapp/applications/apps_jupyter_lab.md b/docs/webapp/applications/apps_jupyter_lab.md index 8e3917f9..6818beed 100644 --- a/docs/webapp/applications/apps_jupyter_lab.md +++ b/docs/webapp/applications/apps_jupyter_lab.md @@ -66,7 +66,7 @@ to open the app's instance launch form. line) * **Extra Packages** - Extra Python packages to be installed * **Persistent Workspace Path** - Specify your workspace root directory. It will be automatically stored when the session - is closed and available for restoring into a new sessions (example: `~/workspace`) + is closed and available for restoring into new sessions (example: `~/workspace`) * **Queue** - The queue serviced by the ClearML Agent that will execute the Jupyter Lab session * **Maximum idle time** (hours) - Maximum time of inactivity, after which the session will shut down. Configure idleness definitions under `Advanced Options`. diff --git a/docs/webapp/applications/apps_ssh_session.md b/docs/webapp/applications/apps_ssh_session.md index cf4ef5eb..2e2cf74a 100644 --- a/docs/webapp/applications/apps_ssh_session.md +++ b/docs/webapp/applications/apps_ssh_session.md @@ -26,7 +26,7 @@ Once you have launched an app instance, you can view the following information i * Idle instance - Remote SSH session is idle * Stopped instance - Remote SSH session is stopped * Idle time -* Restored workspace - If a previous session’s workspace was restored, this will display its session ID +* Restored workspace - If a previous session’s workspace was restored, this will display that session's ID * Current session ID * SSH:Host:Port - The hostname and port for the SSH connection * User - SSH username for the interactive session @@ -68,23 +68,27 @@ values from the file, which can be modified before launching the app instance * Repository * Branch * Commit + * Store git repository as part of the snapshot - If you select to `Store git repo`, a copy of the repo will be stored + in the workspace under `./git_repo`. Otherwise, the workspace will include a `./git_repo_not_synced` soft link to the + expected repo path * **Container** - Input details to run the session in Docker container * Image - Container image to launch * Docker Arguments - Additional arguments for the Docker image * Init Script - Bash script that is executed upon container boot (comments are supported only at the beginning of the line) * **Extra Packages** - Specify Python packages to install when setting up the remote environment -* **Persistent Workspace Path** - Specify your workspace root directory, it will be automatically stored when the session is -closed and restored into a new instance when the session app instance is cloned (example: `~/workspace`) +* **Persistent Workspace Path** - Specify your workspace root directory. It will be automatically stored when the session + is closed and available for restoring into new sessions (example: `~/workspace`) * **Queue** - The [ClearML Queue](../../fundamentals/agents_and_queues.md#what-is-a-queue) to which the SSH Session app instance task will be enqueued (make sure an agent is assigned to that queue) * **Maximum idle time** (in hours) - Maximum idle time after which the app instance will shut down -* **Interactive Session Name** - Name your current interactive session +* **Interactive Session Name** - Name for your current interactive session * **Advanced Options** - * Interactive Session Project - The project in which the interactive session is created. If left empty, the default - project `Interactive Session` is used - * Interactive Session Tags - Comma separated list of tags to add to your interactive session - * Restore Interactive Workspace ID - Input a previously run interactive session ID to restore its workspace + * Interactive Session Project - The ClearML project in which the interactive session is created. If left empty, the + default project `Interactive Session` is used + * Interactive Session Tags - Comma separated list of tags to add to your interactive session task. + * Restore Interactive Workspace ID - Input a previously run interactive session ID to restore its workspace (when + cloning a previously run app instance, this field is automatically filled with its ID) * Use DropBear SSH server instead of OpenSSH server - Use DropBear SSH server instead of OpenSSH server. Required if not running as root inside container * Idle Network Threshold (MB) - Network throughput under which the session will be considered idle diff --git a/docs/webapp/applications/apps_vscode.md b/docs/webapp/applications/apps_vscode.md index 382d6a2d..cae066c6 100644 --- a/docs/webapp/applications/apps_vscode.md +++ b/docs/webapp/applications/apps_vscode.md @@ -66,7 +66,7 @@ to open the app's instance launch form. line) * **Extra Packages** - Extra Python packages to be installed * **Persistent Workspace Path** - Specify your workspace root directory. It will be automatically stored when the session - is closed and available for restoring into a new sessions (example: `~/workspace`) + is closed and available for restoring into new sessions (example: `~/workspace`) * **Queue** - The queue serviced by the ClearML Agent that will execute the VS Code session * **Maximum idle time** (hours) - Maximum time of inactivity, after which the session will shut down. Configure idleness definitions under `Advanced Options`.