Google Cloud Storage Connection

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

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

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
      

   4. Choose key type JSON and click on create

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

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 Storage

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

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:

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

, 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.