Before you begin
Please ensure you have the following details ready to configure iconik with your Google Cloud Storage (your Google Cloud administrator should be able to provide these if you don’t have them):
- Service Account JSON - The Service account JSON for the Google Cloud Storage account that you wish to use.
- Bucket - The name of the Google Cloud Storage bucket you wish to use.
- Path - If left empty, iconik will use the whole bucket. Otherwise defines which part of the bucket the storage should start at.
- Project - The Google Cloud Project name which the bucket resides.
If you are setting up a third party bucket we strongly recommend you read our knowledgebase article Controlling Costs as using iconik with third party buckets may cause costs for you.
Setup Permissions
The service account you are using need to have the following permissions to work correctly:
storage.buckets.get storage.buckets.update storage.objects.list storage.objects.create storage.objects.delete storage.objects.get storage.admin
The storage.admin role is only required during setup for settings CORS on the bucket. It can be removed after.
The easiest way to achieve this is to add the roles Storage Legacy Bucket Owner, and Storage Legacy Object Owner. Note that Bucket Owner is not enough on its own.
Roles
These are the iconik roles that are needed:
- Owner
- read storage
- write storage
- reindex storage
Where to connect the storage
- Click on ADMIN in the top navigation.
- Choose Storages from the left navigation bar.
- In the + Connect Storage section, select the Google Cloud option from the list of available storages:
Connecting your Google Cloud Storage
To successfully connect your Google Cloud storage to iconik, fill out the required fields presented in the guided step-by-step wizard. You can expand the Help pop out to provide more context as you complete each step.
Step 1 - Setup
- Enter the purpose of the storage you’re connecting:
- Files: stores all file types except keyframes and proxies.
- Keyframes: stores only keyframes generated by iconik.*
- Proxies: stores only proxies generated by iconik.*
- Exports: will be used as a destination for export jobs.
- Archive: will be used as an archive destination.
*Note: Adding your own keyframe and proxy storages will incur an additional monthly cost.
- Enter a unique name for your storage that will be easily recognizable for yourself and your team.
- Optional - enter a brief description of what this storage is used for.
- Enable or disable the available options:
- Read: this will allow iconik to read files on the storage.
- Write: this will allow iconik to write files to the storage.
- Delete: this will allow iconik to delete files on this storage. If this is enabled, files deleted from iconik will also be deleted from this storage.
- Add unique ID to filename: this will allow iconik to add a unique ID to each file within the storage, to avoid filename duplication.
- Select “Next” to continue.
Step 2 - Credentials
- Copy and paste the JSON for the configured service account into the textbox provided.
- Enter the name of the Google Cloud storage bucket you want to connect.
- Enter the name of the Google Cloud Project where the storage bucket resides.
- For file or archive storages, choose whether you will enable the ability for iconik to scan for new files on the storage.
- Optional - if Scan is enabled, you can enter specific scan directories to limit the scanning of these directories only.
- Recommended - If Scan is enabled, you can enable the Collection Directory Mapping toggle. This will automatically mirror the folder structure within your directory to a collection structure within iconik.
*Note: You can customize the scan settings after the storage is connected.
- Optional - Select any of the transcoders that Iconik provides or have been set up previously by your team.
- Select “Verify” to continue.
Step 3 - Verification
Iconik will verify the credentials that you have provided.
If verification is successful, please complete the process by selecting “Connect” and reviewing the storage settings. There may be some additional customization that you want to complete.
If verification is not successful, you can use the “Back” button to visit the previous steps and update the highlighted fields. If you’re making changes outside of iconik and want to run the verification process again, please choose “Retry”.
Next steps
Once you have successfully connected your Google Cloud storage, review the storage and scan settings available to ensure that is is configuration is optimized for your workflows.
Read next >> editing Google Cloud Storages