Managing Projects

This section provides a detailed overview of the various actions and operations that can be performed on a Data Science Lab project.

From the Project List you can open a project’s workspace, update its configuration, collaborate with teammates, version it in VCS, control runtime state, or remove it.

Navigation path: Data Science Lab > Projects > Project List

Common Initial steps (for all actions)

1. Navigate to the Project List page.

2. Select a project from the table.

3. Use the right-side details panel (or row actions) to perform the desired action.

Notes

• The Workspace opens by default when you View a project.

• To use all project features (e.g., run notebooks), Activate the project first.

• Some actions require specific permissions (e.g., Share, Delete).

---

View a Project

Use to open the project’s Workspace (Repo, Notebooks, Datasets, Models, Utilities).

1. On Project List, select a project.

2. Click View in the right panel.

3. You are redirected to the project Workspace.

• Next: Open a Notebook in Repo, attach datasets, or manage models.

Edit a Project

Update metadata, resources, environment, or Git settings.

1. Select a project on the Project List.

2. Click Edit (in the right panel).

3. Modify fields (e.g., Project Name/Description, Environment, Resource Allocation, Idle Shutdown, External Libraries, Git Project/Branch, Nodepool, GPU Type/Limit).

4. Click Save.

5. A message will confirm the completion of the action.

Tip: If you change External Libraries or base image, re-activate the project to ensure the runtime picks up changes.

Share a Project

Grant or revoke access for users or groups.

1. On Project List, select the project.

2. Click Share in the right panel.

3. Choose User or User Group tab.

4. Select one or more entries from the available list; move them to the selected box.

5. Choose the access level (e.g., View, Edit, Execute). You can select multiple access permissions.

6. Click Save to apply.

7. (Optional) Use Exclude/Revoke to remove access for specific users/groups.

Permissions: Admins can share/unshare any project. Non-admins can share only if granted manage/share rights.

• Various Permissions for the Share Project action:

1. View: the targated user can view the project details.

2. Edit: the targated user can view & edit the project details, & save the updated details.

3. Execute: the targated user can activate/ deactivate the project container.

Push to VCS (Version Control) / Git Export (Migration)

Version your project or prepare it for migration across environments.

Prerequisites: Ensure Git Project and Git Branch are configured, or enable Sync Git repo at project creation for Repo Sync Projects.

Push

1. On Project List, select the project.

2. Click Push/Pull (or Push & Pull to VCS).

3. Enter a Commit Message.

4. Select Push Type:

   • Version Control – version in the same environment’s VCS.

   • GIT Export (Migration) – export to Git for cross-environment migration.

5. Click Save.

6. Confirm the success notification.

Pull (Restore a prior version)

1. On Project List, select the project.

2. Click Push/Pull.

3. Open the Pull tab, select a prior version.

4. Click Save to import that version.

5. Confirm the import success message.

Warning: Pulling replaces the current project state with the selected version. Review before proceeding.

Please note: Refer the Git Migration section to get details on the Git Export & Import part of a Data Science Project.

Activate & Deactivate a Project

Control the project’s runtime container (resources, session state).

Activate

1. On Project List, select the project.

2. Click Activate option from the Actions panel.

3. Confirm in the dialog; wait for the success message.

4. Status changes to UP (green). The button switches to Deactivate.

Deactivate

1. On Project List, select the active project.

2. Click Deactivate.

3. Confirm Yes in the dialog; wait for the success message.

4. Status changes to OFF (gray).

Idle Shutdown: Sessions auto-terminate after the configured idle time (e.g., 30m/1h/2h). Re-activate to continue work.

Delete a Project

Move a project to Trash (with possible recovery, depending on policy).

1. On Project List, select a project.

2. Click the Delete icon from the right side panel.

3. Confirm Yes in the dialog.

4. Verify the deletion success message; the project is removed from the list.

Notes

• Deleted projects typically appear in Trash; admins can purge permanently.

• Ensure nothing critical (e.g., models, notebooks) is only stored locally before deletion.

Troubleshooting & Tips

• Cannot Edit or Run: Activate the project first; verify your permissions.

• Push/Pull fails: Check Git credentials, branch, or network access; ensure Repo Sync is enabled or Git settings are configured.

• Library changes not applied: Deactivate and re-activate the project to refresh the runtime.

• Accidentally changed version: Use Pull again to restore the desired version.

---