1. Installing DCloud
Before doing anything you'll need to install our CLI tool on your local machine.
This can be done using npm.
-g will install it globally so you can use it where ever you want.
To test it's working run
dcloud. You should list a list of available commands.
2. Logging in
The next step is to log into your cloud account.
From your terminal window run the login command.
You'll be asked to go to https://app.deity.cloud/sign-in/authorization-token in order to generate the token for your account (you'll have to sign in with your account to access it).
Once the token is generated you can copy it from the browser and paste into CLI.
If you've not yet created an account please contact our support.
To check you're logged in correctly run
3. Configure your code repository
You'll need to have a Falcon app in a code repository ready to deploy.
To do this please follow these steps.
Link your code repository
If you've followed the instructions above you'll have added a webhook to your repo. This will automatically link it to your
dcloud account. n.b. You'll need to push at least one commit before the repo is linked.
To check this run the following command:
4. Configure your app
Depending on the setup you are running you'll need to set various environement variables. These include BigCommerce, Algolia and Stripe credentials. To learn more about configuration please read these docs.
To set variables using dcloud use the following command:
Each integration will have a different set of required environment variables. These can be found listed with their individual integration guides:
Alongside 3rd party integrations there are a few other core configurations you might want to set:
We use NodeMailer and a list of available email services can be found there.
MAILER_SERVICE: email service provider e.g.
MAILER_USER: email user e.g.
MAILER_PASSWORD: email password
You'll need to define which search API you want to use. Currently only
bigcommerce are supported.
SEARCH_API_NAME: search api e.g.
Google Tag Manager
If you want to use Tag Manager you'll have to set your container ID.
GTM_CODE: gtm container ID e.g.
Example - BigCommerce
This document explains BigCommerce configuration in more details.
There are quite a few confirations you'll need to add. Adding them might look something like the command below:
5. Deploy your code
Find your build ID
Each commit pushed to your repo is created as a build. To check these you can run the command
dcloud build:list. Take note of the build ID for the build you want to deploy.
Choose your environment
Depending on your price plan you may have multiple environments (testing, production etc). To check your environments run
dcloud env:list. Take note of the name of the environment you want to deploy to.
Deploy your build
To deploy your build run the command
dcloud deployment:run [buildId] [environmentName] replacing
environmentName with the values above. You deployment should be very quick as the build is already created.