workspace-setup-cholgen.md

Initial setup of Terra workspace

This is a walkthrough demonstrating initial set up of a workspace on the Terra cloud platform for the CholGen Workshop.

Contents

{:.no_toc}

1. Table of Contents {:toc}

Terra documentation

In addition to the aspects of Terra described below, additional information concerning Terra can be found in the official Terra documentation.

Terra is tested using and intended to be accessed with the Google Chrome browser.

Sign in to Terra

1. Navigate to https://publichealth.terra.bio.
2. Click the icon in the upper left corner to expand the main menu.
3. Click "Sign In". A popup window will appear¹.
4. Click "Sign in with Google", and authenticate using the credentials for your Google account.

Cloning the CholGen Workshop Workspace

In Terra, a workspace is a way of grouping together tabular data, compute jobs, output data, and interactive notebooks. Workspaces are a good way to scope data by project, and each is associated with a billing project and a list of users or groups allowed to access the workspace data. To get started, each particpant will malke a working clone of the workshop workspace. Cloning the workspace will allow you to run your own analysis and inspect outputs without overwriting others.

1. Navigate to view the list of workspaces you can access: https://publichealth.terra.bio/#workspaces.
2. Navigate to the workspaces page

4. Search for the workspace of interest using the Search by keyboard box. “CholGen” (the workspace is also linked here).
5. The workspace is read-only. You will need to make your own copy that is associated with a billing project you have access to. You can do this by “cloning” the public workspace. Click on the circle with three dots on the upper right side of your workspace. A drop-down menu appears and you can select “Clone”.

6. Give the new (clone) workspace a descriptive Workspace name -- for the purposes of this workshop, include your initials or name in order to uniquely identify it (e.g. "CholGen 2024 Joe Smith"). Set the Billing project to "gates-pgs-training" (if it isn't already). Leave the Bucket location and Description as their default values. DO NOT select "Workspace will have protected data". Do not select an Authorization Domain; doing so will complicate access and sharing of workspace data.

7. Click “clone workspace”.

8. This creates a copy of the original workspace for just you to use. Check that the workspace you are currently working in is your copy.

Footnotes

1. Pop-up blocking may need to be disabled in your browser if the authentication pop-up window does not appear after clicking "Sign In" ↩