mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-17 22:36:52 +00:00
1734 lines
67 KiB
Text
1734 lines
67 KiB
Text
NAME
|
|
gcloud alpha cluster-director clusters update - updates a Cluster Director
|
|
resource
|
|
|
|
SYNOPSIS
|
|
gcloud alpha cluster-director clusters update
|
|
(CLUSTER : --location=LOCATION)
|
|
(--add-filestore-instances=[id=ID],[name=NAME]
|
|
--add-flex-start-instances=[atmTags=ATMTAGS],[id=ID],
|
|
[machineType=MACHINETYPE],[maxDuration=MAXDURATION],[zone=ZONE]
|
|
--add-labels=[ADD_LABELS,...]
|
|
--add-lustre-instances=[id=ID],[name=NAME]
|
|
--add-new-filestore-instances=[capacityGb=CAPACITYGB],
|
|
[description=DESCRIPTION],[fileshare=FILESHARE],
|
|
[id=ID],[name=NAME],[protocol=PROTOCOL],[tier=TIER]
|
|
--add-new-lustre-instances=[capacityGb=CAPACITYGB],
|
|
[description=DESCRIPTION],[filesystem=FILESYSTEM],[id=ID],
|
|
[name=NAME],[perUnitStorageThroughput=PERUNITSTORAGETHROUGHPUT]
|
|
--add-new-storage-buckets=[enableAutoclass=ENABLEAUTOCLASS],
|
|
[enableHNS=ENABLEHNS],[id=ID],[name=NAME],[storageClass=STORAGECLASS],
|
|
[terminalStorageClass=TERMINALSTORAGECLASS]
|
|
--add-on-demand-instances=[atmTags=ATMTAGS],
|
|
[id=ID],[machineType=MACHINETYPE],[zone=ZONE]
|
|
--add-reserved-instances=[atmTags=ATMTAGS],[id=ID],
|
|
[reservation=RESERVATION],[reservationBlock=RESERVATIONBLOCK],
|
|
[reservationSubBlock=RESERVATIONSUBBLOCK]
|
|
--add-slurm-epilog-scripts=[ADD_SLURM_EPILOG_SCRIPTS,...]
|
|
--add-slurm-node-sets=[bootDisk=BOOTDISK],[computeId=COMPUTEID],
|
|
[container-resource-labels=CONTAINER-RESOURCE-LABELS],
|
|
[container-startup-script=CONTAINER-STARTUP-SCRIPT],[id=ID],
|
|
[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],
|
|
[startupScript=STARTUPSCRIPT],
|
|
[startupScriptTimeout=STARTUPSCRIPTTIMEOUT],
|
|
[staticNodeCount=STATICNODECOUNT],
|
|
[storageConfigs=STORAGECONFIGS],[type=TYPE]
|
|
--add-slurm-partitions=[exclusive=EXCLUSIVE],
|
|
[id=ID],[nodeSetIds=NODESETIDS]
|
|
--add-slurm-prolog-scripts=[ADD_SLURM_PROLOG_SCRIPTS,...]
|
|
--add-slurm-task-epilog-scripts=[ADD_SLURM_TASK_EPILOG_SCRIPTS,...]
|
|
--add-slurm-task-prolog-scripts=[ADD_SLURM_TASK_PROLOG_SCRIPTS,...]
|
|
--add-spot-instances=[atmTags=ATMTAGS],[id=ID],
|
|
[machineType=MACHINETYPE],
|
|
[terminationAction=TERMINATIONACTION],[zone=ZONE]
|
|
--add-storage-buckets=[id=ID],[name=NAME] --description=DESCRIPTION
|
|
--remove-filestore-instances=[REMOVE_FILESTORE_INSTANCES,...]
|
|
--remove-flex-start-instances=[REMOVE_FLEX_START_INSTANCES,...]
|
|
--remove-labels=[REMOVE_LABELS,...]
|
|
--remove-lustre-instances=[REMOVE_LUSTRE_INSTANCES,...]
|
|
--remove-on-demand-instances=[REMOVE_ON_DEMAND_INSTANCES,...]
|
|
--remove-reserved-instances=[REMOVE_RESERVED_INSTANCES,...]
|
|
--remove-slurm-epilog-scripts=[REMOVE_SLURM_EPILOG_SCRIPTS,...]
|
|
--remove-slurm-node-sets=[REMOVE_SLURM_NODE_SETS,...]
|
|
--remove-slurm-partitions=[REMOVE_SLURM_PARTITIONS,...]
|
|
--remove-slurm-prolog-scripts=[REMOVE_SLURM_PROLOG_SCRIPTS,...]
|
|
--remove-slurm-task-epilog-scripts=[REMOVE_SLURM_TASK_EPILOG_SCRIPTS,
|
|
...]
|
|
--remove-slurm-task-prolog-scripts=[REMOVE_SLURM_TASK_PROLOG_SCRIPTS,
|
|
...] --remove-spot-instances=[REMOVE_SPOT_INSTANCES,...]
|
|
--remove-storage-buckets=[REMOVE_STORAGE_BUCKETS,...]
|
|
--slurm-default-partition=SLURM_DEFAULT_PARTITION
|
|
--update-slurm-config=[accountingStorageEnforceFlags=ACCOUNTINGSTORAGEENFORCEFLAGS],
|
|
[healthCheckInterval=HEALTHCHECKINTERVAL],
|
|
[healthCheckNodeState=HEALTHCHECKNODESTATE],
|
|
[healthCheckProgram=HEALTHCHECKPROGRAM],
|
|
[preemptExemptTime=PREEMPTEXEMPTTIME],[preemptMode=PREEMPTMODE],
|
|
[preemptType=PREEMPTTYPE],[priorityType=PRIORITYTYPE],
|
|
[priorityWeightAge=PRIORITYWEIGHTAGE],
|
|
[priorityWeightAssoc=PRIORITYWEIGHTASSOC],
|
|
[priorityWeightFairshare=PRIORITYWEIGHTFAIRSHARE],
|
|
[priorityWeightJobSize=PRIORITYWEIGHTJOBSIZE],
|
|
[priorityWeightPartition=PRIORITYWEIGHTPARTITION],
|
|
[priorityWeightQos=PRIORITYWEIGHTQOS],
|
|
[priorityWeightTres=PRIORITYWEIGHTTRES],
|
|
[prologEpilogTimeout=PROLOGEPILOGTIMEOUT],[prologFlags=PROLOGFLAGS],
|
|
[requeueExitCodes=REQUEUEEXITCODES],
|
|
[requeueHoldExitCodes=REQUEUEHOLDEXITCODES]
|
|
--update-slurm-disable-health-check-program
|
|
--update-slurm-login-node=[bootDisk=BOOTDISK],
|
|
[count=COUNT],[startupScript=STARTUPSCRIPT]
|
|
--update-slurm-node-sets=[bootDisk=BOOTDISK],[computeId=COMPUTEID],
|
|
[container-resource-labels=CONTAINER-RESOURCE-LABELS],
|
|
[container-startup-script=CONTAINER-STARTUP-SCRIPT],[id=ID],
|
|
[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],
|
|
[startupScript=STARTUPSCRIPT],
|
|
[startupScriptTimeout=STARTUPSCRIPTTIMEOUT],
|
|
[staticNodeCount=STATICNODECOUNT],
|
|
[storageConfigs=STORAGECONFIGS],[type=TYPE]
|
|
--update-slurm-partitions=[exclusive=EXCLUSIVE],
|
|
[id=ID],[nodeSetIds=NODESETIDS]
|
|
| --config=[computeResources=COMPUTERESOURCES],
|
|
[description=DESCRIPTION],[labels=LABELS],[name=NAME],
|
|
[networkResources=NETWORKRESOURCES],
|
|
[orchestrator=ORCHESTRATOR],[storageResources=STORAGERESOURCES]
|
|
--update-mask=UPDATE_MASK) [--async] [GCLOUD_WIDE_FLAG ...]
|
|
|
|
DESCRIPTION
|
|
(ALPHA) gcloud alpha cluster-director clusters update facilitates the
|
|
updation of a cluster resource.
|
|
|
|
There are following ways to update a cluster:
|
|
▪ [Preferred] Use granular flags to update cluster specs, based on
|
|
read-modify-update pattern.
|
|
◆ Read the existing cluster specs through get cluster request.
|
|
◆ Modify the cluster specs through granular flags.
|
|
◆ Update the cluster specs through patch cluster request.
|
|
▪ Use --config with cluster specs and --update-mask flags, both in JSON
|
|
format.
|
|
◆ Map and repeated fields update requires existing and new values.
|
|
◆ For e.g. if we want to update a cluster to add a new nodeset, then
|
|
we will use the update_mask "orchestrator.slurm.node_sets", and the
|
|
patch cluster must include all the existing nodesets as well as the
|
|
new one.
|
|
|
|
Please refer to the examples below for more details.
|
|
|
|
EXAMPLES
|
|
To update a cluster my-cluster in location us-central1-a with granular
|
|
flags, run the following example:
|
|
|
|
Add labels, compute instances, slurm node sets, slurm partitions and update
|
|
description and default partition:
|
|
|
|
$ gcloud alpha cluster-director clusters update my-cluster \
|
|
--location us-central1-a \
|
|
--description "My updated cluster description" \
|
|
--add-labels env=prod,client=gcloud-cli \
|
|
--add-on-demand-instances \
|
|
id=compute1,zone=us-central1-a,machineType=n2-standard-2 \
|
|
--add-reserved-instances \
|
|
id=compute2,reservation=zones/us-central1-a/reservations/\
|
|
{reservation} \
|
|
--add-spot-instances \
|
|
id=compute3,zone=us-central1-a,machineType=n2-standard-2 \
|
|
--add-dws-flex-instances \
|
|
id=compute4,zone=us-central1-a,machineType=a4-highgpu-8g,\
|
|
maxDuration=10000s \
|
|
--add-new-lustre-instances \
|
|
lustre=locations/us-central1-a/instances/lustre1,\
|
|
capacityGb=1024,filesystem=lustre1 \
|
|
--add-lustre-instances \
|
|
locations/us-central1-a/instances/lustre0 \
|
|
--add-slurm-node-sets id=nodeset1,computeId=compute1 \
|
|
--add-slurm-node-sets id=nodeset2,computeId=compute2 \
|
|
--add-slurm-node-sets id=nodeset3,computeId=compute3 \
|
|
--add-slurm-node-sets id=nodeset4,computeId=compute4 \
|
|
--add-slurm-partitions id=partition1,nodesetIds=[nodeset1] \
|
|
--add-slurm-partitions \
|
|
id=partition2,nodesetIds=[nodeset2,nodeset3,nodeset4] \
|
|
--slurm-default-partition partition1
|
|
|
|
Update slurm node sets and slurm partitions:
|
|
|
|
$ gcloud alpha cluster-director clusters update my-cluster \
|
|
--location us-central1-a \
|
|
--update-slurm-node-sets \
|
|
id=nodeset1,staticNodeCount=2,maxDynamicNodeCount=10 \
|
|
--update-slurm-partitions \
|
|
id=partition1,nodesetIds=[nodeset0],exclusive=true
|
|
|
|
Remove slurm node sets, slurm partitions and compute instances and update
|
|
default partition:
|
|
|
|
$ gcloud alpha cluster-director clusters update my-cluster \
|
|
--location us-central1-a --slurm-default-partition partition0 \
|
|
--remove-labels env,client \
|
|
--remove-lustre-instances \
|
|
locations/us-central1-a/instances/lustre0 \
|
|
--remove-slurm-partitions partition1 \
|
|
--remove-slurm-partitions partition2 \
|
|
--remove-slurm-node-sets nodeset1 \
|
|
--remove-slurm-node-sets nodeset2 \
|
|
--remove-slurm-node-sets nodeset3 \
|
|
--remove-slurm-node-sets nodeset4 \
|
|
--remove-on-demand-instances compute1 \
|
|
--remove-reserved-instances compute2 \
|
|
--remove-spot-instances compute3 \
|
|
--remove-dws-flex-instances compute4
|
|
|
|
Add and remove slurm prolog/epilog scripts:
|
|
|
|
$ gcloud alpha cluster-director clusters update my-cluster \
|
|
--location us-central1-a --add-slurm-prolog-scripts script1.sh \
|
|
--remove-slurm-epilog-scripts script2.sh
|
|
|
|
Or cluster my-cluster in location us-central1-a with config JSON run the
|
|
following JSON example:
|
|
|
|
$ gcloud alpha cluster-director clusters update my-cluster \
|
|
--location=us-central1-a --update-mask=labels \
|
|
--config='{"key": "value"}'
|
|
|
|
Or create a JSON file my-cluster-config.json with the cluster specs and run
|
|
the following file example:
|
|
|
|
$ gcloud alpha cluster-director clusters update my-cluster \
|
|
--location=us-central1-a --update-mask=labels \
|
|
--config-from-file=my-cluster-config.json
|
|
|
|
Or create a JSON file with the update mask and run the following file
|
|
example:
|
|
|
|
$ gcloud alpha cluster-director clusters update my-cluster \
|
|
--location=us-central1-a \
|
|
--update-mask-from-file=my-update-mask.json \
|
|
--config-from-file=my-cluster-config.json
|
|
|
|
POSITIONAL ARGUMENTS
|
|
Cluster resource - Name of the cluster resource. Formats: cluster |
|
|
projects/{project}/locations/{locations}/clusters/{cluster} The arguments
|
|
in this group can be used to specify the attributes of this resource.
|
|
(NOTE) Some attributes are not given arguments in this group but can be
|
|
set in other ways.
|
|
|
|
To set the project attribute:
|
|
◆ provide the argument cluster on the command line with a fully
|
|
specified name;
|
|
◆ provide the argument --project on the command line;
|
|
◆ set the property core/project.
|
|
|
|
This must be specified.
|
|
|
|
CLUSTER
|
|
ID of the cluster or fully qualified identifier for the cluster.
|
|
|
|
To set the cluster attribute:
|
|
▸ provide the argument cluster on the command line.
|
|
|
|
This positional argument must be specified if any of the other
|
|
arguments in this group are specified.
|
|
|
|
--location=LOCATION
|
|
The location id of the cluster resource.
|
|
|
|
To set the location attribute:
|
|
▸ provide the argument cluster on the command line with a fully
|
|
specified name;
|
|
▸ provide the argument --location on the command line.
|
|
|
|
REQUIRED FLAGS
|
|
Cluster configuration for provisioning with updates.
|
|
|
|
Exactly one of these must be specified:
|
|
|
|
Flag Configurations to define cluster updates.
|
|
|
|
--add-filestore-instances=[id=ID],[name=NAME]
|
|
Reference of existing filestore instance.
|
|
|
|
id: ID of the filestore resource, used to refer to this resource in
|
|
storage-configs. name: Name of the existing filestore instance to
|
|
import from your project in the format of
|
|
locations/us-central1/instances/filestore-1.
|
|
|
|
For e.g. --add-filestore-instances
|
|
id=my-fs,name=locations/us-central1/instances/filestore-1.
|
|
|
|
Sets add_filestore_instances value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
name
|
|
Required, sets name value.
|
|
|
|
Shorthand Example:
|
|
|
|
--add-filestore-instances=id=string,name=string --add-filestore-instances=id=string,name=string
|
|
|
|
JSON Example:
|
|
|
|
--add-filestore-instances='[{"id": "string", "name": "string"}]'
|
|
|
|
File Example:
|
|
|
|
--add-filestore-instances=path_to_file.(yaml|json)
|
|
|
|
--add-flex-start-instances=[atmTags=ATMTAGS],[id=ID],[machineType=MACHINETYPE],[maxDuration=MAXDURATION],[zone=ZONE]
|
|
Parameters to define cluster Flex Start instances.
|
|
|
|
For e.g. --add-flex-start-instances
|
|
id=c1,zone=us-central1-a,machineType=n1-standard-1,maxDuration=10000s,atmTags="tag1=val1".
|
|
|
|
Sets add_flex_start_instances value.
|
|
|
|
atmTags
|
|
Sets atmTags value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
machineType
|
|
Required, sets machineType value.
|
|
|
|
maxDuration
|
|
Required, sets maxDuration value.
|
|
|
|
zone
|
|
Required, sets zone value.
|
|
|
|
Shorthand Example:
|
|
|
|
--add-flex-start-instances=atmTags={string=string},id=string,machineType=string,maxDuration=string,zone=string --add-flex-start-instances=atmTags={string=string},id=string,machineType=string,maxDuration=string,zone=string
|
|
|
|
JSON Example:
|
|
|
|
--add-flex-start-instances='[{"atmTags": {"string": "string"}, "id": "string", "machineType": "string", "maxDuration": "string", "zone": "string"}]'
|
|
|
|
File Example:
|
|
|
|
--add-flex-start-instances=path_to_file.(yaml|json)
|
|
|
|
--add-labels=[ADD_LABELS,...]
|
|
Cluster labels as key value pairs.
|
|
|
|
For e.g. --add-labels key1=value1,key2=value2.
|
|
|
|
Sets add_labels value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
Shorthand Example:
|
|
|
|
--add-labels={string=string}
|
|
|
|
JSON Example:
|
|
|
|
--add-labels='{"string": "string"}'
|
|
|
|
File Example:
|
|
|
|
--add-labels=path_to_file.(yaml|json)
|
|
|
|
--add-lustre-instances=[id=ID],[name=NAME]
|
|
Reference of existing Lustre instance.
|
|
|
|
id: ID of the lustre resource, used to refer to this resource in
|
|
storage-configs. name: Name of the existing Managed Lustre instance
|
|
to import from your project in the format of
|
|
locations/us-central1/instances/lustre-1.
|
|
|
|
For e.g. --add-lustre-instances
|
|
id=my-lustre,name=locations/us-central1/instances/lustre-1.
|
|
|
|
Sets add_lustre_instances value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
name
|
|
Required, sets name value.
|
|
|
|
Shorthand Example:
|
|
|
|
--add-lustre-instances=id=string,name=string --add-lustre-instances=id=string,name=string
|
|
|
|
JSON Example:
|
|
|
|
--add-lustre-instances='[{"id": "string", "name": "string"}]'
|
|
|
|
File Example:
|
|
|
|
--add-lustre-instances=path_to_file.(yaml|json)
|
|
|
|
--add-new-filestore-instances=[capacityGb=CAPACITYGB],[description=DESCRIPTION],[fileshare=FILESHARE],[id=ID],[name=NAME],[protocol=PROTOCOL],[tier=TIER]
|
|
Parameters to create a filestore instance.
|
|
|
|
For e.g. --create-filestores
|
|
id=my-fs,name=locations/us-central1/instances/filestore-1,tier=REGIONAL,capacityGb=1024,fileshare=share1
|
|
|
|
id: ID of the filestore resource, used to refer to this resource in
|
|
storage-configs. name: Name of the filestore instance to create in
|
|
your project in the format of
|
|
locations/us-central1/instances/filestore-1.
|
|
|
|
capacityGb: Size of the filestore in GB. Must be between 1024 and
|
|
102400, and must meet scalability requirements described at
|
|
https://cloud.google.com/filestore/docs/service-tiers.
|
|
|
|
fileshare: The directory on a Filestore instance where all shared
|
|
files are stored. Must match the regex [a-z]([-a-z0-9]*[a-z0-9])?, be
|
|
1-63 characters in length, and comply with RFC1035. Supported tier
|
|
values:
|
|
▸ ZONAL
|
|
▸ REGIONAL
|
|
|
|
Supported protocol values:
|
|
▸ NFSV3
|
|
▸ NFSV41
|
|
▸ If not specified, defaults to NFSV3
|
|
|
|
Defaults:
|
|
▸ protocol: NFSV3.
|
|
|
|
Sets add_new_filestore_instances value.
|
|
|
|
capacityGb
|
|
Required, sets capacityGb value.
|
|
|
|
description
|
|
Sets description value.
|
|
|
|
fileshare
|
|
Required, sets fileshare value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
name
|
|
Required, sets name value.
|
|
|
|
protocol
|
|
Sets protocol value.
|
|
|
|
tier
|
|
Required, sets tier value.
|
|
|
|
Shorthand Example:
|
|
|
|
--add-new-filestore-instances=capacityGb=int,description=string,fileshare=string,id=string,name=string,protocol=string,tier=string --add-new-filestore-instances=capacityGb=int,description=string,fileshare=string,id=string,name=string,protocol=string,tier=string
|
|
|
|
JSON Example:
|
|
|
|
--add-new-filestore-instances='[{"capacityGb": int, "description": "string", "fileshare": "string", "id": "string", "name": "string", "protocol": "string", "tier": "string"}]'
|
|
|
|
File Example:
|
|
|
|
--add-new-filestore-instances=path_to_file.(yaml|json)
|
|
|
|
--add-new-lustre-instances=[capacityGb=CAPACITYGB],[description=DESCRIPTION],[filesystem=FILESYSTEM],[id=ID],[name=NAME],[perUnitStorageThroughput=PERUNITSTORAGETHROUGHPUT]
|
|
Parameters to create a Lustre instance.
|
|
|
|
id: ID of the lustre resource, used to refer to this resource in
|
|
storage-configs. name: Name of the Managed Lustre instance to create
|
|
in your project in the format of
|
|
locations/us-central1/instances/lustre-1.
|
|
|
|
For e.g. --add-new-lustre-instances
|
|
id=my-lustre,name=locations/us-central1/instances/lustre-1,capacityGb=1024,filesystem=fs-1,perUnitStorageThroughput=1000
|
|
|
|
Values for perUnitStorageThroughput: 125, 250, 500, 1000.
|
|
|
|
Sets add_new_lustre_instances value.
|
|
|
|
capacityGb
|
|
Required, sets capacityGb value.
|
|
|
|
description
|
|
Sets description value.
|
|
|
|
filesystem
|
|
Required, sets filesystem value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
name
|
|
Required, sets name value.
|
|
|
|
perUnitStorageThroughput
|
|
Sets perUnitStorageThroughput value.
|
|
|
|
Shorthand Example:
|
|
|
|
--add-new-lustre-instances=capacityGb=int,description=string,filesystem=string,id=string,name=string,perUnitStorageThroughput=int --add-new-lustre-instances=capacityGb=int,description=string,filesystem=string,id=string,name=string,perUnitStorageThroughput=int
|
|
|
|
JSON Example:
|
|
|
|
--add-new-lustre-instances='[{"capacityGb": int, "description": "string", "filesystem": "string", "id": "string", "name": "string", "perUnitStorageThroughput": int}]'
|
|
|
|
File Example:
|
|
|
|
--add-new-lustre-instances=path_to_file.(yaml|json)
|
|
|
|
--add-new-storage-buckets=[enableAutoclass=ENABLEAUTOCLASS],[enableHNS=ENABLEHNS],[id=ID],[name=NAME],[storageClass=STORAGECLASS],[terminalStorageClass=TERMINALSTORAGECLASS]
|
|
Parameters to create a Google Cloud Storage bucket.
|
|
|
|
id: ID of the bucket resource, used to refer to this resource in
|
|
storage-configs. name: Name of the Cloud Storage bucket to create in
|
|
your project in the format of bucket-1.
|
|
|
|
For e.g. --add-new-storage-buckets
|
|
id=my-bucket,name=bucket-1,storageClass=STANDARD,terminalStorageClass=TERMINAL_STORAGE_CLASS_NEARLINE,enableHNS=true
|
|
|
|
Supported storageClass values:
|
|
▸ STANDARD
|
|
▸ NEARLINE
|
|
▸ COLDLINE
|
|
▸ ARCHIVE
|
|
|
|
Supported terminalStorageClass values:
|
|
▸ TERMINAL_STORAGE_CLASS_NEARLINE
|
|
▸ TERMINAL_STORAGE_CLASS_ARCHIVE
|
|
|
|
Defaults:
|
|
▸ storageClass: STANDARD
|
|
|
|
Note:
|
|
▸ Either storageClass or enableAutoclass can be set.
|
|
▸ HNS: Hierarchical namespace.
|
|
|
|
Sets add_new_storage_buckets value.
|
|
|
|
enableAutoclass
|
|
Sets enableAutoclass value.
|
|
|
|
enableHNS
|
|
Sets enableHNS value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
name
|
|
Required, sets name value.
|
|
|
|
storageClass
|
|
Sets storageClass value.
|
|
|
|
terminalStorageClass
|
|
Sets terminalStorageClass value.
|
|
|
|
Shorthand Example:
|
|
|
|
--add-new-storage-buckets=enableAutoclass=boolean,enableHNS=boolean,id=string,name=string,storageClass=string,terminalStorageClass=string --add-new-storage-buckets=enableAutoclass=boolean,enableHNS=boolean,id=string,name=string,storageClass=string,terminalStorageClass=string
|
|
|
|
JSON Example:
|
|
|
|
--add-new-storage-buckets='[{"enableAutoclass": boolean, "enableHNS": boolean, "id": "string", "name": "string", "storageClass": "string", "terminalStorageClass": "string"}]'
|
|
|
|
File Example:
|
|
|
|
--add-new-storage-buckets=path_to_file.(yaml|json)
|
|
|
|
--add-on-demand-instances=[atmTags=ATMTAGS],[id=ID],[machineType=MACHINETYPE],[zone=ZONE]
|
|
Parameters to define cluster on demand instances.
|
|
|
|
For e.g. --add-on-demand-instances
|
|
id=c1,zone=us-central1-a,machineType=n1-standard-1,atmTags="tag1=val1".
|
|
|
|
Sets add_on_demand_instances value.
|
|
|
|
atmTags
|
|
Sets atmTags value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
machineType
|
|
Required, sets machineType value.
|
|
|
|
zone
|
|
Required, sets zone value.
|
|
|
|
Shorthand Example:
|
|
|
|
--add-on-demand-instances=atmTags={string=string},id=string,machineType=string,zone=string --add-on-demand-instances=atmTags={string=string},id=string,machineType=string,zone=string
|
|
|
|
JSON Example:
|
|
|
|
--add-on-demand-instances='[{"atmTags": {"string": "string"}, "id": "string", "machineType": "string", "zone": "string"}]'
|
|
|
|
File Example:
|
|
|
|
--add-on-demand-instances=path_to_file.(yaml|json)
|
|
|
|
--add-reserved-instances=[atmTags=ATMTAGS],[id=ID],[reservation=RESERVATION],[reservationBlock=RESERVATIONBLOCK],[reservationSubBlock=RESERVATIONSUBBLOCK]
|
|
Parameters to define cluster reserved instances.
|
|
|
|
For e.g. --add-reserved-instances
|
|
id=c1,reservation=zones/us-central1-a/reservations/reservation-1
|
|
|
|
Exactly one of reservation, reservation-block, or
|
|
reservation-sub-block must be provided. reservation: The name of the
|
|
reservation to use, in the format
|
|
zones/us-central1-a/reservations/reservation-1. reservationBlock: The
|
|
name of the reservation block to use, in the format
|
|
zones/us-central1-a/reservations/reservation-1/reservationBlocks/block-1.
|
|
reservationSubBlock: The name of the reservation sub-block to use, in
|
|
the format
|
|
zones/us-central1-a/reservations/reservation-1/reservationBlocks/block-1/reservationSubBlocks/sub-block-1.
|
|
|
|
Sets add_reserved_instances value.
|
|
|
|
atmTags
|
|
Sets atmTags value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
reservation
|
|
Sets reservation value.
|
|
|
|
reservationBlock
|
|
Sets reservationBlock value.
|
|
|
|
reservationSubBlock
|
|
Sets reservationSubBlock value.
|
|
|
|
Shorthand Example:
|
|
|
|
--add-reserved-instances=atmTags={string=string},id=string,reservation=string,reservationBlock=string,reservationSubBlock=string --add-reserved-instances=atmTags={string=string},id=string,reservation=string,reservationBlock=string,reservationSubBlock=string
|
|
|
|
JSON Example:
|
|
|
|
--add-reserved-instances='[{"atmTags": {"string": "string"}, "id": "string", "reservation": "string", "reservationBlock": "string", "reservationSubBlock": "string"}]'
|
|
|
|
File Example:
|
|
|
|
--add-reserved-instances=path_to_file.(yaml|json)
|
|
|
|
--add-slurm-epilog-scripts=[ADD_SLURM_EPILOG_SCRIPTS,...]
|
|
Slurm epilog bash scripts.
|
|
|
|
For e.g. --add-slurm-epilog-scripts script1.sh,script2.sh
|
|
|
|
--add-slurm-node-sets=[bootDisk=BOOTDISK],[computeId=COMPUTEID],[container-resource-labels=CONTAINER-RESOURCE-LABELS],[container-startup-script=CONTAINER-STARTUP-SCRIPT],[id=ID],[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[startupScript=STARTUPSCRIPT],[startupScriptTimeout=STARTUPSCRIPTTIMEOUT],[staticNodeCount=STATICNODECOUNT],[storageConfigs=STORAGECONFIGS],[type=TYPE]
|
|
Parameters to define slurm cluster nodeset config.
|
|
|
|
For e.g. --add-slurm-node-sets
|
|
id=ns1,computeId=c1,type=gce,staticNodeCount=1,maxDynamicNodeCount=2,startupScript="echo
|
|
hello",labels="k1=v1"
|
|
|
|
To configure a node set backed by Google Kubernetes Engine, use
|
|
type=gke. If type=gke is specified, Compute Engine specific fields
|
|
(labels, startupScript, bootDisk, startupScriptTimeout) cannot be
|
|
used, but container-specific fields (container-resource-labels,
|
|
container-startup-script) may be used. For e.g. --add-slurm-node-sets
|
|
id=ns1,computeId=c1,type=gke For e.g. --add-slurm-node-sets
|
|
id=ns1,computeId=c1,type=gke,container-resource-labels="k1=v1",container-startup-script="echo
|
|
hello"
|
|
|
|
Defaults:
|
|
▸ staticNodeCount: 1
|
|
▸ type: gce
|
|
|
|
Note:
|
|
▸ startupScript:
|
|
▫ Either str or file_path
|
|
▫ For file_path, only bash file format (.sh or .bash) is
|
|
supported.
|
|
▫ For file_path, only absolute path is supported.
|
|
|
|
Sets add_slurm_node_sets value.
|
|
|
|
bootDisk
|
|
Sets bootDisk value.
|
|
|
|
image
|
|
Sets image value.
|
|
|
|
sizeGb
|
|
Required, sets sizeGb value.
|
|
|
|
type
|
|
Required, sets type value.
|
|
|
|
computeId
|
|
Sets computeId value.
|
|
|
|
container-resource-labels
|
|
Sets container-resource-labels value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
container-startup-script
|
|
Sets container-startup-script value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
labels
|
|
Sets labels value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
maxDynamicNodeCount
|
|
Sets maxDynamicNodeCount value.
|
|
|
|
startupScript
|
|
Sets startupScript value.
|
|
|
|
startupScriptTimeout
|
|
Sets startupScriptTimeout value.
|
|
|
|
staticNodeCount
|
|
Sets staticNodeCount value.
|
|
|
|
storageConfigs
|
|
Sets storageConfigs value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
localMount
|
|
Required, sets localMount value.
|
|
|
|
type
|
|
Sets type value.
|
|
|
|
Shorthand Example:
|
|
|
|
--add-slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,startupScript=string,startupScriptTimeout=string,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}],type=string --add-slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,startupScript=string,startupScriptTimeout=string,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}],type=string
|
|
|
|
JSON Example:
|
|
|
|
--add-slurm-node-sets='[{"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "computeId": "string", "container-resource-labels": {"string": "string"}, "container-startup-script": "string", "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "startupScript": "string", "startupScriptTimeout": "string", "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}], "type": "string"}]'
|
|
|
|
File Example:
|
|
|
|
--add-slurm-node-sets=path_to_file.(yaml|json)
|
|
|
|
--add-slurm-partitions=[exclusive=EXCLUSIVE],[id=ID],[nodeSetIds=NODESETIDS]
|
|
Parameters to define slurm cluster partitions.
|
|
|
|
For e.g. --add-slurm-partitions
|
|
id=p1,nodesetIds=[ns1,ns2],exclusive=false.
|
|
|
|
Sets add_slurm_partitions value.
|
|
|
|
exclusive
|
|
Sets exclusive value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
nodeSetIds
|
|
Required, sets nodeSetIds value.
|
|
|
|
Shorthand Example:
|
|
|
|
--add-slurm-partitions=exclusive=boolean,id=string,nodeSetIds=[string] --add-slurm-partitions=exclusive=boolean,id=string,nodeSetIds=[string]
|
|
|
|
JSON Example:
|
|
|
|
--add-slurm-partitions='[{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}]'
|
|
|
|
File Example:
|
|
|
|
--add-slurm-partitions=path_to_file.(yaml|json)
|
|
|
|
--add-slurm-prolog-scripts=[ADD_SLURM_PROLOG_SCRIPTS,...]
|
|
Slurm prolog bash scripts.
|
|
|
|
For e.g. --add-slurm-prolog-scripts script1.sh,script2.sh
|
|
|
|
--add-slurm-task-epilog-scripts=[ADD_SLURM_TASK_EPILOG_SCRIPTS,...]
|
|
Slurm task epilog bash scripts.
|
|
|
|
For e.g. --add-slurm-task-epilog-scripts script1.sh,script2.sh
|
|
|
|
--add-slurm-task-prolog-scripts=[ADD_SLURM_TASK_PROLOG_SCRIPTS,...]
|
|
Slurm task prolog bash scripts.
|
|
|
|
For e.g. --add-slurm-task-prolog-scripts script1.sh,script2.sh
|
|
|
|
--add-spot-instances=[atmTags=ATMTAGS],[id=ID],[machineType=MACHINETYPE],[terminationAction=TERMINATIONACTION],[zone=ZONE]
|
|
Parameters to define cluster spot instances.
|
|
|
|
For e.g. --add-spot-instances
|
|
id=c1,zone=us-central1-a,machineType=n1-standard-1,atmTags="tag1=val1".
|
|
|
|
Sets add_spot_instances value.
|
|
|
|
atmTags
|
|
Sets atmTags value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
machineType
|
|
Required, sets machineType value.
|
|
|
|
terminationAction
|
|
Sets terminationAction value.
|
|
|
|
zone
|
|
Required, sets zone value.
|
|
|
|
Shorthand Example:
|
|
|
|
--add-spot-instances=atmTags={string=string},id=string,machineType=string,terminationAction=string,zone=string --add-spot-instances=atmTags={string=string},id=string,machineType=string,terminationAction=string,zone=string
|
|
|
|
JSON Example:
|
|
|
|
--add-spot-instances='[{"atmTags": {"string": "string"}, "id": "string", "machineType": "string", "terminationAction": "string", "zone": "string"}]'
|
|
|
|
File Example:
|
|
|
|
--add-spot-instances=path_to_file.(yaml|json)
|
|
|
|
--add-storage-buckets=[id=ID],[name=NAME]
|
|
Reference of existing Google Cloud Storage bucket.
|
|
|
|
id: ID of the bucket resource, used to refer to this resource in
|
|
storage-configs. name: Name of the existing Cloud Storage bucket to
|
|
import from your project in the format of bucket-name.
|
|
|
|
For e.g. --add-storage-buckets id=my-bucket,name=bucket-1.
|
|
|
|
Sets add_storage_buckets value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
name
|
|
Required, sets name value.
|
|
|
|
Shorthand Example:
|
|
|
|
--add-storage-buckets=id=string,name=string --add-storage-buckets=id=string,name=string
|
|
|
|
JSON Example:
|
|
|
|
--add-storage-buckets='[{"id": "string", "name": "string"}]'
|
|
|
|
File Example:
|
|
|
|
--add-storage-buckets=path_to_file.(yaml|json)
|
|
|
|
--description=DESCRIPTION
|
|
Description of the cluster.
|
|
|
|
For e.g. --description "My cluster"
|
|
|
|
--remove-filestore-instances=[REMOVE_FILESTORE_INSTANCES,...]
|
|
Parameters to remove filestore instance config by filestore name.
|
|
|
|
For e.g. --remove-filestore-instances
|
|
locations/us-central1/instances/filestore-1,locations/us-central1/instances/filestore-2,...
|
|
|
|
--remove-flex-start-instances=[REMOVE_FLEX_START_INSTANCES,...]
|
|
Parameters to remove Flex Start instance config by compute id.
|
|
|
|
For e.g. --remove-flex-start-instances c1,c2,...
|
|
|
|
--remove-labels=[REMOVE_LABELS,...]
|
|
Parameters to remove cluster label by key.
|
|
|
|
For e.g. --remove-labels key1,key2,...
|
|
|
|
--remove-lustre-instances=[REMOVE_LUSTRE_INSTANCES,...]
|
|
Parameters to remove lustre instance config by lustre name.
|
|
|
|
For e.g. --remove-lustre-instances
|
|
locations/us-central1/instances/lustre-1,locations/us-central1/instances/lustre-2,...
|
|
|
|
--remove-on-demand-instances=[REMOVE_ON_DEMAND_INSTANCES,...]
|
|
Parameters to remove on demand instances config by compute id.
|
|
|
|
For e.g. --remove-on-demand-instances c1,c2,...
|
|
|
|
--remove-reserved-instances=[REMOVE_RESERVED_INSTANCES,...]
|
|
Parameters to remove reserved instance config by compute id.
|
|
|
|
For e.g. --remove-reserved-instances c1,c2,...
|
|
|
|
--remove-slurm-epilog-scripts=[REMOVE_SLURM_EPILOG_SCRIPTS,...]
|
|
Scripts to remove from Slurm epilog bash scripts.
|
|
|
|
For e.g. --remove-slurm-epilog-scripts script1.sh,script2.sh
|
|
|
|
--remove-slurm-node-sets=[REMOVE_SLURM_NODE_SETS,...]
|
|
Parameters to remove slurm nodeset config by nodeset id.
|
|
|
|
For e.g. --remove-slurm-node-sets ns1,ns2,...
|
|
|
|
--remove-slurm-partitions=[REMOVE_SLURM_PARTITIONS,...]
|
|
Parameters to remove slurm partition config by partition id.
|
|
|
|
For e.g. --remove-slurm-partitions p1,p2,...
|
|
|
|
--remove-slurm-prolog-scripts=[REMOVE_SLURM_PROLOG_SCRIPTS,...]
|
|
Scripts to remove from Slurm prolog bash scripts.
|
|
|
|
For e.g. --remove-slurm-prolog-scripts script1.sh,script2.sh
|
|
|
|
--remove-slurm-task-epilog-scripts=[REMOVE_SLURM_TASK_EPILOG_SCRIPTS,...]
|
|
Scripts to remove from Slurm task epilog bash scripts.
|
|
|
|
For e.g. --remove-slurm-task-epilog-scripts script1.sh,script2.sh
|
|
|
|
--remove-slurm-task-prolog-scripts=[REMOVE_SLURM_TASK_PROLOG_SCRIPTS,...]
|
|
Scripts to remove from Slurm task prolog bash scripts.
|
|
|
|
For e.g. --remove-slurm-task-prolog-scripts script1.sh,script2.sh
|
|
|
|
--remove-spot-instances=[REMOVE_SPOT_INSTANCES,...]
|
|
Parameters to remove spot instance config by compute id.
|
|
|
|
For e.g. --remove-spot-instances c1,c2,...
|
|
|
|
--remove-storage-buckets=[REMOVE_STORAGE_BUCKETS,...]
|
|
Parameters to remove Google Cloud Storage bucket by bucket name.
|
|
|
|
For e.g. --remove-storage-buckets bucket-1,bucket-2,...
|
|
|
|
--slurm-default-partition=SLURM_DEFAULT_PARTITION
|
|
Parameters to define slurm cluster default partition.
|
|
|
|
For e.g. --slurm-default-partition p1
|
|
|
|
--update-slurm-config=[accountingStorageEnforceFlags=ACCOUNTINGSTORAGEENFORCEFLAGS],[healthCheckInterval=HEALTHCHECKINTERVAL],[healthCheckNodeState=HEALTHCHECKNODESTATE],[healthCheckProgram=HEALTHCHECKPROGRAM],[preemptExemptTime=PREEMPTEXEMPTTIME],[preemptMode=PREEMPTMODE],[preemptType=PREEMPTTYPE],[priorityType=PRIORITYTYPE],[priorityWeightAge=PRIORITYWEIGHTAGE],[priorityWeightAssoc=PRIORITYWEIGHTASSOC],[priorityWeightFairshare=PRIORITYWEIGHTFAIRSHARE],[priorityWeightJobSize=PRIORITYWEIGHTJOBSIZE],[priorityWeightPartition=PRIORITYWEIGHTPARTITION],[priorityWeightQos=PRIORITYWEIGHTQOS],[priorityWeightTres=PRIORITYWEIGHTTRES],[prologEpilogTimeout=PROLOGEPILOGTIMEOUT],[prologFlags=PROLOGFLAGS],[requeueExitCodes=REQUEUEEXITCODES],[requeueHoldExitCodes=REQUEUEHOLDEXITCODES]
|
|
Parameters to define slurm cluster config.
|
|
|
|
For e.g. --update-slurm-config
|
|
healthCheckInterval=10,healthCheckNodeState=IDLE,healthCheckProgram=/usr/bin/true.
|
|
|
|
Sets update_slurm_config value.
|
|
|
|
accountingStorageEnforceFlags
|
|
Sets accountingStorageEnforceFlags value.
|
|
|
|
healthCheckInterval
|
|
Sets healthCheckInterval value.
|
|
|
|
healthCheckNodeState
|
|
Sets healthCheckNodeState value.
|
|
|
|
healthCheckProgram
|
|
Sets healthCheckProgram value.
|
|
|
|
preemptExemptTime
|
|
Sets preemptExemptTime value.
|
|
|
|
preemptMode
|
|
Sets preemptMode value.
|
|
|
|
preemptType
|
|
Sets preemptType value.
|
|
|
|
priorityType
|
|
Sets priorityType value.
|
|
|
|
priorityWeightAge
|
|
Sets priorityWeightAge value.
|
|
|
|
priorityWeightAssoc
|
|
Sets priorityWeightAssoc value.
|
|
|
|
priorityWeightFairshare
|
|
Sets priorityWeightFairshare value.
|
|
|
|
priorityWeightJobSize
|
|
Sets priorityWeightJobSize value.
|
|
|
|
priorityWeightPartition
|
|
Sets priorityWeightPartition value.
|
|
|
|
priorityWeightQos
|
|
Sets priorityWeightQos value.
|
|
|
|
priorityWeightTres
|
|
Sets priorityWeightTres value.
|
|
|
|
prologEpilogTimeout
|
|
Sets prologEpilogTimeout value.
|
|
|
|
prologFlags
|
|
Sets prologFlags value.
|
|
|
|
requeueExitCodes
|
|
Sets requeueExitCodes value.
|
|
|
|
requeueHoldExitCodes
|
|
Sets requeueHoldExitCodes value.
|
|
|
|
Shorthand Example:
|
|
|
|
--update-slurm-config={accountingStorageEnforceFlags,healthCheckInterval=int,healthCheckNodeState=string,healthCheckProgram=string,preemptExemptTime=string,preemptMode,preemptType=string,priorityType=string,priorityWeightAge=int,priorityWeightAssoc=int,priorityWeightFairshare=int,priorityWeightJobSize=int,priorityWeightPartition=int,priorityWeightQos=int,priorityWeightTres=string,prologEpilogTimeout=string,prologFlags,requeueExitCodes,requeueHoldExitCodes}
|
|
|
|
JSON Example:
|
|
|
|
--update-slurm-config='{"accountingStorageEnforceFlags", "healthCheckInterval": int, "healthCheckNodeState": "string", "healthCheckProgram": "string", "preemptExemptTime": "string", "preemptMode", "preemptType": "string", "priorityType": "string", "priorityWeightAge": int, "priorityWeightAssoc": int, "priorityWeightFairshare": int, "priorityWeightJobSize": int, "priorityWeightPartition": int, "priorityWeightQos": int, "priorityWeightTres": "string", "prologEpilogTimeout": "string", "prologFlags", "requeueExitCodes", "requeueHoldExitCodes"}'
|
|
|
|
File Example:
|
|
|
|
--update-slurm-config=path_to_file.(yaml|json)
|
|
|
|
--update-slurm-disable-health-check-program
|
|
If true, health checking is disabled, and health_check_interval,
|
|
health_check_node_state, and health_check_program should not be
|
|
passed in.
|
|
|
|
For e.g. --update-slurm-disable-health-check-program
|
|
|
|
--update-slurm-login-node=[bootDisk=BOOTDISK],[count=COUNT],[startupScript=STARTUPSCRIPT]
|
|
Parameters to update slurm cluster login node. Only bootDisk, count
|
|
and startupScript can be updated.
|
|
|
|
For e.g. --update-slurm-login-node count=2,startupScript="echo
|
|
hello".
|
|
|
|
Sets update_slurm_login_node value.
|
|
|
|
bootDisk
|
|
Sets bootDisk value.
|
|
|
|
image
|
|
Sets image value.
|
|
|
|
sizeGb
|
|
Required, sets sizeGb value.
|
|
|
|
type
|
|
Required, sets type value.
|
|
|
|
count
|
|
Sets count value.
|
|
|
|
startupScript
|
|
Sets startupScript value.
|
|
|
|
Shorthand Example:
|
|
|
|
--update-slurm-login-node=bootDisk={image=string,sizeGb=int,type=string},count=int,startupScript=string
|
|
|
|
JSON Example:
|
|
|
|
--update-slurm-login-node='{"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "count": int, "startupScript": "string"}'
|
|
|
|
File Example:
|
|
|
|
--update-slurm-login-node=path_to_file.(yaml|json)
|
|
|
|
--update-slurm-node-sets=[bootDisk=BOOTDISK],[computeId=COMPUTEID],[container-resource-labels=CONTAINER-RESOURCE-LABELS],[container-startup-script=CONTAINER-STARTUP-SCRIPT],[id=ID],[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[startupScript=STARTUPSCRIPT],[startupScriptTimeout=STARTUPSCRIPTTIMEOUT],[staticNodeCount=STATICNODECOUNT],[storageConfigs=STORAGECONFIGS],[type=TYPE]
|
|
Parameters to define and update slurm cluster nodeset config.
|
|
|
|
For e.g. --update-slurm-node-sets
|
|
id=ns1,staticNodeCount=1,maxDynamicNodeCount=2
|
|
|
|
To update a node set backed by GKE, use container-resource-labels or
|
|
container-startup-script. For e.g. --update-slurm-node-sets
|
|
id=ns1,type=gke,container-resource-labels="k1=v1",container-startup-script="echo
|
|
hello".
|
|
|
|
Sets update_slurm_node_sets value.
|
|
|
|
bootDisk
|
|
Sets bootDisk value.
|
|
|
|
image
|
|
Sets image value.
|
|
|
|
sizeGb
|
|
Required, sets sizeGb value.
|
|
|
|
type
|
|
Required, sets type value.
|
|
|
|
computeId
|
|
Sets computeId value.
|
|
|
|
container-resource-labels
|
|
Sets container-resource-labels value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
container-startup-script
|
|
Sets container-startup-script value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
labels
|
|
Sets labels value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
maxDynamicNodeCount
|
|
Sets maxDynamicNodeCount value.
|
|
|
|
startupScript
|
|
Sets startupScript value.
|
|
|
|
startupScriptTimeout
|
|
Sets startupScriptTimeout value.
|
|
|
|
staticNodeCount
|
|
Sets staticNodeCount value.
|
|
|
|
storageConfigs
|
|
Sets storageConfigs value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
localMount
|
|
Required, sets localMount value.
|
|
|
|
type
|
|
Sets type value.
|
|
|
|
Shorthand Example:
|
|
|
|
--update-slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,startupScript=string,startupScriptTimeout=string,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}],type=string --update-slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,startupScript=string,startupScriptTimeout=string,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}],type=string
|
|
|
|
JSON Example:
|
|
|
|
--update-slurm-node-sets='[{"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "computeId": "string", "container-resource-labels": {"string": "string"}, "container-startup-script": "string", "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "startupScript": "string", "startupScriptTimeout": "string", "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}], "type": "string"}]'
|
|
|
|
File Example:
|
|
|
|
--update-slurm-node-sets=path_to_file.(yaml|json)
|
|
|
|
--update-slurm-partitions=[exclusive=EXCLUSIVE],[id=ID],[nodeSetIds=NODESETIDS]
|
|
Parameters to define and update slurm cluster partition config.
|
|
|
|
For e.g. --update-slurm-partitions
|
|
id=p1,nodesetIds=[ns1,ns2],exclusive=false.
|
|
|
|
Sets update_slurm_partitions value.
|
|
|
|
exclusive
|
|
Sets exclusive value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
nodeSetIds
|
|
Sets nodeSetIds value.
|
|
|
|
Shorthand Example:
|
|
|
|
--update-slurm-partitions=exclusive=boolean,id=string,nodeSetIds=[string] --update-slurm-partitions=exclusive=boolean,id=string,nodeSetIds=[string]
|
|
|
|
JSON Example:
|
|
|
|
--update-slurm-partitions='[{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}]'
|
|
|
|
File Example:
|
|
|
|
--update-slurm-partitions=path_to_file.(yaml|json)
|
|
|
|
Cluster configuration for updates.
|
|
|
|
--config=[computeResources=COMPUTERESOURCES],[description=DESCRIPTION],[labels=LABELS],[name=NAME],[networkResources=NETWORKRESOURCES],[orchestrator=ORCHESTRATOR],[storageResources=STORAGERESOURCES]
|
|
Configuration of the cluster specs in the form of a JSON object.
|
|
Required, sets config value.
|
|
|
|
computeResources
|
|
Sets computeResources value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
config
|
|
Sets config value.
|
|
|
|
newDwsFlexInstances
|
|
Sets newDwsFlexInstances value.
|
|
|
|
atmTags
|
|
Sets atmTags value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
machineType
|
|
Sets machineType value.
|
|
|
|
maxDuration
|
|
Sets maxDuration value.
|
|
|
|
terminationAction
|
|
Sets terminationAction value.
|
|
|
|
zone
|
|
Sets zone value.
|
|
|
|
newFlexStartInstances
|
|
Sets newFlexStartInstances value.
|
|
|
|
atmTags
|
|
Sets atmTags value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
machineType
|
|
Sets machineType value.
|
|
|
|
maxDuration
|
|
Sets maxDuration value.
|
|
|
|
terminationAction
|
|
Sets terminationAction value.
|
|
|
|
zone
|
|
Sets zone value.
|
|
|
|
newOnDemandInstances
|
|
Sets newOnDemandInstances value.
|
|
|
|
atmTags
|
|
Sets atmTags value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
machineType
|
|
Sets machineType value.
|
|
|
|
zone
|
|
Sets zone value.
|
|
|
|
newReservedInstances
|
|
Sets newReservedInstances value.
|
|
|
|
atmTags
|
|
Sets atmTags value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
machineType
|
|
Sets machineType value.
|
|
|
|
reservation
|
|
Sets reservation value.
|
|
|
|
reservationBlock
|
|
Sets reservationBlock value.
|
|
|
|
reservationSubBlock
|
|
Sets reservationSubBlock value.
|
|
|
|
type
|
|
Sets type value.
|
|
|
|
zone
|
|
Sets zone value.
|
|
|
|
newSpotInstances
|
|
Sets newSpotInstances value.
|
|
|
|
atmTags
|
|
Sets atmTags value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
machineType
|
|
Sets machineType value.
|
|
|
|
terminationAction
|
|
Sets terminationAction value.
|
|
|
|
zone
|
|
Sets zone value.
|
|
|
|
description
|
|
Sets description value.
|
|
|
|
labels
|
|
Sets labels value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
name
|
|
Sets name value.
|
|
|
|
networkResources
|
|
Sets networkResources value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
config
|
|
Sets config value.
|
|
|
|
existingComputeNetwork
|
|
Sets existingComputeNetwork value.
|
|
|
|
network
|
|
Sets network value.
|
|
|
|
subnetwork
|
|
Sets subnetwork value.
|
|
|
|
existingNetwork
|
|
Sets existingNetwork value.
|
|
|
|
network
|
|
Sets network value.
|
|
|
|
subnetwork
|
|
Sets subnetwork value.
|
|
|
|
newComputeNetwork
|
|
Sets newComputeNetwork value.
|
|
|
|
description
|
|
Sets description value.
|
|
|
|
network
|
|
Sets network value.
|
|
|
|
newNetwork
|
|
Sets newNetwork value.
|
|
|
|
description
|
|
Sets description value.
|
|
|
|
network
|
|
Sets network value.
|
|
|
|
orchestrator
|
|
Sets orchestrator value.
|
|
|
|
slurm
|
|
Sets slurm value.
|
|
|
|
config
|
|
Sets config value.
|
|
|
|
accountingStorageEnforceFlags
|
|
Sets accountingStorageEnforceFlags value.
|
|
|
|
healthCheckInterval
|
|
Sets healthCheckInterval value.
|
|
|
|
healthCheckNodeState
|
|
Sets healthCheckNodeState value.
|
|
|
|
healthCheckProgram
|
|
Sets healthCheckProgram value.
|
|
|
|
preemptExemptTime
|
|
Sets preemptExemptTime value.
|
|
|
|
preemptMode
|
|
Sets preemptMode value.
|
|
|
|
preemptType
|
|
Sets preemptType value.
|
|
|
|
priorityType
|
|
Sets priorityType value.
|
|
|
|
priorityWeightAge
|
|
Sets priorityWeightAge value.
|
|
|
|
priorityWeightAssoc
|
|
Sets priorityWeightAssoc value.
|
|
|
|
priorityWeightFairshare
|
|
Sets priorityWeightFairshare value.
|
|
|
|
priorityWeightJobSize
|
|
Sets priorityWeightJobSize value.
|
|
|
|
priorityWeightPartition
|
|
Sets priorityWeightPartition value.
|
|
|
|
priorityWeightQos
|
|
Sets priorityWeightQos value.
|
|
|
|
priorityWeightTres
|
|
Sets priorityWeightTres value.
|
|
|
|
prologEpilogTimeout
|
|
Sets prologEpilogTimeout value.
|
|
|
|
prologFlags
|
|
Sets prologFlags value.
|
|
|
|
requeueExitCodes
|
|
Sets requeueExitCodes value.
|
|
|
|
requeueHoldExitCodes
|
|
Sets requeueHoldExitCodes value.
|
|
|
|
defaultPartition
|
|
Sets defaultPartition value.
|
|
|
|
disableHealthCheckProgram
|
|
Sets disableHealthCheckProgram value.
|
|
|
|
epilogBashScripts
|
|
Sets epilogBashScripts value.
|
|
|
|
loginNodes
|
|
Sets loginNodes value.
|
|
|
|
bootDisk
|
|
Sets bootDisk value.
|
|
|
|
image
|
|
Sets image value.
|
|
|
|
sizeGb
|
|
Required, sets sizeGb value.
|
|
|
|
type
|
|
Required, sets type value.
|
|
|
|
count
|
|
Sets count value.
|
|
|
|
enableOsLogin
|
|
Sets enableOsLogin value.
|
|
|
|
enablePublicIps
|
|
Sets enablePublicIps value.
|
|
|
|
labels
|
|
Sets labels value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
machineType
|
|
Sets machineType value.
|
|
|
|
startupScript
|
|
Sets startupScript value.
|
|
|
|
storageConfigs
|
|
Sets storageConfigs value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
localMount
|
|
Required, sets localMount value.
|
|
|
|
zone
|
|
Sets zone value.
|
|
|
|
nodeSets
|
|
Sets nodeSets value.
|
|
|
|
computeId
|
|
Sets computeId value.
|
|
|
|
computeInstance
|
|
Sets computeInstance value.
|
|
|
|
bootDisk
|
|
Sets bootDisk value.
|
|
|
|
image
|
|
Sets image value.
|
|
|
|
sizeGb
|
|
Required, sets sizeGb value.
|
|
|
|
type
|
|
Required, sets type value.
|
|
|
|
labels
|
|
Sets labels value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
startupScript
|
|
Sets startupScript value.
|
|
|
|
startupScriptTimeout
|
|
Sets startupScriptTimeout value.
|
|
|
|
containerNodePool
|
|
Sets containerNodePool value.
|
|
|
|
id
|
|
Sets id value.
|
|
|
|
maxDynamicNodeCount
|
|
Sets maxDynamicNodeCount value.
|
|
|
|
staticNodeCount
|
|
Sets staticNodeCount value.
|
|
|
|
storageConfigs
|
|
Sets storageConfigs value.
|
|
|
|
id
|
|
Required, sets id value.
|
|
|
|
localMount
|
|
Required, sets localMount value.
|
|
|
|
partitions
|
|
Sets partitions value.
|
|
|
|
exclusive
|
|
Sets exclusive value.
|
|
|
|
id
|
|
Sets id value.
|
|
|
|
nodeSetIds
|
|
Sets nodeSetIds value.
|
|
|
|
prologBashScripts
|
|
Sets prologBashScripts value.
|
|
|
|
taskEpilogBashScripts
|
|
Sets taskEpilogBashScripts value.
|
|
|
|
taskPrologBashScripts
|
|
Sets taskPrologBashScripts value.
|
|
|
|
storageResources
|
|
Sets storageResources value.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
config
|
|
Sets config value.
|
|
|
|
existingBucket
|
|
Sets existingBucket value.
|
|
|
|
bucket
|
|
Sets bucket value.
|
|
|
|
existingFilestore
|
|
Sets existingFilestore value.
|
|
|
|
filestore
|
|
Sets filestore value.
|
|
|
|
existingLustre
|
|
Sets existingLustre value.
|
|
|
|
lustre
|
|
Sets lustre value.
|
|
|
|
newBucket
|
|
Sets newBucket value.
|
|
|
|
autoclass
|
|
Sets autoclass value.
|
|
|
|
enabled
|
|
Sets enabled value.
|
|
|
|
terminalStorageClass
|
|
Sets terminalStorageClass value.
|
|
|
|
bucket
|
|
Sets bucket value.
|
|
|
|
hierarchicalNamespace
|
|
Sets hierarchicalNamespace value.
|
|
|
|
enabled
|
|
Sets enabled value.
|
|
|
|
storageClass
|
|
Sets storageClass value.
|
|
|
|
newFilestore
|
|
Sets newFilestore value.
|
|
|
|
description
|
|
Sets description value.
|
|
|
|
fileShares
|
|
Sets fileShares value.
|
|
|
|
capacityGb
|
|
Sets capacityGb value.
|
|
|
|
fileShare
|
|
Sets fileShare value.
|
|
|
|
filestore
|
|
Sets filestore value.
|
|
|
|
id
|
|
Sets id value.
|
|
|
|
protocol
|
|
Sets protocol value.
|
|
|
|
tier
|
|
Sets tier value.
|
|
|
|
newLustre
|
|
Sets newLustre value.
|
|
|
|
capacityGb
|
|
Sets capacityGb value.
|
|
|
|
description
|
|
Sets description value.
|
|
|
|
filesystem
|
|
Sets filesystem value.
|
|
|
|
id
|
|
Sets id value.
|
|
|
|
lustre
|
|
Sets lustre value.
|
|
|
|
perUnitStorageThroughput
|
|
Sets perUnitStorageThroughput value.
|
|
|
|
Shorthand Example:
|
|
|
|
--config=computeResources={string={config={newDwsFlexInstances={atmTags={string=string},machineType=string,maxDuration=string,terminationAction=string,zone=string},newFlexStartInstances={atmTags={string=string},machineType=string,maxDuration=string,terminationAction=string,zone=string},newOnDemandInstances={atmTags={string=string},machineType=string,zone=string},newReservedInstances={atmTags={string=string},machineType=string,reservation=string,reservationBlock=string,reservationSubBlock=string,type=string,zone=string},newSpotInstances={atmTags={string=string},machineType=string,terminationAction=string,zone=string}}}},description=string,labels={string=string},name=string,networkResources={string={config={existingComputeNetwork={network=string,subnetwork=string},existingNetwork={network=string,subnetwork=string},newComputeNetwork={description=string,network=string},newNetwork={description=string,network=string}}}},orchestrator={slurm={config={accountingStorageEnforceFlags,healthCheckInterval=int,healthCheckNodeState=string,healthCheckProgram=string,preemptExemptTime=string,preemptMode,preemptType=string,priorityType=string,priorityWeightAge=int,priorityWeightAssoc=int,priorityWeightFairshare=int,priorityWeightJobSize=int,priorityWeightPartition=int,priorityWeightQos=int,priorityWeightTres=string,prologEpilogTimeout=string,prologFlags,requeueExitCodes,requeueHoldExitCodes},defaultPartition=string,disableHealthCheckProgram=boolean,epilogBashScripts,loginNodes={bootDisk={image=string,sizeGb=int,type=string},count=int,enableOsLogin=boolean,enablePublicIps=boolean,labels={string=string},machineType=string,startupScript=string,storageConfigs=[{id=string,localMount=string}],zone=string},nodeSets=[{computeId=string,computeInstance={bootDisk={image=string,sizeGb=int,type=string},labels={string=string},startupScript=string,startupScriptTimeout=string},containerNodePool,id=string,maxDynamicNodeCount=int,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}],prologBashScripts,taskEpilogBashScripts,taskPrologBashScripts}},storageResources={string={config={existingBucket={bucket=string},existingFilestore={filestore=string},existingLustre={lustre=string},newBucket={autoclass={enabled=boolean,terminalStorageClass=string},bucket=string,hierarchicalNamespace={enabled=boolean},storageClass=string},newFilestore={description=string,fileShares=[{capacityGb=int,fileShare=string}],filestore=string,id=string,protocol=string,tier=string},newLustre={capacityGb=int,description=string,filesystem=string,id=string,lustre=string,perUnitStorageThroughput=int}}}}
|
|
|
|
JSON Example:
|
|
|
|
--config='{"computeResources": {"string": {"config": {"newDwsFlexInstances": {"atmTags": {"string": "string"}, "machineType": "string", "maxDuration": "string", "terminationAction": "string", "zone": "string"}, "newFlexStartInstances": {"atmTags": {"string": "string"}, "machineType": "string", "maxDuration": "string", "terminationAction": "string", "zone": "string"}, "newOnDemandInstances": {"atmTags": {"string": "string"}, "machineType": "string", "zone": "string"}, "newReservedInstances": {"atmTags": {"string": "string"}, "machineType": "string", "reservation": "string", "reservationBlock": "string", "reservationSubBlock": "string", "type": "string", "zone": "string"}, "newSpotInstances": {"atmTags": {"string": "string"}, "machineType": "string", "terminationAction": "string", "zone": "string"}}}}, "description": "string", "labels": {"string": "string"}, "name": "string", "networkResources": {"string": {"config": {"existingComputeNetwork": {"network": "string", "subnetwork": "string"}, "existingNetwork": {"network": "string", "subnetwork": "string"}, "newComputeNetwork": {"description": "string", "network": "string"}, "newNetwork": {"description": "string", "network": "string"}}}}, "orchestrator": {"slurm": {"config": {"accountingStorageEnforceFlags", "healthCheckInterval": int, "healthCheckNodeState": "string", "healthCheckProgram": "string", "preemptExemptTime": "string", "preemptMode", "preemptType": "string", "priorityType": "string", "priorityWeightAge": int, "priorityWeightAssoc": int, "priorityWeightFairshare": int, "priorityWeightJobSize": int, "priorityWeightPartition": int, "priorityWeightQos": int, "priorityWeightTres": "string", "prologEpilogTimeout": "string", "prologFlags", "requeueExitCodes", "requeueHoldExitCodes"}, "defaultPartition": "string", "disableHealthCheckProgram": boolean, "epilogBashScripts", "loginNodes": {"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "count": int, "enableOsLogin": boolean, "enablePublicIps": boolean, "labels": {"string": "string"}, "machineType": "string", "startupScript": "string", "storageConfigs": [{"id": "string", "localMount": "string"}], "zone": "string"}, "nodeSets": [{"computeId": "string", "computeInstance": {"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "labels": {"string": "string"}, "startupScript": "string", "startupScriptTimeout": "string"}, "containerNodePool": {}, "id": "string", "maxDynamicNodeCount": int, "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}], "prologBashScripts", "taskEpilogBashScripts", "taskPrologBashScripts"}}, "storageResources": {"string": {"config": {"existingBucket": {"bucket": "string"}, "existingFilestore": {"filestore": "string"}, "existingLustre": {"lustre": "string"}, "newBucket": {"autoclass": {"enabled": boolean, "terminalStorageClass": "string"}, "bucket": "string", "hierarchicalNamespace": {"enabled": boolean}, "storageClass": "string"}, "newFilestore": {"description": "string", "fileShares": [{"capacityGb": int, "fileShare": "string"}], "filestore": "string", "id": "string", "protocol": "string", "tier": "string"}, "newLustre": {"capacityGb": int, "description": "string", "filesystem": "string", "id": "string", "lustre": "string", "perUnitStorageThroughput": int}}}}}'
|
|
|
|
File Example:
|
|
|
|
--config=path_to_file.(yaml|json)
|
|
|
|
This flag argument must be specified if any of the other arguments in
|
|
this group are specified.
|
|
|
|
--update-mask=UPDATE_MASK
|
|
Update mask to specify the fields to update.
|
|
|
|
For e.g. --update-mask "description,labels".
|
|
|
|
Required, sets update_mask value.
|
|
|
|
Input Example:
|
|
|
|
--update-mask=string
|
|
|
|
File Example:
|
|
|
|
--update-mask=path_to_file.(yaml|json)
|
|
|
|
This flag argument must be specified if any of the other arguments in
|
|
this group are specified.
|
|
|
|
OPTIONAL FLAGS
|
|
--async
|
|
Return immediately, without waiting for the operation in progress to
|
|
complete.
|
|
|
|
GCLOUD WIDE FLAGS
|
|
These flags are available to all commands: --access-token-file, --account,
|
|
--billing-project, --configuration, --flags-file, --flatten, --format,
|
|
--help, --impersonate-service-account, --log-http, --project, --quiet,
|
|
--trace-token, --user-output-enabled, --verbosity.
|
|
|
|
Run $ gcloud help for details.
|
|
|
|
NOTES
|
|
This command is currently in alpha and might change without notice. If this
|
|
command fails with API permission errors despite specifying the correct
|
|
project, you might be trying to access an API with an invitation-only early
|
|
access allowlist. This variant is also available:
|
|
|
|
$ gcloud beta cluster-director clusters update
|
|
|