Table of Contents

• Example CloudMine Server Code Snippet
  • Getting Started
  • Running Snippets Locally
    • A Note on package.json
    • Obtain a Listing of Available Snippets
    • Executing a Snippet
• Implementation Notes
  • 1. Accessing environment details via the req variable
    • Request Verb
    • Request Body
    • Query String
    • Session Data
    • Cloud or Local Environment
  • 2. Replying to API requests via the reply function
    • Replying with a String or Integer
    • Replying with a JSON Object
  • 3. Preparing the ZIP Package for CloudMine

Example CloudMine Server Code Snippet

This is a example of how to structure your Redox project for running on CloudMine's PaaS.

The lib folder has snippets which are just pieces of node code. index.js contains the code necessary to run your snippets in the cloud and make them accessible through CloudMine's API gateway and to make them accessible within your project.

Getting Started

1. In index.js, the module.exports call must occur before the .start method is called, otherwise Apollo will not be able to identify public snippets available for invocation.
2. CloudMineNode.start requires the current scope, the root file, and has a callback to let you know when the package is ready for inbound requests.

Running Snippets Locally

In order to run your CloudMine Snippets locally, please follow the below instructions.

1. Ensure that all NPM module dependencies are defined in package.json.
2. Run npm install from the root directory to ensure that the dependencies are included into the project.
3. Next, run node index.js to start the server.
4. Finally, curl, wget, or use your favorite method of running HTTP commands using the below examples.

A Note on package.json

The only dependency necessary for your CodeRunner project to run on CloudMine is the cloudmine-servercode module. Make sure that this dependency is setup correctly within your package.json:

"dependencies": {
  "cloudmine-servercode" : "cloudmine/node-coderunner"
}

After you make sure that this is properly referenced, you can use the package.json file to import npm dependencies as you would in any oder node.js project. To include the packages in your project, simply add a

var module = require('MODULE_NAME')

line to any file in which you'd like to use them.

Obtain a Listing of Available Snippets

Request:

localhost:4545/names

Response:

["redox"]

Executing a Snippet

Request:

localhost:4545/code/redox

Response:

This snippet will respond with a message notifying of the objects you've created or updated.

Implementation Notes

Historically, CloudMine snippets use the data environment variable, and the exit function in order to reply to inbound requests. With Apollo, both a new environment variable and exit function will be introduces: req and reply, respectively.

1. Accessing environment details via the req variable

Request Verb

console.log(req.payload.request.method);

Output:

POST

Request Body

console.log(req.payload.request.body);

Output:

{ objId: { key1: 'value1', key2: 'value2' } }

Query String

console.log(req.payload.params);

Output:

{ objId: { key1: 'param1', key2: 'param2' },
  queryStringParam1: 'queryStringValue1',
  queryStringParam2: 'queryStringValue2' }

Session Data

console.log(req.payload.session)

Output:

{ api_key: '4fb3caf6fa53442fb921dd93ae0c98e6',
  app_id: '3f4501961d62bc4eb388d9dc6dfdd1e5',
  session_token: '6c160b8140fc43e28ff9bf7bb00f198e' }

Cloud or Local Environment

Note that process.env.CLOUDMINE may be used to determine whether the code is running locally (false) or in the CloudMine Apollo PaaS environment (true). Example usage is below:

var isCloud = process.env.CLOUDMINE;

if(isCloud){
    console.log("IsCloud!");
    //Configure appropriate environment details
}
else{
    console.log("IsLocal!");
    //Configure appropriate environment details
}

2. Replying to API requests via the reply function

There are two types of values that may be passed into the reply function: Strings and Ints as well as JSON objects.

Replying with a String or Integer

When using the reply function with only a String or Integer, the value will be returned as part of the result key.

Example:

var a = 6;
reply(a);

or

var b = "This is a string!";
reply(b);

Output:

{
  "result": 6
}

or

{
  "result": "This is a string!"
}

Replying with a JSON Object

When replying with a JSON shape, the contents of the object will be nested within the result shape.

Example:

setTimeout(function() {
    reply({text: 'This took 5 seconds!'});
  }, 5000);

Output (after 5 seconds):

{
  "result": {
    "text": "This took 5 seconds!"
  }
}

3. Preparing the ZIP Package for CloudMine

When uploading your ZIP package to CloudMine's servers, please be sure that:

• the node_modules folder is removed, and
• all .git files are removed

To help with this process, we have included a ZIP CLI example below:

zip -r code.zip code-folder/ -x *.git* -x *node_modules*

However, you can also navigate to your root folder through Finder on Mac, or your OS's equivalent, right-click the file, and compress it.

With your compressed folder, navigate to the Logic Engine section of the CloudMine Developer Dashboard (Compass), and drag your .zip file into the upload pane.

Note:

1. code.zip refers to the final package name
2. code-folder refers to the root folder of the package