Oct 20, 2021
Terra Registration - Linking GCP Credits to the Terra Platform
This protocol is a draft, published without a DOI.
- 1Centers for Disease Control and Prevention
- TOAST_publicTech. support email: toast@cdc.gov
Protocol Citation: Anusha Ginni, Jill V Hagey, Technical Outreach and Assistance for States Team 2021. Terra Registration - Linking GCP Credits to the Terra Platform. protocols.io https://protocols.io/view/terra-registration-linking-gcp-credits-to-the-terr-bv3jn8kn
License: This is an open access protocol distributed under the terms of the Creative Commons Attribution License, which permits unrestricted use, distribution, and reproduction in any medium, provided the original author and source are credited
Protocol status: In development
We are still developing and optimizing this protocol
Created: June 24, 2021
Last Modified: October 20, 2021
Protocol Integer ID: 51019
Keywords: ONT, Nanopore, SARS-CoV-2, MinION, GridION, PromethION, MK1C, Pangolin, Genomics, Analysis, Virology, Bioinformatics, RNA, DNA, Clear Labs, Covid, Computational Biology, Sequencing, Clear Labs, Hamilton, Terra
Disclaimer
The opinions expressed here do not necessarily reflect the opinions of the Centers for Disease Control and Prevention or the institutions with which the authors are affiliated. The protocol content here is under development and is for informational purposes only and does not constitute legal, medical, clinical, or safety advice, or otherwise; content added to protocols.io is not peer reviewed and may not have undergone a formal approval of any kind. Information presented in this protocol should not substitute for independent professional judgment, advice, diagnosis, or treatment. Any action you take or refrain from taking using or relying upon the information presented here is strictly at your own risk. You agree that neither the Company nor any of the authors, contributors, administrators, or anyone else associated with protocols.io, can be held responsible for your use of the information contained in or linked to this protocol or any of our Sites/Apps and Services.
Abstract
This Terra registration protocol provides step-by-step guidance to register and activate a Google account as well enable Google Cloud free credits ($300) to use with the Terra platform. Terra runs using the Google Cloud Platform (GCP) as a backend for analysis and data storage. Compute costs are routed through the linked Google account. This is why you must link your Terra billing project to the Google Cloud Platform.
The registration process includes two parts, activating the GCP and linking the Google credits to the Terra platform. Upon creating the Terra account, GCP will be activated. This will allow your billing project on Terra to be connected to the Google cloud credits in order to run the desired analysis in Terra workspace.
For technical assistance, please contact: TOAST@cdc.gov
Setup Terra and Google Cloud Accounts
Setup Terra and Google Cloud Accounts
To set up and link google account to Terra follow the instructions from the links below.
For detailed step-by-step instructions scroll down to Step 2.
Note
The Terra platform registration requires a Google account. If you have a Google account you can sign in using the Terra login page:
Welcome page for Terra.bio
Click on the three parallel lines in the top left-hand corner and click the 'Sign in with Google' button.
Terra.bio welcome page with selection panel open.
If you do not have Google email you can set up a Google account with a non-Google email. The steps to do this are described in the following link:
Note
The Terra platform uses Google Cloud to run workflows and store data. The following documentation will describe how to set up a Google Cloud account:
Note
To link your Terra platform account with your Google Cloud account follow the instructions provided in the following link:
Scroll down to Section 3 titled "Create a Terra Billing Project" and follow the instructions. It is important to note that the name you give to your Terra Billing Project must be unique across all Google Billing Projects. If the name provided is not unique, it won't immediately throw an error, but instead will not complete the process of associating the Google Billing account with the Terra Billing Project. If this occurs cancel the process and set up a new Terra Billing Project.
Setting up the Google Cloud Platform (GCP) free credits to use in Terra
If you already have a google account, login using that. If not follow the instructions to create new a account.
Note: If you want to use your work/organization email, you can definitely set up your account using that.
Once you create your google account, you will be redirected to the Terra registration page, click “Register” and it will then land you on the Terra welcome page.
Now you need to activate the Google Cloud Platform (GCP) to add credits to your Terra account, to do this go to google console here: https://console.cloud.google.com/ make sure you log in with the Terra user id that you just created, that will land you here, go ahead and click “Activate” (see on right corner of the page)
You will be asked to Accept the Terms and Payment Information Verification, where you will provide the account type as “Individual”/”Business” and payment Method. You won’t be charged until you enable autopayment after free credits.
Then you will be directed to the google cloud platform home page. You can check the status of this activation, from the left side menu by select Billing and “My Billing Account”.
On the "My Billing Account" Page you will see your status as “Active” .
Now let’s link your billing account (Terra in this case) on GCP console. On the same page select My Billing Accounts and check the box “My billing Project” which enables to “ADD MEMBER” (you will see this on right side of the page).
Add terra-billing@terra.bio to grant access to the billing account and set the role as “Billing Account User” from the drop down menu. *Don’t forget to save the changes*
Once you added the credits and linked your GCP billing account, you will now able to create billing project in Terra and start using the credits. Get back to Terra platform, select “Billing” from the to create Projects
This will redirect to the google account, allow access to Terra
Enter the name of your project and select billing account (that you just created and activated) from the dropdown menu and “Create your Billing Project”.
This is how it will look at your finished.
You are all set to create workspaces and run analysis. Good Luck!