Modules Commands

The Cloud CMS command-line tool provides developers with a command-line driven mechanism that allows them to:

• register and unregister user interface modules
• deploy and undeploy user interface modules

User Interface Modules are deployed from public Git repositories (such as GitHub) and consist of AMD JavaScript modules. These modules contain JavaScript, HTML, CSS, a JSON configuration file any additional client-side assets that may be used (such as images).

For more information and to learn more, please see User Interface Modules.

This article provides some examples of common commands.

List

To list the registered modules:

cloudcms module list

Register

To register a user interface module:

cloudcms module register --id <moduleId> --sourceType <sourceType> --sourceUrl <sourceUrl> --sourcePath <sourcePath> --sourceBranch <sourceBranch>

The moduleId should be the ID of the module as identified in the module's module.json file.

The sourcePath switch is optional. If not provided, the default is /. The sourceBranch switch is also optional. If not provided, the branch will be assumed to be master.

For example, to register the sample UI module, you could run:

cloudcms module register --id sample --sourceType github --sourceUrl https://github.com/gitana/cloudcms-ui-sample-addon --sourcePath /dist

Unregister

To unregister a currently registered module:

cloudcms module unregister --id <moduleId>

For example, to unregister the sample UI module, you could run:

cloudcms module unregister --id sample

Deploy

Once a module is registered with the Cloud CMS user interface, you can deploy it like this:

cloudcms module deploy --id <moduleId>

For example, to deploy the sample UI module, you could run:

cloudcms module deploy --id sample

Deploy

To undeploy a deployed module, you can run:

cloudcms module undeploy --id <moduleId>

For example, to undeploy the sample UI module, you could run:

cloudcms module undeploy --id sample

Note that undeploying the module will not unregister it. It will still be registered such that you could call deploy to redeploy it.

Redeploy

You can also use the redeploy command to undeploy and deploy a module. If a module isn't already deployed, it will be deployed anew.

cloudcms module redeploy --id <moduleId>