Submit a Run:ai Job for execution.
runai submit [--attach] [--backoff-limit int] [--completions int] [--cpu double] [--cpu-limit double] [--create-home-dir] [--environment stringArray | -e stringArray] [--git-sync string] [--gpu double | -g double] [--gpu-memory string] [--host-ipc] [--host-network] [--image string | -i string] [--imagePullPolicy string] [--interactive] [--jupyter] [--job-name-prefix string] [--large-shm] [--local-image] [--memory string] [--memory-limit string] [--mount-propagation] [--mps] [--name string] [--node-pool string] [--node-type string] [--parallelism int] [--port stringArray] [--preemptible] [--prevent-privilege-escalation] [--pvc [StorageClassName]:Size:ContainerMountPath:[ro]] [--run-as-user] [--s3 string] [--service-type string | -s string] [--stdin] [--toleration string] [--tty | -t] [--volume stringArray | -v stringArray] [--nfs-server string] [--working-dir] [--loglevel string] [--project string | -p string] [--help | -h] -- [COMMAND] [ARGS...] [options]
- Flags of type stringArray mean that you can add multiple values. You can either separate values with a comma or add the flag twice.
All examples assume a Run:ai Project has been set using
runai config project <project-name>.
Start an interactive Job:
(see: build Quickstart).
runai submit --name build-remote -i rastasheep/ubuntu-sshd:14.04 --interactive \ --service-type=nodeport --port 30022:22 -- /usr/sbin/sshd -D
(see: build with ports Quickstart).
Start a Training Job
runai submit --name train1 -i gcr.io/run-ai-demo/quickstart -g 1
(see: training Quickstart).
Use GPU Fractions
runai submit --name frac05 -i gcr.io/run-ai-demo/quickstart -g 0.5
(see: GPU fractions Quickstart).
runai submit --name hpo1 -i gcr.io/run-ai-demo/quickstart-hpo -g 1 \ --parallelism 3 --completions 12 -v /nfs/john/hpo:/hpo
Submit a Job without a name (automatically generates a name)
runai submit -i gcr.io/run-ai-demo/quickstart -g 1
Submit a Job without a name with a pre-defined prefix and an incremental index suffix
runai submit --job-name-prefix -i gcr.io/run-ai-demo/quickstart -g 1
Aliases and Shortcuts¶
The name of the Job.
Mark this Job as Interactive. Interactive Jobs are not terminated automatically by the system.
Shortcut for running a Jupyter notebook container. Uses a pre-created image and a default notebook configuration.
runai submit --name jup1 --jupyter -g 0.5 --service-type=nodeportwill start an interactive session named jup1 and use an nodeport load balancer to connect to it. The output of the command is an access token for the notebook. Run
runai list jobsto find the URL for the notebook.
The prefix to use to automatically generate a Job name with an incremental index. When a Job name is omitted Run:ai will generate a Job name. The optional
--job-name-prefix flagcreates Job names with the provided prefix
Default is false. If set to true, wait for the Pod to start running. When the pod starts running, attach to the Pod. The flag is equivalent to the command runai attach.
The --attach flag also sets
Overrides the image's entry point with the command supplied after '--'. When not using the
--commandflag, the entry point will not be overrided and the string after
--will be appended as arguments to the entry point command.
--command -- run.sh 1 54will start the docker and run
run.sh 1 54
-- script.py 10000will augment
script.py 10000to the entry point command (e.g.
-e stringArray | --environment stringArray¶
Define environment variables to be set in the container. To set multiple values add the flag multiple times (
-e BATCH_SIZE=50 -e LEARNING_RATE=0.2).
--image string | -i string¶
Image to use when creating the container for this Job
Pulling policy of the image When starting a container. Options are:
Always(default): force image pulling to check whether local image already exists. If the image already exists locally and has the same digest, then the image will not be downloaded.
IfNotPresent: the image is pulled only if it is not already present locally.
Never: the image is assumed to exist locally. No attempt is made to pull the image.
For more information see Kubernetes documentation.
Deprecated. Please use
image-pull-policy=neverinstead. Use a local image for this Job. A local image is an image that exists on all local servers of the Kubernetes Cluster.
Use NVIDIA MPS. NIVDIA MPS is useful with Inference workloads for optimizing multiple processes running on a single GPU. The
--mpsflag only works in conjunction with GPU fractions (--gpu
<num>is not an integer or using --gpu-memory).
Keep stdin open for the container(s) in the pod, even if nothing is attached.
Allocate a pseudo-TTY.
Starts the container with the specified directory as the current directory.
CPU units to allocate for the Job (0.5, 1, .etc). The Job will receive at least this amount of CPU. Note that the Job will not be scheduled unless the system can guarantee this amount of CPUs to the Job.
Limitations on the number of CPUs consumed by the Job (0.5, 1, .etc). The system guarantees that this Job will not be able to consume more than this amount of CPUs.
--gpu double | -g double¶
Number of GPUs to allocate for the Job. The default is no allocated GPUs. The GPU value can be an integer or a fraction between 0 and 1.
GPU memory to allocate for this Job (1G, 20M, .etc). The Job will receive this amount of memory. Note that the Job will not be scheduled unless the system can guarantee this amount of GPU memory to the Job.
Mount a large /dev/shm device. An shm is a shared file system mounted on RAM.
CPU memory to allocate for this Job (1G, 20M, .etc). The Job will receive at least this amount of memory. Note that the Job will not be scheduled unless the system can guarantee this amount of memory to the Job.
CPU memory to allocate for this Job (1G, 20M, .etc). The system guarantees that this Job will not be able to consume more than this amount of memory. The Job will receive an error when trying to allocate more memory than this limit.
Mount a persistent volume claim of Network Attached Storage into a container.
The 2 syntax types of this command are mutually exclusive. You can either use the first or second form, but not a mixture of both.
Storage_Class_Name is a storage class name that can be obtained by running
kubectl get storageclasses.storage.k8s.io. This parameter may be omitted if there is a single storage class in the system, or you are using the default storage class.
Size is the volume size you want to allocate. See Kubernetes documentation for how to specify volume sizes
Container_Mount_Path. A path internal to the container where the storage will be mounted
Pvc_Name. The name of a pre-existing Persistent Volume Claim to mount into the container
--pvc :3Gi:/tmp/john:ro- Allocate
3GBfrom the default Storage class. Mount it to
--pvc my-storage:3Gi:/tmp/john:ro- Allocate
my-storagestorage class. Mount it to /tmp/john as read-only
--pvc :3Gi:/tmp/john- Allocate
3GBfrom the default storage class. Mount it to
--pvc my-pvc:/tmp/john- Use a Persistent Volume Claim named
my-pvc. Mount it to
--pvc my-pvc-2:/tmp/john:ro- Use a Persistent Volume Claim named
my-pvc-2. Mount it to
Volumes to mount into the container.
-v /raid/public/john/data:/root/data:roMount /root/data to local path /raid/public/john/data for read-only access.
-v /public/data:/root/data::nfs.example.comMount /root/data to NFS path /public/data on NFS server nfs.example.com for read-write access.
Use this flag to specify the default NFS host for --volume flag. Alternatively, you can specify NFS host for each volume individually (see --volume for details).
The flag allows for sharing volumes mounted by a container to other containers in the same pod, or even to other pods on the same node. When the flag is set, Run:ai will set mount propagation to the value of
HostToContaineras documented here. With
HostToContainerthe volume mount will receive all subsequent mounts that are mounted to this volume or any of its subdirectories.
Clone a git repository into the container running the job. The parameter should follow the syntax:
Note that source=REPOSITORY is the only mandatory field
Mount an S3 compatible storage into the container running the job. The parameter should follow the syntax:
All the fields, except url=URL, are mandatory. Default for url is
Use the host's ipc namespace. Controls whether the pod containers can share the host IPC namespace. IPC (POSIX/SysV IPC) namespace provides separation of named shared memory segments, semaphores and message queues. Shared memory segments are used to accelerate inter-process communication at memory speed, rather than through pipes or the network stack.
For further information see docker run reference.
Use the host's network stack inside the container. For further information see docker run reference.
Expose ports from the Job container. Used together with
--port 8080:80 --service-type portforward
--service-type string | -s string¶
Service exposure method for interactive Job. Options are:
nodeport. Use the command runai list to obtain the endpoint to use the service when the Job is running. Different service methods have different endpoint structures.
Comma separated list of IP addresses to listen to when running interactive job with portforward service type (default is localhost).
--interactive --service-type portforward --address "localhost,192.168.1.2" --port 8888:5555
Any traffic on port 8888 of both localhost and 192.168.1.2 will be forwarded to port 5555 of the running job.
The number of times the Job will be retried before failing. The default is 6. This flag will only work with training workloads (when the
--interactiveflag is not specified).
The number of successful pods required for this Job to be completed. Used for Hyperparameter optimization. Use together with
The number of pods this Job tries to run in parallel at any time. Used for Hyperparameter optimization. Use together with
Create a temporary home directory for the user in the container. Data saved in this directory will not be saved when the container exits. For more information see non root containers.
Prevent the Job’s container and all launched processes from gaining additional privileges after the Job starts. Default is
false. For more information see non root containers.
Run in the context of the current user running the Run:ai command rather than the root user. While the default container user is root (same as in Docker), this command allows you to submit a Job running under your Linux user. This would manifest itself in access to operating system resources, in the owner of new folders created under shared directories, etc. Alternatively, if your cluster is connected to Run:ai via SAML , you can map the container to use the Linux UID/GID which is stored in the organization's directory. For more information see non root containers.
Allows defining specific nodes (machines) or a group of nodes on which the workload will run. To use this feature your Administrator will need to label nodes as explained here: Limit a Workload to a Specific Node Group. This flag can be used in conjunction with Project-based affinity. In this case, the flag is used to refine the list of allowable node groups set in the Project. For more information see: Working with Projects.
Instructs the scheduler to run this workload using a specific set of nodes which are part of a Node Pool. To use this feature, your Administrator will need to label nodes as explained here: Limit a Workload to a Specific Node Group or use existing node labels, then create a node-pool and assign the label to the node-pool.
This flag can be used in conjunction with node-type and Project-based affinity. In this case, the flag is used to refine the list of allowable node groups set from a node-pool. For more information see: Working with Projects.
Mark an interactive Job as preemptible. Preemptible Jobs can be scheduled above the guaranteed quota but may be reclaimed at any time.
Specify one or more toleration criteria, to ensure that the workload is not scheduled onto an inappropriate node. This is done by matching the workload tolerations to the taints defined for each node. For further details see Kubernetes Taints and Tolerations Guide.
The format of the string:
Set the logging level. One of: debug | info | warn | error (default "info").
--project | -p (string)¶
Specify the Project to which the command applies. Run:ai Projects are used by the scheduler to calculate resource eligibility. By default, commands apply to the default Project. To change the default Project use
runai config project <project-name>.
--help | -h¶
Show help text.
The command will attempt to submit a Job. You can follow up on the Job by running
runai list jobs or
runai describe job <job-name>.
Note that the submit call may use a policy to provide defaults to any of the above flags.
- See any of the Quickstart documents here:.
- See policy configuration for a description on how policies work.