If you've never logged into the Google Cloud console to set up billing, you are eligible for $300 in free Google Cloud credits you can use for working in Terra. Read on for step-by-step instructions for how to access the credits and FAQs about using the credits on the Terra platform.
For more information about Google's free credits and Free Tier, see their documentation here.
Conditions for Google credits free trial eligibility
- You haven't previously signed up for the Free Trial
- You've never been a paying customer of Google Cloud, Google Maps Platform, or Firebase
If you're part of a broader organization that uses Google Cloud, your work email will most likely not be eligible for the $300 credits.
Three steps to get $300 Google Cloud credits to use in Terra
Setting up billing directly lets you have full control over your billing and is a good option if you are comfortable working in the Google Cloud console. You can use a personal credit card or bank account (and get reimbursed, if your work on Terra is grant-funded) or institutional credit card or other account.
If you have been using a third-party reseller, but want to set up your own Google Cloud Billing account, follow the directions below.
Step 1. Set up Cloud Billing account and accept free credits
The first step is to set up a Google Cloud Billing account using your Terra user ID in the Google Cloud console (not in Terra).
1.1. Go to the Google Cloud console at https://console.cloud.google.com/ (make sure to sign in with your Terra user ID!). If you haven't already set up a Google Cloud Billing account, you'll be greeted with an invitation to activate your free trial in the banner at the top of the page:
1.2. Click the activate button and follow the instructions to sign up for a Cloud Billing account and get your credits.
Why does Google ask for additional information?To reduce fraud, you'll need to confirm the information you provide with a one-time verification sent to a cell phone and give a credit card, PayPal account, or bank account. This confirms that you're a person (not a bot!).
Google will notify you before your credits expire and will not charge your credit card without your direct permission.
What to expect
You can verify the Google Cloud Billing account in the Billing page. You should see My Billing Account in the top left. That's your new Google Cloud Billing account!
Google will create a Google project, My First Project, funded by your free credits, which you can see in the My Projects tab.
Step 2. Link Terra to your Cloud Billing account on Google
This step lets Terra and Google communicate about cost and billing. You will do this on the GCP console (separate from Terra).
2.1. When logged into Google Chrome with your Terra user ID, go to the Google Cloud Console Billing page.
2.2. Select the checkbox beside the Google Cloud Billing account you will use for Terra. For free trial credits, this will be My Billing Account.
2.3. On the right panel, below Permissions, select the Add Principal button.
2.4. Add terra-billing@terra.bio under New Principal in the form.
2.5. In the dropdown, select the Billing role Billing Account User.
2.5. Click Add.
2.6. Don't forget the Save button!
Note: "terra-billing@terra.bio" will appear in the list as "terra-billing@firecloud.org." This is expected!
Step 3. Create a Terra Billing project
Once you've accepted your Google credits and linked your Google Cloud Billing account to Terra, you'll be able to create a Terra Billing project. You need a Terra Billing project to create a workspace to work in Terra. These Billing projects are internal to Terra, and act as a passthrough for Google Cloud costs.
3.1. In app.terra.bio, go to your Billing page from the main navigation (three horizontal lines at the top left of any page) and click on the + Create button at the top left.
3.2. Name your Billing project.
3.3. Select My Billing Account from the dropdown ("My Billing Account" is the default name for your GCP free credits, and it should be the only option) and click the Create Billing project button.
Next - Hands-on practice in a showcase workspace template
Once you have a Terra Billing project, you're ready to try your own analysis on the Terra platform. To see how to make your own copy of a workspace, see this video.
Quickstart tutorial workspaces
Dive in with hands-on practice working with data tables, workflows, and notebooks in the T101 Quickstart workspaces. Each quickstart tutorial takes about half an hour to complete and costs less than $1.
Explore template use-cases
See if one of these curated showcase workspaces is close to your use case. Each one includes extensive documentation as well as sample data that can be run as-is. To make a template you can practice in, make your own copy under your new Terra Billing project.
