TITLE: Terra Registration - Linking GCP Credits to the Terra Platform
AUTHORS: Anusha  Ginni, Jill V Hagey, Technical  Outreach and Assistance for States Team

[DESCRIPTION]
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.

https://support.terra.bio/hc/en-us/articles/360034677651-Account-setup-and-exploring-Terra

For technical assistance, please contact: TOAST@cdc.gov

[STEPS]
SECTION: Setup Terra and Google Cloud Accounts
1. 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.
 

 

 

SECTION: Setup Terra and Google Cloud Accounts
2. 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”.
(you can use link to reach directly to billing page, https://console.cloud.google.com/billing) 

 
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!