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