From eef572e22986be73d8ea1d5d8add879e6c57d075 Mon Sep 17 00:00:00 2001 From: Tom Sanfilippo Date: Wed, 25 Apr 2018 01:30:21 -0400 Subject: [PATCH] doc improvements/additions --- lib/jobs/create.js | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/lib/jobs/create.js b/lib/jobs/create.js index d355698..70ec519 100644 --- a/lib/jobs/create.js +++ b/lib/jobs/create.js @@ -20,13 +20,13 @@ const chalk = require('chalk'); * @method create * @description Create a new Paperspace job, and tail its log output if run at the command line. To disable the tailing behavior specify '--tail false'. Note: if a project is not defined for the current working directory, and you are running in command line mode, a project configuration settings file will be created. Use '--init false' or specify '--project [projectname]' to override this behavior. * @param {object} params - Job creation parameters - * @param {string} params.container - A required reference to a container name or container link to be used for the job. - * @param {string} [params.machineType] - An optional machine type to run the job on: either 'GPU+', 'P4000', 'P5000', 'P6000', 'V100', 'K80', or 'P100'.

Defaults to 'K80'.

Note: the 'K80' and 'P100' machineTypes run on Google Cloud Platform (GCP). The other machineTypes run on the Paperspace Cloud. Google Cloud platform and Paperspace Cloud have distict Job Storage spaces; Job storage is not currently shared between these two cloud environments. - * @param {string} [params.name] - An optional name or description for this job. If ommitted, the job name defaults to 'job for project [projectname]'. + * @param {string} params.container - A required reference to a docker image in a public or private docker registry, or a container name provided by Paperspace. Docker image repository references must be in lowercase and may include a tag and a hostname prefix followed by a slash; if ommitted the hostname defaults to that of the public Docker Hub registry. An example docker image reference: 'docker.io/mynamespace/myimage:mytag'. A container name may be mixed case. (Designated container names are currently only provided as part of various Gradient tutorials and samples.) + * @param {string} [params.machineType] - An optional machine type to run the job on: either 'GPU+', 'P4000', 'P5000', 'P6000', 'V100', 'K80', 'P100', or 'TPU'.

Defaults to 'K80'.

Note: the 'K80', 'P100', and 'TPU' machineTypes run on Google Cloud Platform (GCP). The other machineTypes run on the Paperspace Cloud. Google Cloud platform and Paperspace Cloud have distict Job Storage spaces; Job storage is not currently shared between these two cloud environments. + * @param {string} [params.name] - An optional name or description for this job. If ommitted, the job name defaults to 'job N' where N represents the Nth job instance for the given project. * @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. 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.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 optionally prefix it with 'git+', e.g. 'https://github.com/MyProjects/MyRepo.git'. If the 'git+' prefix is not specified, it is added at the time of download to the job runner machine. 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.