Using a GCS Bucket

Google Cloud Storage (GCS) Connectors are secure gateways through which products can be moved in and out of the platform using GCS bucket transfers. It is referred to as a data storage connector. The first step in creating this connector is setting up a storage bucket to store the data you intend to access.

Note: You must have access to an GCS cloud account and know the GCS Account Number. See Create storage buckets for more information. To create a GCP account, please visit Google Cloud Console. If you already have a GCP account, please follow the steps below.

Create a GCS bucket

1. Log into your GCS account.

2. Click Create a storage bucket.
   

   

3. Insert Bucket Name following GCP’s naming guidelines

4. Choose where to store your data

   • For learning purposes, choose Multi-region; however pick whichever works best for you

5. Choose a storage class for your data

   • For this example, select Standard

6. Choose how to control access to object

   1. For this example, select Fine-grained which will enforce public access prevention

7. Choose how to protect object data

   1. For this example, select None

8. Press Create

Now you are ready to connect your storage to the platform via a Connector.

Create the Connector

1. Click Manage on the Navigation bar.

2. Select Connectors to view the Manage Connectors screen

3. Click the Create Connector button at the top right

4. Enter a Name for your Connector and a Description (optional)

5. Choose Type > GCS.

6. Enter your bucket name and optional subdirectory (path/to/dir). The Platform uses these locations when publishing and exporting to the connector.

7. Enter the GCS bucket name.

8. (Optional) Enter the GCS subdirectory.

9. Select GCP Key File (if requested)

10. Click Create and the New GCS connector information page will appear.
    Help: This page informs you that the connector is ready and that the member account and roles are created. It also provides guidance on how to apply the required roles and access permissions to the bucket member account. Ensure bucket access control is set to Fine-grained.

11. Go back to Google Console and log in

12. Go to your bucket

13. Click on Roles > Add

14. Add New principals (This is the member email given to you on platform once you create your connector)

15. Add the following roles:

    • Storage Legacy Bucket Writer

    • Storage Legacy Object Owner

16. Add any Integration Metadata needed for programmatic integration.

17. Click Create. Connection test will run and if successful, will show Connection Test Status as Successful.

18. Click Close.