Implement job run command

CHANGELOG.D/652.feature

@@ -0,0 +1 @@
+Implement *job run* command.

README.md

@@ -4,6 +4,7 @@
 * [Preface](#Preface)
 * [neuro](#neuro)
 	* [neuro job](#neuro-job)
+		* [neuro job run](#neuro-job-run)
 		* [neuro job submit](#neuro-job-submit)
 		* [neuro job ls](#neuro-job-ls)
 		* [neuro job status](#neuro-job-status)
@@ -33,6 +34,7 @@
 		* [neuro completion generate](#neuro-completion-generate)
 		* [neuro completion patch](#neuro-completion-patch)
 	* [neuro help](#neuro-help)
+	* [neuro run](#neuro-run)
 	* [neuro submit](#neuro-submit)
 	* [neuro ps](#neuro-ps)
 	* [neuro status](#neuro-status)
@@ -102,6 +104,7 @@ Name | Description|
 |Usage|Description|
 |---|---|
 | _[neuro help](#neuro-help)_| Get help on a command |
+| _[neuro run](#neuro-run)_| Run an image with predefined configuration |
 | _[neuro submit](#neuro-submit)_| Submit an image to run on the cluster |
 | _[neuro ps](#neuro-ps)_| List all jobs |
 | _[neuro status](#neuro-status)_| Display status of a job |
@@ -146,6 +149,7 @@ Name | Description|
 
 |Usage|Description|
 |---|---|
+| _[neuro job run](#neuro-job-run)_| Run an image with predefined configuration |
 | _[neuro job submit](#neuro-job-submit)_| Submit an image to run on the cluster |
 | _[neuro job ls](#neuro-job-ls)_| List all jobs |
 | _[neuro job status](#neuro-job-status)_| Display status of a job |
@@ -158,6 +162,48 @@ Name | Description|
 
 
 
+### neuro job run
+
+Run an image with predefined configuration.<br/><br/>IMAGE container image name.<br/><br/>CMD list will be passed as commands to model container.<br/>
+
+**Usage:**
+
+```bash
+neuro job run [OPTIONS] IMAGE [CMD]...
+```
+
+**Examples:**
+
+```bash
+
+# Starts a container pytorch:latest with two paths mounted.
+# Directory storage://<USERNAME> is mounted as /var/storage/home in read-write mode,
+# storage://neuromation is mounted as :/var/storage/neuromation as read-only.
+neuro run pytorch:latest --volume=HOME
+
+```
+
+**Options:**
+
+Name | Description|
+|----|------------|
+|_\-s, --preset PRESET_|Predefined job profile  \[default: gpu-small]|
+|_\-x, --extshm / -X, --no-extshm_|Request extended '/dev/shm' space  \[default: True]|
+|_--http INTEGER_|Enable HTTP port forwarding to container  \[default: 80]|
+|_\--http-auth / --no-http-auth_|Enable HTTP authentication for forwarded HTTP port  \[default: True]|
+|_\-p, --preemptible / -P, --non-preemptible_|Run job on a lower-cost preemptible instance  \[default: True]|
+|_\-n, --name NAME_|Optional job name|
+|_\-d, --description DESC_|Add optional description in free format|
+|_\-q, --quiet_|Run command in quiet mode \(print only job id)|
+|_\-v, --volume MOUNT_|Mounts directory from vault into container. Use multiple options to mount more than one volume. --volume=HOME is an alias for storage://~:/var/storage/home:rw and storage://neuromation:/var/storage/neuromation:ro|
+|_\-e, --env VAR=VAL_|Set environment variable in container Use multiple options to define more than one variable|
+|_\--env-file PATH_|File with environment variables to pass|
+|_\--wait-start / --no-wait-start_|Wait for a job start or failure  \[default: True]|
+|_--help_|Show this message and exit.|
+
+
+
+
 ### neuro job submit
 
 Submit an image to run on the cluster.<br/><br/>IMAGE container image name.<br/><br/>CMD list will be passed as commands to model container.<br/>
@@ -194,7 +240,7 @@ Name | Description|
 |_\-n, --name NAME_|Optional job name|
 |_\-d, --description DESC_|Optional job description in free format|
 |_\-q, --quiet_|Run command in quiet mode \(print only job id)|
-|_\-v, --volume MOUNT_|Mounts directory from vault into container. Use multiple options to mount more than one volume|
+|_\-v, --volume MOUNT_|Mounts directory from vault into container. Use multiple options to mount more than one volume. --volume=HOME is an alias for storage://~:/var/storage/home:rw and storage://neuromation:/var/storage/neuromation:ro|
 |_\-e, --env VAR=VAL_|Set environment variable in container Use multiple options to define more than one variable|
 |_\--env-file PATH_|File with environment variables to pass|
 |_\--wait-start / --no-wait-start_|Wait for a job start or failure  \[default: True]|
@@ -859,6 +905,48 @@ Name | Description|
 
 
 
+## neuro run
+
+Run an image with predefined configuration.<br/><br/>IMAGE container image name.<br/><br/>CMD list will be passed as commands to model container.<br/>
+
+**Usage:**
+
+```bash
+neuro run [OPTIONS] IMAGE [CMD]...
+```
+
+**Examples:**
+
+```bash
+
+# Starts a container pytorch:latest with two paths mounted.
+# Directory storage://<USERNAME> is mounted as /var/storage/home in read-write mode,
+# storage://neuromation is mounted as :/var/storage/neuromation as read-only.
+neuro run pytorch:latest --volume=HOME
+
+```
+
+**Options:**
+
+Name | Description|
+|----|------------|
+|_\-s, --preset PRESET_|Predefined job profile  \[default: gpu-small]|
+|_\-x, --extshm / -X, --no-extshm_|Request extended '/dev/shm' space  \[default: True]|
+|_--http INTEGER_|Enable HTTP port forwarding to container  \[default: 80]|
+|_\--http-auth / --no-http-auth_|Enable HTTP authentication for forwarded HTTP port  \[default: True]|
+|_\-p, --preemptible / -P, --non-preemptible_|Run job on a lower-cost preemptible instance  \[default: True]|
+|_\-n, --name NAME_|Optional job name|
+|_\-d, --description DESC_|Add optional description in free format|
+|_\-q, --quiet_|Run command in quiet mode \(print only job id)|
+|_\-v, --volume MOUNT_|Mounts directory from vault into container. Use multiple options to mount more than one volume. --volume=HOME is an alias for storage://~:/var/storage/home:rw and storage://neuromation:/var/storage/neuromation:ro|
+|_\-e, --env VAR=VAL_|Set environment variable in container Use multiple options to define more than one variable|
+|_\--env-file PATH_|File with environment variables to pass|
+|_\--wait-start / --no-wait-start_|Wait for a job start or failure  \[default: True]|
+|_--help_|Show this message and exit.|
+
+
+
+
 ## neuro submit
 
 Submit an image to run on the cluster.<br/><br/>IMAGE container image name.<br/><br/>CMD list will be passed as commands to model container.<br/>
@@ -895,7 +983,7 @@ Name | Description|
 |_\-n, --name NAME_|Optional job name|
 |_\-d, --description DESC_|Optional job description in free format|
 |_\-q, --quiet_|Run command in quiet mode \(print only job id)|
-|_\-v, --volume MOUNT_|Mounts directory from vault into container. Use multiple options to mount more than one volume|
+|_\-v, --volume MOUNT_|Mounts directory from vault into container. Use multiple options to mount more than one volume. --volume=HOME is an alias for storage://~:/var/storage/home:rw and storage://neuromation:/var/storage/neuromation:ro|
 |_\-e, --env VAR=VAL_|Set environment variable in container Use multiple options to define more than one variable|
 |_\--env-file PATH_|File with environment variables to pass|
 |_\--wait-start / --no-wait-start_|Wait for a job start or failure  \[default: True]|

neuromation/api/jobs.py

@@ -152,14 +152,6 @@ def from_cli(cls, username: str, volume: str) -> "Volume":
             read_only=read_only,
         )
 
-    @classmethod
-    def from_cli_list(
-        cls, username: str, lst: Sequence[str]
-    ) -> Optional[List["Volume"]]:
-        if not lst:
-            return None
-        return [cls.from_cli(username, s) for s in lst]
-
 
 @dataclass(frozen=True)
 class HTTPPort: