Contact Support

Connecting GCS Buckets

After creating a GCS bucket, you need to connect it to Athera and assign some Roles before you can access your content. If you haven't created a bucket yet, have a look at Creating GCS Buckets.

Note:  Orbit Desktop Client v3.1.0 ships with a GCS Helper Utility, which guides you through the process of creating, authenticating, and connecting GCS storage buckets. To access the utility, download and unzip the latest Orbit Desktop Client for your operating system from https://orbit.athera.io/versions/ and then run the gcs-helper from the orbit-client directory.

The GCS Helper Utility is currently only available for Mac and Linux operating systems. Windows support will be added in a future release.

Creating a Service Account

The first step to connect your bucket is to create a Service Account and private key JSON file to restrict which Context has access to your bucket. The Service Account JSON is a secure key generated from a GCP Service Account. The service account provides limited permissions to Athera using Roles, which safeguard your other GCP resources.

1.   If you don't already have a Service Account, create one by navigating to IAM & admin > Service accounts in the left-hand menu.
2.   Click Create service account.

The Create service account dialog is displayed.

3.   Enter a Service account name . The account name should be a description of the account's purpose. The Service account ID is completed automatically as you type the account name.
4.   Leave the account Role blank. Roles are assigned at bucket level.
5.   Enable Furnish a new private key and select JSON as the Key type.
6.   Click Save.

A new account is created and the JSON file is downloaded to your machine's default download directory. For example, on Windows:

C:\Users\<user_name>\Downloads

7.   Copy the service account email address to the clipboard.

8.   Navigate to StorageBrowser and click the more options button next to the required bucket ID.
9.   Select Edit bucket permissions.
10.   Paste the service account email address into the Add members field.
11.   Click Select a role and check the Storage Object Admin, Storage Object Creator, and Storage Object Viewer roles.
12.   Click Add to complete the process.

Connecting Buckets in Athera

After creating a private key JSON file and assigning bucket Roles, you can connect your bucket to the required Athera Context. The bucket is only available in the selected Context, so your data is protected.

1.   Click the Context page in the Athera dashboard and select the required Context. You can add storage at Org, Project, and Team level.

For example, Team level might look like this: CoolFX | 360 Shoot | Tracking

2.   Click Connect Cloud Storage.

Note:  If you cannot see the Connect Cloud Storage button, you may not have the correct permissions for this context.

3.   Select GCS from the dropdown.

The Connect Cloud Storage dialog displays.

4.   Enter the following information:

Storage Mount Name - the bucket name within Athera. Using the same name as the GCS bucket is a good way to stay organized.

Bucket ID - the bucket ID in your GCS account. The bucket ID in both Athera and GCS must match exactly. The Bucket ID is the name as it appears in the GCP Browser. For example, org_storage as shown in the image.

Service Account JSON - the contents of a GCP generated JSON file. Click Choose file and browse to the location of the Service Account JSON file.

See Connecting GCS Buckets for information on how to generate a JSON file.

5.   Click Continue.

Your GCS storage bucket is now registered with Athera, and is available to all future sessions from the specified mount location.

Note:  Only sessions started after connecting the bucket can access the new data location. Older sessions must be restarted before they can access the new data location.

6.   Access your GCS bucket from in-App browsers here:

/data/gcs/<bucket_name>

You can manage your GCS bucket content outside of Athera using GCP Console, the gsutil command-line tool, or a third-party application such as Cloudberry Explorer. See Managing GCS Cloud Storage for more information.