Collaborating with someone already on Terra? Two ways to share billing
- Work in a shared workspace
- Access an existing Billing Project
- How to add or remove Billing Project users (owners)
Getting started - $300 in Google Cloud credits
Accessing STRIDES credits on Terra
Set up Terra billing in three steps
1. Set up GCP (Google) Billing account
2. Link GCP billing to Terra
3. Create a Terra Billing Project
Terra resources that don't cost (you) anything to use
Collaborating with someone already on Terra? Two ways to share billing
If you are working with someone who has already set up their billing, you may be able to access their billing resources, indirectly or directly. The two options are outlined below.
Work in a shared workspace
Costs in Terra are billed to the workspace Billing Project; it doesn't matter who does the work. If a colleague shares a workspace with you and assigns you "WRITER can-compute" access, you will be able to move data into and out of the workspace bucket, store data, and run analyses within that workspace. All charges for these operations will be paid by your colleague's Billing Project, which is assigned to the workspace when it's created.
For more information about controlling shared lab costs, including sharing workspaces, see this article.
Access a shared Terra Billing project
In order to create or clone a workspace of your own, you will need to have a Terra Billing Project. However, you don't necessarily need to set one up from scratch! Billing project owners can add and remove Billing Project users, so you may be able to access a colleague's already existing Project. This may apply, for example, if you are joining a research group that is already working in Terra. You'll need to ask the Billing Project owner to add you using the steps below.
Once you are a designated Billing Project user, the Project will appear in your Billing page, and in the drop-down menu when you create a workspace. All costs incurred in the workspaces you create will be covered by the Billing Project.
How owners can add or remove Billing project users
1. Go to your Billing page in Terra (click on your name from the main navigation menu at the top left to expand, and select Billing from the menu).
2. Click on the Terra Billing project to which you want to add users. Remember, you must be an owner or admin!
3. To add a new user, click Add User. Note that the user must be a registered user on Terra.
4. In the pop-up window, enter the user’s Terra ID (email address). The system will add the person as a User by default. Users can create workspaces using this Billing project, but can not add other users to the Billing project. if you want that person to have greater control, click the checkbox labeled Owner.
Owners can edit any user's role and delete users from a Billing project at any time by clicking on the Billing project from the list (access Billing from the User Profile drop-down in the main navigation menu at the top left).
Start with $300 in Google Cloud Platform (GCP) credits
Google cloud credits are a way to try the platform - to see if it's right for you - before committing your own money. Google offers $300 in credits to new users signing up for billing on GCP.
For step-by-step instructions on claiming $300 of GCP dollars to use on Terra, see this article. Once you claim the $300 credits, you can link your Google account to Terra (step2 below), create a Terra Billing project (step 3 below), and start exploring in a new workspace.
Although $300 won't be nearly enough to do a full analysis, it will give you a taste for the possibilities. You can use the credits to try the Data Tables Quickstart, Workflows Quickstart or Notebooks Quickstart tutorials. Each tutorial takes less than an hour and costs less than a dollar to complete. You'll have plenty of funds leftover to practice in a cloned Featured Workspace from the Terra Showcase Library. These cover a variety of scientific use-cases and include downsized datasets to run on.
Note that free-tier users are limited to five workspaces. See this article for more details.
Accessing STRIDES credits in Terra
Participants in programs such as the BioData Catalyst pilot program will have program credits through STRIDES loaded on a pre-associated Google Billing Account. These credits can be used for all storage, compute and egress charges on the Terra platform.
The instructions below assume you have already registered for an account on Terra, and that your Terra account has already been linked to a STRIDES billing account.
Create a Terra Billing project to access STRIDES credits (click to expand)
1. Go to your Billing page to access your Terra billing profile.
2. To create a new Billing Project, click the + Create button to the right of Billing projects.
3. Enter a unique name for your Terra Billing project in the modal. Note that the name cannot be changed.
4. Select your STRIDES Billing Account from the dropdown menu in the modal. This is the umbrella GCP Billing funding the Terra Billing project. Note that it will have the format "NIH.NHGRI.BDC.Fellow.00X".
5. Click on the Create Billing Project button at the bottom of the modal. Note that it will take several minutes to complete the setup.
You'll use this Terra Billing project when creating workspaces in Terra, and costs incurred by any work done in the workspaces will be paid for via the STRIDES Billing Account.
Set up billing in Terra from scratch - in three steps
If you don't have access to shared workspaces or billing, follow three steps below to set up a Terra Billing project from scratch. Once you have a Billing project, you'll be able to create or clone a workspace where you can store data and do analyses. After setting it up, Terra will manage the all GCP costs.
1. Set up a Google Billing Account
2. Link Google Billing to Terra
3.Create a Terra Billing Project
See the sections below for more detail on each step.
1. Set up a Google Cloud Billing account
The first step is to set up a Google Cloud Billing account to pay for all GCP fees. Options for setting up Cloud Billing include the following.
- If you are using a Broad Institute Cloud Billing account, you can request a Google Cloud Billing sub-account.
- If you're comfortable working in GCP console, you can set up and manage a Google Cloud Billing account directly in Google Cloud Platform.
- If you don't want to navigate GCP console, you can go through a third-party reseller who will do it for you.
|Hint: Talk to your institutional procurement office and see if they have a preferred account set-up method with Google (such as a third party reseller or an existing account). Remember to use the same Google account ID you use to log into Terra for the Google Cloud Billing account.|
Request a Google Cloud Billing sub-account (Broad Institute users)
Users internal to the Broad Institute may request a Google Cloud Billing sub-account to bill Terra usage costs to a Broad Institute-managed cost object.
Before you request a sub-account, please speak to your grant administrator and primary investigator (PI) to determine the availability of funding, and to discuss a monthly and total budget for Terra.
Once you are ready to request a sub-account, please fill out the form at this link (You should be signed in to your Broad Institute email to access this form).
Create a personal Google Cloud Billing account using a credit card or bank account
This is a good option if you want to have full control over your billing and are comfortable working in the GCP console. Go to the Google Developers Console Billing page, click on Add billing account and follow the instructions.
Remember to use the same Google ID you use to log into Terra for the Cloud Billing account.
You will need to provide billing information, which can be a personal or institutional credit card or bank account, as well as personal information to verify your identity (address and birthday). Note that if you have signed up for $300 in GCP credits, you will have already set up this part.
Use a third-party reseller
This is a good option if you do not want to navigate GCP console or are new to cloud computing. Note that the third-party reseller will be the Cloud Billing account Owner, so you may not have full access to detailed cost breakouts and spending reports in the GCP console.
Third-party resellers can facilitate and manage billing, helping to alleviate anxiety around spending in the cloud. They will work with you to set up a billing environment and a budget. They may have tools to help visualize storage, egress and compute charges, broken out by project and/or workspace. For researchers on grants, they can do purchase orders, and even help prepay with grant funding so you can spend when you need to.
There are many options for third-party resellers, who provide additional options for accessing and managing Google Accounts at no extra cost. Two examples are: Onix Networking or Sada Systems. To get started, you should contact the third-party reseller directly.
Note that if you are located in North America, you can leverage Onix as the Google Cloud Platform reseller. Onix is already experienced working with Terra accounts, so the setup to a new billing account is easy. Contact Onix at firstname.lastname@example.org or (216) 584-6649.
2. Link the Cloud Billing account to Terra (on GCP console)
Unless you are using a third-party reseller (who will take care of linking the accounts), the next step is to link the Google Cloud Billing Account to your Terra user account. They should have the same Google ID. You'll do this in the GCP console (separate from Terra).
NOTE: You must be an administrator on the Google Cloud Billing account to link the account with Terra. This will automatically be true if you created the Cloud Billing account. If you are not already an administrator on the billing account, you will need to contact an administrator and ask them to add you. This may be the PI or business administrator in your office.
Click for step-by-step instructions to link Cloud billing to Terra
2.2. Select the checkbox beside the Google Cloud billing account you will use for Terra.
2.3. On the right panel, below Permissions, select the Add Principal button.
2.4. Add "email@example.com"
2.5. Select the role Billing Account User.
2.5. Click Add.
Note: "firstname.lastname@example.org" may show up in the list as "email@example.com." This is totally okay and expected!
3. Create a Terra Billing project
You will need to have at least one Terra Billing project to create a workspace, as the Billing project is assigned when you create the workspace. Terra Billing projects are an internal mechanism for tracking billing resources on Terra. You can have as many of them as you need, all linked to the same Google Cloud Billing account.
Terra Billing projects versus Google projects
Despite the name, Terra Billing projects and Google projects are not related. Google projects are how Google organizes all the GCP resources you use. There is one for each workspace created after September 27, 2021. Terra automatically generates a Google Project in GCP when you create a workspace.
Note that creating a project on the GCP console will not create a project in Terra. You can only create Terra Billing projects in Terra.
Once Terra is linked to a Cloud Billing account, you will be able to create a Terra Billing project from the Billing page by clicking the + Create button at the top left.
Note that when you create a new Terra Billing project, you are automatically designated as the owner.
If your Terra Billing project will be used by a group (such as members in a research lab, or scientists with a common funding source), make sure to have more than one individual with "owner" permission. That way you will not be locked out of the Billing project if the sole owner leaves the group.
Add a second owner in the UI
Create a Terra Managed Group and give the group "owner" permission
See this article for step-by-step instructions to create a Terra managed group.
Click for step-by-step instructions to create a Terra Billing project
3.2. Click on the "+ Create" button
If prompted, click to Enable Billing Permissions, select the Google identity of the Google Cloud Billing account, and click Allow. This enables Terra to access Cloud Billing accounts associated with your Terra account.
3.3. Enter a unique name for your Terra Billing project.
The name of the Terra Billing project must:
- Only contain lowercase letters, numbers and hyphens
- Start with a lowercase letter
- Not end with a hyphen
- Be between 6 and 30 characters
3.4. Select the Google Cloud Billing account that will fund the Billing project.
Note: You may see multiple Cloud Billing accounts that you can select for this Terra Billing project. If you need to locate a Billing account ID, navigate to the Google Developers Console and click on Billing. Look for the number below Billing account ID.
Add a second Billing project owner (click for step-by-step instructions)
2. Under the Users tab, select the blue Add Users button.
3. Make sure to update their role to owner by selecting Edit role after clicking on the three dots icon.
Now you're ready to create (clone) a workspace!
Congratulations on setting up your Billing project! You should now be able to create or clone a workspace in Terra. When you do, the Billing project should appear in the dropdown menu. For step-by-step instructions on cloning a workspace, see this article.
Need more than five workspaces? Request a project quota increase!
Because most Terra users will want more than five workspaces, we recommend requesting a project quota increase right away when you set up your Cloud Billing account. Quota increases can take several days to process and must be made by the individual.
Why do you need a quota increase?
Google Project quotas limit the number of Google projects per GCP Billing account (default is five). Since Terra generates a Google project for each workspace, this impacts the number of workspaces you can create under a given Google Cloud Billing account.
You can learn more about project quotas and how to request more here.
Terra resources that don't cost (you) anything to use
You do not need access to your own billing to browse Terra or do work in a collaborator's workspace. However, you won't be able to create your own workspace to work in without setting up a Google Cloud Billing account linked to your Google (Terra) ID.
Some things you can do without your own billing include:
- Browsing tutorial workspaces and open-access data (no GCP costs)
These resources will be available to view in the Library after your register. Note, however, that in order to run a workflow or interactive analysis, you will need to make your own copy of the tutorial with your own Billing project.
- Working in shared workspaces with WRITER (can compute) permission owner pays all GCP costs)
If a Terra user, such as a collaborator or PI, shares a workspace with you and grants you WRITER (can compute) access, you can run workflows and interactive analyses within that workspace. All charges incurred will be paid by the workspace owner’s Terra Billing Project.