DEITY Falcon Cloud CLI tool

dcloud is a tool to control, monitor and trigger your deployments to DEITY Falcon Cloud.

In order to use it, install it globally with:

npm i -g dcloud

Changelog

0.28.1

• fixed issues with redirects uploading

0.28.0

• added possibility to enable/disable SEO indexing for particular environment details here
• added possibility to enable/disable maintenance mode of environments details here
• added possibility to display logs as list details here

0.27.0

• added possibility to add/remove webhooks that will be called after deployment details here

0.26.0

• added possibility to configure access to environments only for users who have DeityCloud account details here

• added possibility to configure access to environments only for predefined IP addresses details here

0.25.0

• added possibility to configure branches which will be build automatically details here

0.24.0

• adjusted all dependencies to work with the newest node.js versions

0.23.0

• added possiblity to run build for particular commit details here

0.22.0

• changed authentication to use the new configuration

0.21.0

• added possibility to select user role when sending invitation details here

0.20.2

• Fixed issue during rendering logs when using log:watch command

0.20.1

• Improved messaging of domain verification process

0.20.0

• Added wizard for domain creation and SSL certificate validation details here
• Added --module option to search logs module field details here

0.19.1

• fixed issue with loading environment variables from file

0.19.0

• Added --data-file, -d flag that gives the possibility to load the value of environment variable from a file so it doesn't stay in the bash history details here
• Added --base64, -e flag that encodes the value of passed environment variable as base64 before sending to the api details here
• Added --from-file, -f flag that gives the possibility to set multiple environment variables at once (by loading them from specified file) details here

0.18.1

• Fixed issues with table rendering during log streaming

0.18.0

• Added support for external domains details here
• Added information about outdated builds

0.17.1

• Improved handling of currency configuration for DPSG
• Fixed warning about missing dependencies

0.17.0

• Added payments:customer-map:add command for adding mappings between shop customer and psp customer details here

0.16.1

• Fixed issues with displaying special characters in tables

0.16.0

• Added --path option to purge cdn domain - details here
• Added command dcloud env:cache:flush that flushes the environment cache - details here

0.15.1

• The command dcloud project:current:set can now be executed without the organization and project flag. When doing so, you can select the project using an interactive prompt.

0.15.0

• Added command to delete a payment profile
• Added command to update a payment profile
• Renamed payments:env commands to payments:profile.
• Removed the payments:region commands. This functionality is replaced by region prompts on most payments commands.
• Added command to auto-generate/sync the payments profiles to the project environment payments:profile:sync.
• Added command to update a payment method

0.14.0

• added optional --phrase parameter to filter logs by passed search phrase.

0.13.3

• Added automatic redirect to the login page if authentication is no longer valid
• Added information about environment location to dcloud env command
• Improved display of environment details

0.13.2

• Fixed an issue that presented the countries list when configuring the currencies of a payment provider.
• Restricted the input for Merchant's store country when configuring the Humm payment provider.

0.13.1

• Added commands to set/get the DPSG region - details here
• Added ability to set minimum and maximum amounts when configuring payment methods - details here
• Fixed issue with user:invite command

0.12.1

• Fixed an issue (typo) in the applyToken (DPSG) command, that resulted in environment variables not being set properly for that command

0.12.0

• Added "environment apply" command for DPSG, to configure the DPSG environment variables on the Deity Cloud Environment - details here

0.11.0

• Added DPSG commands - details here

0.10.0

• Added logs filtering (by application name) - details here
• Added logs stream filtering (by application name) - details here
• Added CDN purge command - details here
• Added CDN purge status progress command - details here
• Added upload CSV file with redirects command - details here
• Added delete all redirects command - details here
• Updated internal dependencies to improve security
• Added possibility to select version of FalconPlatform for particular environment - details here

0.9.0

• Added logs filtering (by date range, and severity) - details here
• Added log output formatting - it's now possible to print log entries as JSON - details here
• Added possibility to fetch single log item by its id - details here

Available commands:

Build List

List your current builds.

dcloud build:list

Options

• -l Limit the results
• -p Which page of results to show

Example: show 30 results

dcloud build:list -l 30

---

Build Info

Get information on a build.

dcloud build [id]

Options

• -w Watch a build (if it's not finished)
• -o Show build output to the console

Example: Watch the build with id 20

dcloud build 20 -w

---

Configure branch to be built automatically

By default DeityCloud service runs builds for every single push to the repository. You can change that behavior (to avoid cluttering the build list with unnecessary builds and use less storage) so builds are triggered only for the particular branches (you will still be able to create a build from particular branch or commit).

In order to configure a branch to be built automatically use the following command:

dcloud build:branch:add [branch-name]

Options

N/A

---

Configure a branch to not be built automatically

Remove branch name from the list of automatically built branches after code push

dcloud build:branch:remove [branch-name]

Options

N/A

---

List branches that will be built automatically

List all branch names that will be built automatically after code push

dcloud build:branch:list

Options

N/A

---

Build from commit

Run a new build for particular commit. As parameter you can pass any value that can be passed to git checkout command in your repository

dcloud build:commit [commit-sha|branch-name|tag-name]

Example: Run build for commit 0d88dccc

dcloud build:commit 0d88dccc

Example: Run build for main branch

dcloud build:commit main

Example: Run build for v1.0 tag

dcloud build:commit v1.0

---

Deployment List

List your deployments

dcloud deployment:list

Options

• -l Limit the results
• -p Which page of results to show

---

Deployment Info

Get information on a deployment.

dcloud deployment [id]

Options

• -w Watch a deployment (if it's not finished)
• -o Show deployment output to the console

---

Deploy

Deploy a build

dcloud deployment:run [buildId] [environmentName]

Options

• -y Auto-confirm the deployment process. Useful if you're not deploying manually.

Example: Deploy build 20 to the development environment

dcloud deployment:run 20 development

---

Environments List

List all available environments

dcloud env:list

Options

N/A

---

Environment maintenance mode

Maintenance mode allows you to present a "we're under maintenance" view and do not pass any requests to the application. This allows to perform maintenance of 3rd party systems without disruption from the PWA/Middleware users.

When maintenance mode is enabled all the request are routed to the maintenance.html view which should be placed in public folder of your frontend application.

Enable maintenance mode of environment

dcloud env:maintenance:enable [env]

Options

N/A

Disable maintenance mode of environment

dcloud env:maintenance:disable [env]

Options

N/A

> NOTE: to be sure that the values are correctly read from your terminal surround variable-value with double quotes, for example:

Environment Info

Get info on a specific environment

dcloud env 

Options

N/A

---

Environment Deployments

Get deployments for an environment

dcloud env:deployments 

Options

• -l Limit the results
• -p Which page of results to show

---

Environment Variable

Set a variable on an environment (this doesn't send the variable to the application immediately. In order to do so you have to either run a deployment or apply saved variables)

dcloud env:var:set   [value]

Options

• -s, --secret marks variable as secret - it's full value cannot be read (will be masked when displaying)
• -d, --data-file Path to the file containing environment variable value
• -e, --base64 Encode the variable value as base64 string before sending it
• -f, --from-file Set multiple environment variables from a file with one command (see information about file format below)

> NOTE: to be sure that the values are correctly read from your terminal surround variable-value with double quotes, for example:

dcloud project:var:set BUILD_TOKEN "abcdefg123"

Format of the file passed to -f (--from-file) option is the following:

FOO=variable value
# comment - will be ignored
BAR=126
BAZ=full string will be taken as value

> NOTE: Everything after first = sign will be passed as variable value - including whitespaces, quotes etc. It means that if you put a string in quotes then these quotes will be included as value (which usually is not intended).

---

Apply environment variables

Applies previously set environment variables to the actual environment. Once applied the application in that environment will be restarted and after restart will have access to the applied environment variables.

dcloud env:var:apply 

Options

N/A

---

Environment Set Domain

Assign a domain to an environment

dcloud env:domain:assign  [domainName]

Options

N/A

---

View Environment domain configuration

Get the configuration of the domain assigned to the environment

dcloud env:domain 

Options

N/A

---

Environment Un-assign Domain

Un-assign a domain from an environment

dcloud env:domain:unassign  [domainName]

Options

N/A

---

Environment upload redirects CSV file

Upload redirects rules

dcloud env:redirects:upload  

CSV File format example:

old_url,new_url
old_url2,new_url2
old_url3,new_url3

Options

N/A

---

Environment delete redirects

Delete redirects

dcloud env:redirects:delete 

Options

N/A

---

Environment flush cache

Flush environment cache

dcloud env:cache:flush 

Options

N/A

---

Available FalconPlatform versions

List available FalconPlatform versions

dcloud env:platform-version:list

Set FalconPlatform version

Change FalconPlatform version for environment (deploy FalconServer in selected version to selected environment)

dcloud env:platform-version:set  

---

Environment access configuration

You can set up environment to be avaialble only for people who have DeityCloud account. That way nobody from outside your team will not be able to see the environment. The access is configurable per environment - you can specify which accounts can see partiular environment.

Enable environment authorization

> Note: after this action is performed you need to call env:var:apply command to synchronize the environment.

dcloud env:auth:enable 

Disable environment authorization

> Note: after this action is performed you need to call env:var:apply command to synchronize the environment.

dcloud env:auth:disable 

List authorized users for environment

dcloud env:auth:list 

Allow user to view the environment

dcloud env:auth:add  

Disallow user to view the environment

dcloud env:auth:remove  

---

Environment IP access configuration

You can set up environment to be avaialble only when viewer IP is on allowed to view it. The IP access is configurable per environment - you can specify which IPs can see partiular environment.

Enable environment IP lock

> Note: after this action is performed you need to call env:var:apply command to synchronize the environment.

dcloud env:ip:allowlist:enable 

Disable environment IP lock

> Note: after this action is performed you need to call env:var:apply command to synchronize the environment.

dcloud env:ip:allowlist:disable 

List allowed IPs for environment

dcloud env:ip:allowlist:list 

Allow IP to allowlist for the environment

dcloud env:ip:allowlist:add   

The name parameter is optional - it's used as label for IP so it's easy to identify it

Remove IP from allow list for the environment

dcloud env:ip:allowlist:remove  

---

Webhooks configuration

> NOTE: Currently, webhooks will be called when deployment to particular environment finishes with sucessfull status.

Add webhook to environment

dcloud env:webhooks:add   

• name is a unique name of webhook so you can identify its purpose
• url is full url that should be called

Example:

dcloud env:webhooks:add production run-tests https://my-test-service/run-tests

List environment webhooks

dcloud env:webhooks:list 

Remove environment webhook

In order to remove webhook call the command below and you'll be presented with list of webhooks that you can select to be removed.

dcloud env:webhooks:remove 

SEO Indexing

By default each environment has indexing enabled. You can however block the indexing robots by toggling this feature and DeityCloud infrastructure will override robots.txt file in your project with the one with the following content:

User-agent: *
Disallow: /

Enable SEO indexing (user project's original robots.txt)

dcloud env:indexing:enable 

Disable SEO indexing (override robots.txt)

dcloud env:indexing:disable 

> NOTE: robots.txt file by default is cached for 15 minutes by CDN so make sure to wait 15 minutes after configuration changes.

List domains

List all the domains created in the project

dcloud domain:list

Create domain

Creates domain (managed by DeityCloud infrastructure or externally) and its configuration but doesn't apply it to an environment, so the domain is not used yet.

You can create many domains in the scope of the project and then assign particular domain to particular environment.

dcloud domain:create 

Options

• --external marks domain as external - if you manage the domain by yourself (e.g. on your CloudFlare account then use this flag)

dcloud domain:create --external my-custom-domain.com

---

Remove domain

Removes the domain from project. Please note that the domain must not be assigned to any environment in order to remove it.

dcloud domain:remove 

Options

N/A

---

Domain Purge CDN cache

Purge CDN cache for a domain

dcloud domain:purge-cdn-cache 

Options

• `-p, --path