GCP - Adding Projects

Getting Started

Each GCP project of yours is considered an account in CloudVerse. The section below will guide you on how to add your projects to CloudVerse. This is a crucial step to ensure CloudVerse has the necessary data to optimize your cloud costs.

To add your GCP Project, you can choose one of two methods:

• Adding Project With Organizations(Recommended) If you have an organization and sufficient permissions for it, CloudVerse recommends using this method to add projects. CloudVerse can list all your projects, and you can select them to add to CloudVerse. Additionally, assigning roles and permissions only needs to be done once per organization.

• Adding Project Without Organizations Use this method if you don't have an organization or lack sufficient permissions on it. When adding projects this way, you must enter the IDs of the projects you want to add to CloudVerse (separated by spaces) and ensure that the project IDs are entered correctly.

Adding Project With Organizations

Prerequisites

Before you start, ensure that you meet the following prerequisites:

• Permission to Create and Assign roles, refer to: Prerequisites.

• Permission to Enable an API, refer to: Roles that control access to services.

• Already set up Cloud Billing data export to BigQuery. The types of data exported must include:

  • Detailed usage cost data

When you first enable the standard or detailed usage cost export to BigQuery, it might take a few hours to start seeing Google Cloud cost data propagate to your BigQuery dataset. Please wait until the data is exported before starting to add projects.

Steps To Flow

1. In CloudVerse console, click on Settings on the left bar to go to Settings page. Switch to Accounts tab.

   

2. Click on Add button in the top-right of the tab. On the popup, chose GCP then enter required fields then click on Generate Script:

   

Field	Description
Account Name	The name of the account that will be shown in CloudVerse; we have a default name for you, but you can change it to suit you.
Organization ID	The ID of your Organization.
Billing Account ID	Id of your Billing Account. It appears in the Settings section of your billing account.
Bigquery Dataset Name	The name of dataset in BigQuery where your detailed billing data is exported to. Ex: cv_export_data
Billing Project ID Hosting Bigquery Dataset	The ID of the project that contains the dataset where the billing data is exported to. Ex: cloudverse-2022

1. CloudVerse will generate a script that will help you:

   • Create a Custom Role named CloudVerseRole that contains required permissions.

   • Assign that role to CloudVerse's Service Account at Organization level.

   

To run this script, click on the Copy button in the top-right of the box. Then run the script in the Terminal in your GCP Console.

Please make sure the script will be ran in the the Organization you have entered.

• Since the script will be run at the organization level, all projects within that organization will inherit the assignment. If you want to add projects within that organization in the future, you don't need to run the script again.

• If you don't want to run the script, you can manually create the role and then assign it to CloudVerse's Service Account by following Creating Custom Role and Assigning Roles

After the script is finished, go back to CloudVerse and click I Ran The Script.

1. In the next step, CloudVerse will show a list of projects that are linked with your Billing Account, select the projects that you want to add to CloudVerse and click on Run Script.

   

Some projects that you already added will be disable from this this, so you can't add them twice.

1. CloudVerse will generate a script that will help you enable three APIs:

   • Compute Engine API

   • Cloud Asset API

   • Recommender API

To run this script, click on the Copy button in the top-right of the box. Then run the script in the Terminal in your GCP Console. After the script finished, go back to CloudVerse and click on I Ran The Script.

To see how CloudVerse use these APIs, please see APIs And Services

Click Connect to move to next step.

1. Click Finish to complete.

• CloudVerse will add your projects one by one, so it will take a while to show all your selected projects.

• It takes up to 24 hours to fully get your assets and cost data.

Adding Project Without Organizations

Prerequisites

Before you start, ensure that you meet the following prerequisites:

• Permission to Create and Assign roles, refer to: Prerequisites.

• Permission to Enable an API, refer to: Roles that control access to services.

• Already set up Cloud Billing data export to BigQuery. The types of data exported must include:

  • Detailed usage cost data

When you first enable the standard or detailed usage cost export to BigQuery, it might take a few hours to start seeing Google Cloud cost data propagate to your BigQuery dataset. Please wait until the data is exported before starting to add projects.

Steps To Flow

1. In CloudVerse console, click on Settings on the left bar to go to Settings page. Switch to Accounts tab.

   

2. Click on Add button in the top-right of the tab. On the popup, chose GCP then enter required fields then click on Generate Script:

   

   Field	Description
   Account Name	The name of the account that will be shown in CloudVerse; we have a default name for you, but you can change it to suit you.
   Billing Account ID	Id of your Billing Account. It appears in the Settings section of your billing account.
   Bigquery Dataset Name	The name of dataset in BigQuery where your detailed billing data is exported to. Ex: cv_export_data
   Billing Project ID Hosting Bigquery Dataset	The ID of the project that contains the dataset where the billing data is exported to. Ex: cloudverse-2022
   Project ID	The IDs of projects that you want to add to CloudVerse. Note: All projects here must be linked to your entered Billing Account.

3. CloudVerse will generate a script that will help you:

   • Create a Custom Role named CloudVerseProjectRole that contains required permissions.

   • Assign that role to CloudVerse's Service Account in all Projects that you have entered.

   • Enable required APIs in all Projects that you have entered.

   

   To run this script, click on the Copy button in the top-right of the box. Then run the script in the Terminal in your GCP Console.

If you don't want to run the script, you can manually create the role and then assign it to CloudVerse's Service Account by following Creating Custom Role and Assigning Roles

After the script is finished, go back to CloudVerse and click I Ran The Script.

1. Click Finish to complete.

• CloudVerse will add your projects one by one, so it will take a while to show all your selected projects.

• It takes up to 24 hours to fully get your assets and cost data.