Please note that downloading your files from Google Cloud Storage may incur network egress fees charged by Google, depending on the size and frequency of the transfers. More information on the official pricing: Google Cloud Storage Pricing.
Google Cloud Storage can be used as a main or an additional source.
How to add a catalogue from Google Cloud Platform (GCP) in Lengow?
Adding a new catalogue
-
In the Catalogue tab, click on “Add a new catalogue”.
-
Select Google cloud storage.
- Connect GCP to Lengow following the next step.
Configuring the GCP connection
Go to the next step if you have a Google service account.
If you don’t already have one, create a Google service account
1. Open your Google cloud console.
2. Navigate to "IAM & admin" > "Service accounts".
3. Click "create service account" at the top.
4. Enter a unique name for the service account, then click "create and continue".
5. Assign the following roles to the service account:
- Monitoring viewer
- Compute viewer
- Cloud asset viewer
- Browser
6. Click "continue", then "done" to complete the creation of the service account.
Add Lengow principal to your Google service account
If you have not yet generated a "Lengow principal" for your organization:
-
In Lengow, once you have selected "Google cloud storage" as a source, click the "generate principal" button.
-
Copy the generated "Lengow principal" and keep it for the next steps.
Grant access in Google Cloud Console
-
In Google Cloud Console, navigate to "IAM & admin" > "Service accounts".
-
Select the service account from the list.
-
Go to the "Permissions" tab and click "Grant access".
-
Paste your "Lengow principal" into the "New principals" text box.
-
Assign the role "Service account token creator" and click Save.
Grant Access to the Bucket
In addition to configuring the "service account" and assigning the "service account token creator role" to Lengow:
- In Google cloud console, navigate to "Storage".
- In the "bucket" section, select the bucket where your catalogue file is stored.
- Open the "Permissions tab" of the bucket.
- Click on "Grant access".
- Enter the email of your client service account. The email is found in the "Service account" tab.
This is the one you will also have to provide in Lengow. - Select the role "Storage object viewer".
- Save the changes.
Completing the integration setup in Lengow
-
In Google Cloud Console, go to "Service account" > "Details".
Copy the email associated with the Google service account (e.g.,<sa-name>@<project-id>.iam.gserviceaccount.com). -
Paste this email into Lengow in the "Add service account email" section (as shown in the image below).
-
Then, add the file path of your GCP catalogue.
In your Google cloud console, navigate to cloud storage. In the bucket tab bucket, copy the gsutil URL. - Paste the gsutil URL into your Lengow account.
Note: If you need to transfer your catalogue to GCP, please contact your Lengow support for assistance.
Adding a second GCP catalogue in Lengow
To add an additional catalogue from GCP:
-
In the catalogue tab, click on “add a new catalogue”. The name of the second file must be different and should be placed in a different "bucket".
-
Select Google clous storage source.
-
Since the Lengow principal is already generated, you do not need to create a new one.
-
Use the same Google service account email as the first catalogue.
-
Enter the file path of the new catalogue in Lengow.
-
Confirm the setup and finalize the integration.