add port mapping param to job create; doc updates

Author: sanfilip

lib/jobs/create.js

@@ -25,12 +25,13 @@ var jobs_show = require('./../jobs/show.js');
  * @param {string} [params.project] - The name of the project for this job.  If not provided, this is taken from the .ps_project/config.json file, or the current directory name.
  * @param {string} [params.projectId] - The poject id of an existing project for this job.  Note: if projectId is specified, the project parameter cannot be specified.
  * @param {string} [params.command] - An optional command to run within the workspace or container.
- * @param {string} [params.workspace] - An optional path to a workspace, or link to a git repository to upload and merge with the container.  If a zip file name is provided it is uploaded instead.  If no workspace is provided the current directory is zipped up and transferred.  If the workspace is 'none', no workspace is merged and the container is run as-is.
+ * @param {string} [params.workspace] - An optional path to a workspace, or link to a git repository to upload and merge with the container.  If a zip file name is provided it is uploaded instead.  If no workspace is provided the current directory is zipped up and transferred.  If the workspace is 'none', no workspace is merged and the container is run as-is. To download a git repository provide an https repository link and prefix it with 'git+', e.g. 'git+https://github.com/MyProjects/MyRepo.git'.  S3 links are also supported using the schema 's3://bucketname/objectname'.
  * @param {string} [params.dataset] - An optional reference to a dataset to be merged with the container.
  * @param {string} [params.registryUsername] - An optional username for accessing an image hosted on a private container registry.  Note: you must specify this option every time a private image is specified for the container.
  * @param {string} [params.registryPassword] - An optional password for accessing an image hosted on a private container registry.  Note: you must specify this option every time a private image is specified for the container.
  * @param {string} [params.workspaceUsername] - An optional username for accessing a private git repository.  Note: you must specify this option every time a private git repository is specified for the workspace.
  * @param {string} [params.workspacePassword] - An optional password for accessing a private git repository.  We recommned using an OAuth token (GitHub instructions can be found <a href="https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/">here</a>).  Note: you must specify this option every time a private git repository is specified for the workspace.
+ * @param {string} [params.ports] - An optional list of port mappings to open on the job cluster machine while the job is running.  The port mappings are specified as 'XXXX:YYYY' where XXXX is an external port number and YYYY is an internal port number.  Mulitple port mappings can be provided as a comma separated list. Port numbers must be greater than 1023. Note: only /tcp protocol usage is supported.
  * @param {boolean} [params.tail] - Optional; defaults to true in command line mode only.  Specify false to disable automatic tailing.
  * @param {boolean} [params.json] - Optional; if true, do not write progress to standard out.  '--json' with no value is equivalent to true.
  * @param {function} cb - Node-style error-first callback function
@@ -81,6 +82,10 @@ var jobs_show = require('./../jobs/show.js');
  *   "dtTeardownFinished": null,
  *   "dtDeleted": null,
  *   "exitCode": null
+ *   "storageRegion": "East Coast (NY2)",
+ *   "clusterMachine": "psABCD123",
+ *   "ipAddress": "10.100.0.10",
+ *   "ports": "6006:6006",
  * }
  */
 
@@ -238,6 +243,8 @@ function create(params, cb) {
 					if (state === 'Error' || res.jobError) console.log('Error: ' + res.jobError);
 					return cb();
 				}
+				if (res.storageRegion) console.log('Storage Region: ' + res.storageRegion);
+				if (res.ports && res.ipAddress) console.log('IP Address: ' + res.ipAddress);
 				console.log('Awaiting logs...');
 				return jobs_logs({ jobId: jobId, tail: true  }, function _logsCb(err) {
 					if (err) return cb(err);