{"_id":"592892c1712e642f00428f21","category":{"_id":"5785191af3a10c0e009b75b0","version":"55faf11ba62ba1170021a9aa","__v":0,"project":"55faf11ba62ba1170021a9a7","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-07-12T16:21:46.337Z","from_sync":false,"order":28,"slug":"connect-cloud-storage","title":"CONNECT CLOUD STORAGE"},"version":{"_id":"55faf11ba62ba1170021a9aa","project":"55faf11ba62ba1170021a9a7","__v":45,"createdAt":"2015-09-17T16:58:03.490Z","releaseDate":"2015-09-17T16:58:03.490Z","categories":["55faf11ca62ba1170021a9ab","55faf8f4d0e22017005b8272","55faf91aa62ba1170021a9b5","55faf929a8a7770d00c2c0bd","55faf932a8a7770d00c2c0bf","55faf94b17b9d00d00969f47","55faf958d0e22017005b8274","55faf95fa8a7770d00c2c0c0","55faf96917b9d00d00969f48","55faf970a8a7770d00c2c0c1","55faf98c825d5f19001fa3a6","55faf99aa62ba1170021a9b8","55faf99fa62ba1170021a9b9","55faf9aa17b9d00d00969f49","55faf9b6a8a7770d00c2c0c3","55faf9bda62ba1170021a9ba","5604570090ee490d00440551","5637e8b2fbe1c50d008cb078","5649bb624fa1460d00780add","5671974d1b6b730d008b4823","5671979d60c8e70d006c9760","568e8eef70ca1f0d0035808e","56d0a2081ecc471500f1795e","56d4a0adde40c70b00823ea3","56d96b03dd90610b00270849","56fbb83d8f21c817002af880","573c811bee2b3b2200422be1","576bc92afb62dd20001cda85","5771811e27a5c20e00030dcd","5785191af3a10c0e009b75b0","57bdf84d5d48411900cd8dc0","57ff5c5dc135231700aed806","5804caf792398f0f00e77521","58458b4fba4f1c0f009692bb","586d3c287c6b5b2300c05055","58ef66d88646742f009a0216","58f5d52d7891630f00fe4e77","59a555bccdbd85001bfb1442","5a2a81f688574d001e9934f5","5b080c8d7833b20003ddbb6f","5c222bed4bc358002f21459a","5c22412594a2a5005cc9e919","5c41ae1c33592700190a291e","5c8a525e2ba7b2003f9b153c","5cbf14d58c79c700ef2b502e"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"githubsync":"","user":"5613e4f8fdd08f2b00437620","project":"55faf11ba62ba1170021a9a7","__v":0,"parentDoc":null,"metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-05-26T20:40:33.842Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":12,"body":"## Overview\n\nThe procedure below will explain how to attach a Google Cloud Storage volume for use on the CGC's visual interface.\n\n## Prerequisite\n1. A [Google Cloud Platform (GCP)](https://cloud.google.com/) account\n2. One or more buckets on this GCP account.\n\n## Procedure\n1. [Navigate to the Volumes dashboard](#step-1).\n2. [Choose the cloud storage provider for your volume](#step-2).\n3. [Obtain IAM user details](#step-3).\n4. [Enter IAM user credentials on the CGC](#step-4).\n5. [Authorize the IAM user to access your GCS bucket](#step-5).\n6. [Provide bucket details](#step-6).\n7. [Review volume details and connect your volume](#step-7).\n\n<a name=\"step-1\"></a>\n## Step 1: Access the Volumes Dashboard\n1. On the CGC, click on the **Data** tab of the top navigation bar.\n2. Select **Volumes** from the drop-down menu.\n\n<a name=\"step-2\"></a>\n## Step 2: Choose a cloud storage provider\n1. On the Volumes Dashboard of the CGC, click **+ Connect Storage.**\n2. Select **Google Cloud Platform** as your cloud storage provider.\n3. Click **Next**.\n\n<a name=\"step-3\"></a>\n## Step 3: Obtain IAM user details\n\nPrior to attaching your GCS bucket to the CGC, you must register it as a volume on the [Google Cloud Platform console](https://console.cloud.google.com/).\n1. Log into the [Google Cloud Platform console](https://console.cloud.google.com/).\n2. From the menu on the left select **IAM & Admin** > **Service accounts**.\n3. Click + **Create service account** below the search bar.\n4. Fill in account details:\n    * **Service account name** - Descriptive name to label the account.\n    * **Service account ID** - Generated automatically based on the entered service account name. Can be modified if necessary.\n    * **Service account description** - More elaborate description of the account’s purpose.\n5. Click **Create**. The **Service account permissions** screen opens.\n6. In the **Select a role** dropdown, select **Storage** > **Storage Object Viewer**.\n7. Click **Continue**. The final screen of the wizard opens.\n8. In the **Create key** section click **+ Create key**. Key options are displayed on the right.\n9. In the **Key type** list select **JSON**.\n10. Click **Create**. Your browser will download a JSON file containing the credentials for this user. Keep this file safe.\n\n<a name=\"step-4\"></a>\n## Step 4: Enter IAM user credentials\n\nOn the CGC, enter your IAM credentials in the **Credentials** tab as found in the downloaded JSON from the previous step. \n1. In the **Service account email** field enter the email address from the **client_email** key in the downloaded JSON file..\n2. From the downloaded JSON file, copy the entire value of the private key.\n3. Paste the key into the **Private key** field on the CGC.\n4. Click **Next**.\n\n<a name=\"step-5\"></a>\n## Step 5: Authorize the IAM user to access your GCS bucket\n\nIf you have not authorized the IAM user to access your GCS bucket, follow the directions below on the [Google Cloud Platform console](https://console.cloud.google.com/).\n1. On the [Google Cloud Platform console](https://console.cloud.google.com/), click  in the top-left corner and navigate to the **Storage** section\n2. Select **Storage** > **Browser**.\n3. Locate your bucket and click the three vertical dots to the far right of your bucket's name.\n4. Click **Edit bucket permissions.**\n5. Click **Add members**.\n6. In the **New members** field enter the service account client's email. This email is located in the JSON downloaded in the previous section.\n7. From the **Select a role** drop-down menu, select **Storage Legacy** > **Storage Legacy Bucket Reader**.\n8. Click **Save**. You have now authorized the newly-created IAM user to access the storage bucket.\n\n<a name=\"step-6\"></a>\n## Step 6: Provide GCS bucket details\n1. On the CGC, click **Next** until you reach the **Bucket** tab in the **Connect a Volume** wizard.\n2. Enter your GCS bucket name.\n3. Optionally, define a new name for the volume created from this GCS bucket on the CGC.\n4. Optionally enter a description for your volume.\n5. Select access privileges: choose **Read only (RO)**. **Read and Write (RW)** mode is currently not supported for GCS Volumes.\n6. Optionally enter a prefix. Learn more about [prefixes](doc:volumes#prefix).\n7. Click **Next**.\n\n<a name=\"step-7\"></a>\n## Step 7: Review volume details\n\nIn this tab, review the details for your volume and click **Connect**.\n\n## Next step\n\nCongratulations! You've attached your volume to the CGC. You can make individual data objects within it available as \"aliases\" on the CGC. Aliases point to files stored on your cloud storage bucket and can be copied, executed, and organized like normal files on the CGC. We call this operation \"importing\". Learn more about [working with aliases](doc:aliases).","excerpt":"","slug":"attach-a-google-cloud-storage-volume","type":"basic","title":"Attach a Google Cloud Storage volume"}

Attach a Google Cloud Storage volume


## Overview The procedure below will explain how to attach a Google Cloud Storage volume for use on the CGC's visual interface. ## Prerequisite 1. A [Google Cloud Platform (GCP)](https://cloud.google.com/) account 2. One or more buckets on this GCP account. ## Procedure 1. [Navigate to the Volumes dashboard](#step-1). 2. [Choose the cloud storage provider for your volume](#step-2). 3. [Obtain IAM user details](#step-3). 4. [Enter IAM user credentials on the CGC](#step-4). 5. [Authorize the IAM user to access your GCS bucket](#step-5). 6. [Provide bucket details](#step-6). 7. [Review volume details and connect your volume](#step-7). <a name="step-1"></a> ## Step 1: Access the Volumes Dashboard 1. On the CGC, click on the **Data** tab of the top navigation bar. 2. Select **Volumes** from the drop-down menu. <a name="step-2"></a> ## Step 2: Choose a cloud storage provider 1. On the Volumes Dashboard of the CGC, click **+ Connect Storage.** 2. Select **Google Cloud Platform** as your cloud storage provider. 3. Click **Next**. <a name="step-3"></a> ## Step 3: Obtain IAM user details Prior to attaching your GCS bucket to the CGC, you must register it as a volume on the [Google Cloud Platform console](https://console.cloud.google.com/). 1. Log into the [Google Cloud Platform console](https://console.cloud.google.com/). 2. From the menu on the left select **IAM & Admin** > **Service accounts**. 3. Click + **Create service account** below the search bar. 4. Fill in account details: * **Service account name** - Descriptive name to label the account. * **Service account ID** - Generated automatically based on the entered service account name. Can be modified if necessary. * **Service account description** - More elaborate description of the account’s purpose. 5. Click **Create**. The **Service account permissions** screen opens. 6. In the **Select a role** dropdown, select **Storage** > **Storage Object Viewer**. 7. Click **Continue**. The final screen of the wizard opens. 8. In the **Create key** section click **+ Create key**. Key options are displayed on the right. 9. In the **Key type** list select **JSON**. 10. Click **Create**. Your browser will download a JSON file containing the credentials for this user. Keep this file safe. <a name="step-4"></a> ## Step 4: Enter IAM user credentials On the CGC, enter your IAM credentials in the **Credentials** tab as found in the downloaded JSON from the previous step.  1. In the **Service account email** field enter the email address from the **client_email** key in the downloaded JSON file.. 2. From the downloaded JSON file, copy the entire value of the private key. 3. Paste the key into the **Private key** field on the CGC. 4. Click **Next**. <a name="step-5"></a> ## Step 5: Authorize the IAM user to access your GCS bucket If you have not authorized the IAM user to access your GCS bucket, follow the directions below on the [Google Cloud Platform console](https://console.cloud.google.com/). 1. On the [Google Cloud Platform console](https://console.cloud.google.com/), click  in the top-left corner and navigate to the **Storage** section 2. Select **Storage** > **Browser**. 3. Locate your bucket and click the three vertical dots to the far right of your bucket's name. 4. Click **Edit bucket permissions.** 5. Click **Add members**. 6. In the **New members** field enter the service account client's email. This email is located in the JSON downloaded in the previous section. 7. From the **Select a role** drop-down menu, select **Storage Legacy** > **Storage Legacy Bucket Reader**. 8. Click **Save**. You have now authorized the newly-created IAM user to access the storage bucket. <a name="step-6"></a> ## Step 6: Provide GCS bucket details 1. On the CGC, click **Next** until you reach the **Bucket** tab in the **Connect a Volume** wizard. 2. Enter your GCS bucket name. 3. Optionally, define a new name for the volume created from this GCS bucket on the CGC. 4. Optionally enter a description for your volume. 5. Select access privileges: choose **Read only (RO)**. **Read and Write (RW)** mode is currently not supported for GCS Volumes. 6. Optionally enter a prefix. Learn more about [prefixes](doc:volumes#prefix). 7. Click **Next**. <a name="step-7"></a> ## Step 7: Review volume details In this tab, review the details for your volume and click **Connect**. ## Next step Congratulations! You've attached your volume to the CGC. You can make individual data objects within it available as "aliases" on the CGC. Aliases point to files stored on your cloud storage bucket and can be copied, executed, and organized like normal files on the CGC. We call this operation "importing". Learn more about [working with aliases](doc:aliases).