Deploy to AWS with S3 and CloudFront

Prerequisites

Before you get started, you need to have:

• An AWS account.
• A Merchant Center account and a Project.
• A customization configured in the Merchant Center:
  • For Custom Applications, see Managing Custom Applications.
  • For Custom Views, see Managing Custom Views.

Configuration

Add the customization identifier and URL

Depending on the customization type, you'll need to specify either the Custom Application ID or the Custom View ID that was provided to you when you added the customization in the Merchant Center.

• Add the Custom Application ID to env.production.applicationId.
• Add the production URL of your CloudFront site to env.production.url.

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

• Add the Custom View ID to env.production.customViewId.
• Add the production URL of your CloudFront site to env.production.url.

const config = {
  env: {
    production: {
      customViewId: 'ckvtahxl90097sys6har1e6n3',
      url: 'https://<site>.cloudfront.net',
    },
  },
  // ...
};

Use environment variables

Example of environment variables with Custom Applications:

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

Example of environment variables with Custom Views:

const 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 customization, you need to create some resources in AWS, like an S3 bucket, configure a CloudFront distribution, etc.

Production bundles

Test your deployment

Install your customization in the Merchant Center to access it within your Projects:

• For Custom Applications, see Managing Custom Applications. You can also use deployment previews to test the application before releasing it to the production environment.
• For Custom Views, see Managing Custom Views.