"Sharing" a workspace allows multiple people to actively work together in the same workspace. You can see what sorts of changes your colleagues are implementing, troubleshoot a workspace efficiently as a team, and delegate work. The main drawback of "sharing" a workspace is that you may end up making changes to someone else's work, or messing up your team's versioning organization.
Terra tries to make collaboration as effortless as possible by making it easy to clone and share workspaces. You can share from within your workspace or from the "Your Workspaces" page. Read on for step-by-step instructions for these options.
For information about cloning a workspace, see this article.
Click on the three vertical dots on the top right of your workspace Dashboard (see screenshot below).
In the popup menu, choose "Share."
Type in the email address (Terra user account address) of the person you want to share (step 1) with and the role you want to assign them (step 2) and click "Save" (bottom right).
Your collaborator should see the workspace in "My Workspaces.
2. From "Your Workspaces" (option 2):
To access the full list of Terra workspaces available to you, click on "View Workspaces" from the Terra homepage app.terra.bio:
All the workspaces you have access to will show up as cards (see screenshot below). Click on the three vertical dots at the lower right of the card of the workspace you want to share.
In the popup menu, choose "Share":
Type in the email address (Terra user account address) of the person you want to share (step 1) with and the role you want to assign them (step 2) and click "Save."
Your collaborator should see the workspace in "My Workspaces."
In some cases, you may wish to share a workspace with a service account - a special type of account that manages permissions on your behalf, authorizing access to cloud resources. For example, if you want to use a product like TensorFlow to apply machine learning algorithms to data in a workspace bucket, you can register a service account to manage authorization to that bucket.
Instructions for registering a service account can be found here. Running this script will register the new service account, and print out an email address for that account that will look something like this:
You can then share the workspace with the service account just as described in options 2 and 3 of this article, entering that service account's email into the "user email" field.
Click here for more details on Reader, Writer and Owner roles.