gcloud alpha batch jobs submit - submit a Batch job

gcloud alpha batch jobs submit[[JOB]--location=LOCATION](--config=PATH_TO_FILE--container-commands-file=CONTAINER_COMMANDS_FILE--container-entrypoint=CONTAINER_ENTRYPOINT--container-image-uri=CONTAINER_IMAGE_URI    |--script-file-path=SCRIPT_FILE_PATH    |--script-text=SCRIPT_TEXT)[--job-prefix=JOB_PREFIX][--machine-type=MACHINE_TYPE][--priority=PRIORITY][--provisioning-model=PROVISIONING_MODEL][--network=NETWORK--subnetwork=SUBNETWORK :--no-external-ip-address][GCLOUD_WIDE_FLAG …]

gcloudalphabatchjobssubmitprojects/foo/locations/us-central1/jobs/bar--config=config.json

To submit a job with a sample YAML configuration file (config.yaml) and nameprojects/foo/locations/us-central1/jobs/bar, run:

gcloudalphabatchjobssubmitprojects/foo/locations/us-central1/jobs/bar--config=config.yaml

To submit a job through stdin with a sample job configuration and nameprojects/foo/locations/us-central1/jobs/bar, run:

gcloudalphabatchjobssubmitprojects/foo/locations/us-central1/jobs/bar--config=-

theninputjsonjobconfigviastdin{jobconfig}

To submit a job through HereDoc with a sample job configuration and nameprojects/foo/locations/us-central1/jobs/bar, run:

gcloudalphabatchjobssubmitprojects/foo/locations/us-central1/jobs/bar--config=- <<EOF

{jobconfig}EOF

For details about how to define a job's configuration using JSON, see theprojects.locations.jobs resource in the Batch API Reference. If you want todefine a job's configuration using YAML, convert the JSON syntax to YAML.

Job resource - The Batch job resource. If --location not specified,the currentbatch/location is used. The arguments in this group can be used to specify theattributes of this resource. (NOTE) Some attributes are not given arguments inthis group but can be set in other ways.

To set theproject attribute:

• provide the argumentJOB on the command line with a fully specifiedname;
• job ID is optional and will be generated if not specified with a fully specifiedname;
• provide the argument--project on the command line;
• set the propertycore/project.

[JOB]

ID of the job or fully qualified identifier for the job.

To set thejob attribute:

• provide the argumentJOB on the command line;
• job ID is optional and will be generated if not specified.

--location=LOCATION

Google Cloud location for the job.

To set thelocation attribute:

• provide the argumentJOB on the command line with a fully specifiedname;
• job ID is optional and will be generated if not specified with a fully specifiedname;
• provide the argument--location on the command line;
• set the propertybatch/location.

At least one of these must be specified:

--config=PATH_TO_FILE

The file path of the job config file in either JSON or YAML format. It alsosupports direct input from stdin with '-' or HereDoc (in shells with HereDocsupport like Bash) with '- <<DELIMITER'.

Use a full or relative path to a local file containing the value of config.

Either specify the config file for the job or the first runnable in the taskspec. Specify either a script file or container arguments for the first runnablein the task spec.

At most one of these can be specified:

Options to specify the container arguments for the first runnable in the taskspec.

--container-commands-file=CONTAINER_COMMANDS_FILE

Overrides theCMD specified in the container. If there is anENTRYPOINT (either in the container image or with the entrypoint field below)then commands are appended as arguments to the ENTRYPOINT.

--container-entrypoint=CONTAINER_ENTRYPOINT

Overrides theENTRYPOINT specified in the container.

--container-image-uri=CONTAINER_IMAGE_URI

The URI to pull the container image from.

Either specify a path to a script file to run or provide inline text to executedirectly.

At most one of these can be specified:

--script-file-path=SCRIPT_FILE_PATH

Path to script file to run as first runnable in task spec. File path should be avalid path on the instance volume.

--script-text=SCRIPT_TEXT

Text to run as first runnable in task spec.

--job-prefix=JOB_PREFIX

Specify the job prefix. A job ID in the format of job prefix + %Y%m%d-%H%M%Swill be generated. Note that job prefix cannot be specified while JOB IDpositional argument is specified.

--machine-type=MACHINE_TYPE

Specify the Compute Engine machine type, for example, e2-standard-4. Currentlyonly one machine type is supported.

--priority=PRIORITY

Job priority [0-99] 0 is the lowest priority.

--provisioning-model=PROVISIONING_MODEL

Specify the allowed provisioning model for the compute instances.PROVISIONING_MODEL must be one of:

SPOT

The SPOT VM provisioning model. Ideal for fault-tolerant workloads that canwithstand preemption.

STANDARD

The STANDARD VM provisioning model

--network=NETWORK

The URL for the network resource. Must specify subnetwork as well if network isspecified

--subnetwork=SUBNETWORK

The URL for the subnetwork resource. Must specify network as well if subnetworkis specified

--no-external-ip-address

Required if no external public IP address is attached to the VM. If no externalpublic IP address, additional configuration is required to allow the VM toaccess Google Services.

Run$gcloud help for details.