Deploying to AWS with S3 and CloudFront

Prerequisites

Before you get started, you need to have:

• An AWS account.
• A commercetools account and a Project.
• A Custom View configured in the Merchant Center.

Configuration

In your Custom View config, provide the Custom View ID you got when you configured the Custom View in the Merchant Center.

Moreover, you need to provide the production URL from your CloudFront site. You can keep the standard CloudFront URL https://<site>.cloudfront.net or provide your custom domain.

{
  "env": {
    "production": {
      "customViewId": "ckvtahxl90097sys6har1e6n3",
      "url": "https://<site>.cloudfront.net"
    }
  }
}

Using environment variables

In case you want to avoid hardcoding certain values, for example the Custom View ID, or the Project key, you can use variable placeholders in your Custom View config.

{
  "env": {
    "production": {
      "customViewId": "${env:CUSTOM_VIEW_ID}",
      "url": "https://<site>.cloudfront.net"
    }
  }
}

Set up S3 and CloudFront

To host the production bundles of your Custom View you need to create some resources in AWS, like an S3 bucket, configure a CloudFront distribution, etc.

Production bundles

The main command to create the production bundles is mc-scripts build. The output folder is public.
See Going to production for more information.

Test your deployment

In the Merchant Center you can now follow the steps to install the Custom View and access it in your Projects.