Skip to main content

How to prepare my project for Front-Commerce Cloud?

Get the steps to make your project ready to be deployed on Front-Commerce Cloud.

The following steps will allow your project to be deployed on our cloud solution.

Step 1: Update your configuration

Note: you can use an if (process.env.FRONT_COMMERCE_CLOUD_VERSION === "2") condition to return a different configuration depending on the deployment target (i.e: FC Cloud v2, local or other hosting)

Step 2: Setup your repository

You must set up your repository to connect with the cloud continuous deployment using the information provided by the Front-Commerce team:

  • Add the deploy key with read-registry permissions
  • Add the webhook URL with the configuration based on your git provider below:

Gitlab Webhook

  • URL: The webhook URL provided by the Front-Commerce team.
  • Secret token: Leave empty.
  • Trigger: Enable all options.
  • SSL verification: Enable SSL verification.

Github Webhook

  • Payload URL: The webhook URL provided by the Front-Commerce team.
  • Content type: application/json
  • Secret: Leave empty.
  • Trigger events: Send me everything.
  • Active: enabled

Bitbucket Webhook

  • Title: Front-Commerce Cloud
  • URL: The webhook URL provided by the Front-Commerce team.
  • Status: Active
  • SSL/TLS: keep the Skip certificate verification unchecked.
  • Triggers: Repository → Push

Step 3: Provide the following information to the front-commerce team

  • The repository URL, using the SSH clone URI (e.g. git@gitlab.com:<group>/<repo>.git)
  • The Node.js LTS version to use (we default to the currently active LTS version)
  • For each application in your repository (single / multiple app)
    • The environment variables for both the staging and the production environment
    • The location of the .front-commerce.js file to use, if it is located elsewhere than at the repository's root
    • Note: if you are migrating from Front-Commerce Cloud V1, we will be able to gather them automatically

🎉 That's it! You should now be ready to deploy on Front-Commerce Cloud