doc/user/tutorials/tutorial-projects.html.textile.liquid

   1 ---
   2 layout: default
   3 navsection: userguide
   4 title: "Organizating data"
   5 ...
   6 {% comment %}
   7 Copyright (C) The Arvados Authors. All rights reserved.
   8
   9 SPDX-License-Identifier: CC-BY-SA-3.0
  10 {% endcomment %}
  11
  12 h2. Projects and Collections
  13
  14 In Arvados, files are organized into "collections", and collections are organized by "project".
  15
  16 Only collections can contain files.  A collection is a distinct database record identified by a universal unique id (UUID).  Arvados maintains a history of changes to the collection.  Every collection version has an immutable identifier called a "portable data hash" which is computed from the file content of the collection.  This can be used to refer to the immutable file content independently of the collection UUID.  If two collections have the same portable data hash, they have the same file content.
  17
  18 Projects contain collections, workflows and workflow runs, and other projects (subprojects).  Both collections and projects can have user-provided metadata.
  19
  20 Projects are the main unit of organization and sharing.  See "Sharing collections":#sharing-projects for information about sharing projects and collections with other users.
  21
  22 h2(#creating-projects). Creating a project
  23
  24 When you have navigated to any existing project, clicking on <span class="btn btn-sm btn-primary">+ NEW</span> <span class="rarr">&rarr;</span> <i class="fa fa-fw fa-folder"></i> *New project* will prompt you to create a new subproject under the current project.
  25
  26 If you're at the top-level <i class="fa fa-fw fa-folder"></i> *Home Projects*, a new top-level project will be created.
  27
  28 Alternatively, you can right-click on the link to an existing project to bring up a context menu, and select *New project*.
  29
  30 h2(#sharing-projects). Sharing projects
  31
  32 Projects can be shared with other users on the Arvados cluster.  First, locate the collection or project using any available means (for instance, by manually navigating in the Workbench, or using the Search bar). Then right-click on its link in a listing, or click on the triple-dot button in the details page. You will find the menu item *Share*, which opens the dialog box *Sharing settings*.
  33
  34 To share with other Arvados users, select the *WITH USERS/GROUPS* tab in the *Sharing settings* dialog box. Under *Add people and groups*, in the input field you can search for the user or group names. Select one you will be sharing with, choose the *Authorization* level (Read/Write/Manage) in the drop-down menu, and click on the plus sign (+) on the right. This can be repeated for other users or groups, each with their own *Authorization* level. The selected ones will appear under *People with access*. You can revisit the *Sharing settings* dialog box to modify the users or their access levels at a later time.
  35
  36 The *General access* drop-down menu controls the default sharing setting, with the following choices:
  37
  38 * *Private*: This is the initial state when no users or groups have been selected for sharing. At any time, by setting *General access* to private, the current sharing setting will be cleared, and any users or groups formerly with access will lose that access.
  39 * *Public*: This means the list of *People with access* will include _Anonymous users_, even if they are not users of the current cluster. You can further set their access level in the *Authorization* level.
  40 * *All users*: This means sharing with other users who are logged in on the current cluster.
  41 * *Shared*: When you choose to share with specific people or groups, *General access* will be set to *Shared*. From this state, you can further specify the default sharing settings for *Public* and *All users*.