Mounting GCP Buckets
Latch allows you to mount your own GCP Buckets and use them the same as you would any data on Latch.
Go to the 'Data Tab' and click the 'Mount GCP Bucket' button.
If you have not connected any GCP projects to Latch, click the 'Add Project' button.
Click on the 'Authorize Project Access' button and go through the authentication flow with Google.
This will permit Latch to access the list of the projects that you have access to for 1 hour.
Select the project from the dropdown that contains the bucket you want to mount.
You will need to authorize Latch to list the buckets in your project and give 'Storage Admin' permission to the bucket that you want to mount.
Latch requires the following permissions in your project:
storage.buckets.list
permission on the project level.Storage Admin
on the bucket level.
To give Latch 'storage.buckets.list' permission, go to the 'Create Custom Role' page in your project.
Visit the Create Custom Role page here.
- Give the role name
Bucket Lister
. - Click on Add Permissions and enter
storage.buckets.list
. This will permit Latch to list buckets in your project which is required when mounting your bucket. After you have mounted the bucket, you can remove this permission. - Click on Create.
Go to the 'IAM & Admin' page in your project.
Visit the IAM & Admin page here.
Click on 'Add' and enter the email address 'latch-data@latchbio.iam.gserviceaccount.com' and select the role 'Bucket Lister' that you created.
Click on 'Save'.
To give Latch 'Storage Admin' permission on the bucket level, you need to go to the 'Storage Browser' page in your project.
Visit the Storage Browser page here.
- Click on the bucket that you want to mount.
- Click on Permissions and
Grant Access
. - Enter the email address
latch-data@latchbio.iam.gserviceaccount.com
and select the roleStorage Admin
. - Click on Safe.
Click on 'Verify' on Latch Console to verify that Latch has the required permissions in your project.
Back on the main page, select your project in the list.
You need to enable versioning for your bucket before you can mount it.
- Go to the Storage Browser page in your project.
- Click on the bucket that you want to mount.
- Click on Protection and enable versioning.
Select the bucket you want to mount and click 'Mount/Add Link'.
The modal will close and the bucket you added will appear in the data list.
Removing a Mounted Bucket
Simply hover over the bucket in the data viewer, click the ellipsis and select Remove.
Troubleshooting
My bucket isn’t showing up in the list in the Mount GCP Bucket modal.
This might be because your bucket isn’t versioned. Latch only supports versioned buckets for mounting. To check to see if your bucket is versioned or not, open the bucket in GCP, go to the Protection tab and check that the Object Versioning is enabled.
Was this page helpful?