Google Cloud Storage Connection
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Google Cloud Storage Connection

  • Dark
    Light
  • PDF

Article summary

Overview

Welcome to Getting Started with Rivery and Google Cloud Storage (GCS).

This guide will show you how to set your Google Cloud credential JSON key, how to create a Google Cloud Storage bucket, and how to get the right credentials for using Google Cloud Storage with Rivery. In the end of the guide, you will make a quick setup in Rivery to connect your Google Cloud Storage.

Before you use this guide, please make sure you’ve signed up for Google Platform and you have a console admin user.

If you don’t have one of these prerequisites, you can start here .

Create a Service Account User for Rivery:

Rivery uses Google Cloud Storage bucket to upload your source data into it. Therefore, there is need to create a user in Google Cloud Platform Console, that will have the access to the relevant bucket and to the relevant BigQuery Project.

So, first of all - let’s create a user for Rivery.

How do we do that?

  1. Sign into Google Cloud Platform Console.

  2. Go to IAM & Admin  -> Service account - > click on CREATE SERVICE ACCOUNT button.

  3. In the wizard

create_service_account1.PNG

  1. Set your Service Account name (i.e: RiveryUser) and click on CREATE AND CONTINUE
    create_service_account2.PNG

  2. Grant the service account acces to the project by setting Roles:
    Click on the drop down list and select BigQuery Admin
    Then click on the ADD ANOTHER ROLE button and do the same process for Storage Admin
    Copy your Account Service ID / Email from the service account list. 
    Later, you will use this to enter it in a Rivery connection.

  3. Now lets create a key for the service account:

    1. Go to the service account screen, locate the serivce you've just created and click on it

    2. In the new service account screen cick on Key

    3. Click on add key
      keys_screen1.PNG

    4. Choose key type JSON and click on create

    5. Your JSON secret key will be download. keep it in a safe place.
      keys_screen2.PNG

Enable Cloud Storage and GCS API

  1. Go to  API's & Services ->Click on ENABLE APIS AND SERVICE button.

  2. Search for  Google Cloud Storage JSON API and click on Enable API .

Create a Google Cloud Storage Bucket

Rivery needs a Google Cloud Storage bucket to be a FileZone before your data is loading up to BigQuery. You can either use the FileZone bucket or objects as a base to other Hadoop or Apache Spark operation by Google Data PROC, or by your other services.

So, let's create a Google Cloud Storage bucket for Rivery:

  1. Sign into Google Cloud Platform Console.

  2. Go to Storage -> Browse - > click on CREATE BUCKET button.

  3. In the wizard:

    1. Set Bucket Name example : project_name_rivery_file_zone

    2. Set your Bucket to be Regional (Multi-Region is not stable for loading)

      and choose your preferred location

    3. Click CREATE button.

Configure your Google Cloud Storage Bucket in Rivery

Let’s create a new connection for your Google Cloud Storage

1. Go to Connections.

2. Press on New Connection .

3. From the source list, choose  Google Cloud StorageScreen_Shot_2017-11-26_at_7.05.29_PM.png

  1. Now, enter your credentials information for Google Platform Service Account

gcs_new_connection1.PNG

gcs_new_connection2.PNG

1. Connection Name

2. Description (optional)

3. Project Id  (can be found on Google Platform Home section)

4. Project Number (optional - can be found on Google Platform Home section)

5. Service Account email  - it's Service Account Id that you used to copy the Service Account Wizard.

6. Choose file - the JSON credentials file that was generated at the end of Service Account Wizard.

7. Region - the region your bucket was created at

8. Default bucket - the defualt bucket Rivery will use(the one you've created)

Click 'Test Connection' at the bottom to test! Once a valid connection is made, save the connection.

If you cannot get a valid connection set up, contact helpme@rivery.io for support.

Known Issues

  • Sometimes the "Storage Admin" type user role does not have a certain permission "storage.buckets.get" given to it by default:

image.png

In this case, you will have to edit your GCP user roles by duplicating that "Storage Admin" role by clicking

image.png, making sure the custom role you create has the storage.buckets.get permission, then assigning your service account this custom role instead of the "Storage Admin" (See the "Create a Service Account User for Rivery" section of this document).

Conclusion

This guide showed you how to create a Service Account user for Rivery and Cloud Storage Bucket

You now have a Google Cloud Storage connection that you can use in every river that targets to it and also as a source.


Was this article helpful?