Google Cloud Storage (Optional)

If you want to use Google Cloud Storage to save and serve image assets, please follow this section. Otherwise, you can skip. By default, image assets are being served in the project.

Creating Bucket

1. Go to Google Cloud Console and login.
2. Go to Cloud Storage > Bucket.

3. Click Create.
4. Fill up a Name.
5. Click Continue.
6. Keep clicking Continue.
7. Leave everything as default.
8. Create the bucket.
9. Uncheck Enforce public access prevention on this bucket.

10. Click Confirm.
11. Your bucket has been created.
12. Create a folder inside the bucket called uploads (we serve images from this folder).

Giving Permission

1. Go back to the bucket and check the checkbox next to it.
2. Click Permissions.
3. Click SWITCH TO FINE-GRAINED in the Access control section.

4. Click Fine-grained in the pop-up and click Save.
5. Click ADD PRINCIPAL.

6. In the new principal field, enter AllUsers.
7. In the Select a role section, select Cloud Storage > Storage Object Viewer.

8. Save and click ALLOW PUBLIC ACCESS.
9. Your bucket is now publicly accessible.

Setting Up

1. Login to Admin panel and go to Setting > Media Storage.
2. Select Media Storage to GCS.
3. Fill Thumb Prefix – this will be used as a prefix for generated thumbnail images.
4. Fill Default Image – this image will be used if any image is missing.
5. Enter your bucket URL in CDN URL, e.g.:

https://storage.googleapis.com/test-ishop/uploads/

6. To get the Google Cloud Project ID:
   • Go to Cloud Storage > Bucket
   • Click on the project dropdown in the header
   • Copy the ID and paste it into the Admin panel.

7. Fill Google Cloud Storage Bucket with your bucket name.
8. Fill Google Cloud Storage Path Prefix with your folder inside the bucket (e.g., uploads).
9. Click Save.

Service Account Setup

1. Log in to Google Cloud Console.
2. Navigate to IAM & Admin > Service Accounts.
3. Click an existing service account or Create Service Account.
   • Enter a name and optional description.
   • Assign a role: Storage Object Creator or Storage Object Admin.
4. Click Create.
5. Click Actions > Create Key.
6. Choose key type JSON and click Create.
7. A JSON file will be downloaded.
8. Place its contents in service-account.json in your project root.

Use a Subdomain as CDN URL (Optional)

If you want to use a subdomain instead of the Google Cloud Storage URL, follow these steps:

1. Log in to Google Cloud Console.
2. Navigate to Network Services > Load Balancing.
3. Click CREATE LOAD BALANCER.
4. Click START CONFIGURATION from HTTP(S) Load Balancing.
5. Click CONTINUE (keep everything default).
6. Enter a name. Protocol: HTTP.
7. In IP ADDRESS, click CREATE IP ADDRESS.
8. Name it and click Reserve.
9. Click ADD FRONTEND IP AND PORT.
   • Name it, Protocol: HTTPS
   • Choose the reserved IP address
   • Create a Google-managed certificate with your domain
   • Click Create and then Done
10. Create a Backend Configuration:
    • Click CREATE A BACKEND BUCKET
    • Select your bucket
    • Click OK and then Create

11. Copy the Load Balancer IP address.
12. Navigate to Cloud DNS.
    • Create a zone if you don’t have one
    • Click ADD STANDARD
    • Enter your subdomain and paste the IP
    • Click Create