Terra on Google Cloud
In-depth guides for every step in the research journey, from finding and managing data to pipelining with workflows to interactive analysis (Jupyter notebook, RStudio or Galaxy).
Getting Started (GCP)
- Overview: Research in the cloud on Terra
- Overview: Costs and billing in Terra (GCP)
- How to register on Terra (Google SSO)
- How to set up a Terra account with a non-Google email
- Using Leanpub courses to get started in Terra
- How to set up billing in Terra (GCP)
- Claim $300 Google credits to explore Terra
- Best practices for managing shared funding
Account and billing
- How to change the Google Cloud Billing account of a Terra Billing project
- How to add/remove Google Cloud Billing account users
- How to disable billing in Terra
- How to disable a Terra Billing project
- How to delete a Terra Billing project
- How to delete a Terra Billing project (Swagger APIs)
Managing Access/Billing
- Best practices for sharing and protecting data resources
- Sharing data and tools with workspace access controls
- Managing access to shared data and tools with groups
- How to manage shared funding (team workspaces)
- How to manage shared funding (team billing projects)
- Best practices for accessing external buckets, GCP VMs, and machine-learning tools
- See all 9 articles
Managing Cloud costs
- Overview: Controlling Google Cloud costs on Terra
- How to view your cloud costs in Terra
- Frequently Asked Questions - Managing Cloud Costs
- Displaying Google Cloud costs in Terra
- Terra expenses and breaking down a Google bill
- How to track total Terra Billing project spend
- See all 14 articles
Workspaces
- Working with workspaces
- Documentation best practices (dashboards and notebooks)
- Curated template and tutorial workspaces
- How to clone your own workspace
- Build a workspace using data, showcase, and tools Library resources
- When workspace creation fails: Google project quotas
- See all 9 articles
Data
- Understanding data in the Cloud
- Terra architecture and where your data files live
- Managing data with tables
- Upload data and populate the table with linked file paths
- Broad Public Reference Data
- Customizing where your data are stored and analyzed
- See all 9 articles
- How to move data between local and workspace storage
- How to transfer data between your Cloud Environment PD and workspace storage
- gcloud storage tutorial
- How to install gcloud on a local machine
- See all 6 articles
Terra Data Repository
- Terra Data Repository (TDR): Overview
- Terra Data Repository (TDR): Glossary of terms
- How to use the TDR support articles
- How to authenticate/troubleshoot Swagger for TDR
- How to add collaborators to a TDR billing profile
Workflows
- Overview: Running workflows in Terra
- Importing workflows in Terra
- Getting started with GATK workflows in the cloud FAQs
- What to expect when you submit a workflow
- Job History overview (monitoring workflows)
- How much did my workflow cost?
- See all 7 articles
- Selecting the root entity type
- Writing workflow outputs to the data table
- Default runtime attributes for workflow submissions
- Workflow setup: VM and other options
- See all 17 articles
Interactive Analysis
- Interactive Analysis apps on Terra
- Cloud Environment FAQs
- Using the terminal and interactive analysis shell in Terra
- Overview: Cloud environment storage (detachable persistent disks)
- How to set up persistent disk storage for your analysis app
- See all 11 articles
Working with Containers (Docker)
- Docker/container overview
- Docker tutorial: Custom cloud environments for Jupyter Notebooks
- How to install Docker and test that it works
- How to run GATK in a Docker container
- Creating safe and secure custom Docker images
- Make a Docker (container) image the easy way: using a base image
- See all 9 articles
Troubleshooting
- Common issue/error "cheat sheet"
- How to report an issue
- Are resource quotas slowing your analysis down?
Advanced resources
- Supplemental information for Vertex AI workshop
- Accessing Google Cloud features that are not (yet!) available in Terra
- Best practices for source control on Terra
- Machine learning on Terra, Part II: Scaling training, and serving
- Machine learning on Terra, Part III: ML Ops