gcloud: Fri Jun 2 10:25:45 UTC 2023

gcloud/builds/triggers/run

@@ -3,7 +3,8 @@ NAME
 
 SYNOPSIS
     gcloud builds triggers run (TRIGGER : --region=REGION)
-        (--branch=BRANCH | --sha=SHA | --tag=TAG) [GCLOUD_WIDE_FLAG ...]
+        [--substitutions=[KEY=VALUE,...]]
+        [--branch=BRANCH | --sha=SHA | --tag=TAG] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     Run a build trigger.
@@ -44,8 +45,28 @@ POSITIONAL ARGUMENTS
           ▸ provide the argument --region on the command line;
           ▸ set the property builds/region.
 
-REQUIRED FLAGS
-     Exactly one of these must be specified:
+FLAGS
+     --substitutions=[KEY=VALUE,...]
+        Parameters to be substituted in the build specification.
+
+        For example (using some nonsensical substitution keys; all keys must
+        begin with an underscore):
+
+            $ gcloud builds triggers create ... --config config.yaml
+                --substitutions _FAVORITE_COLOR=blue,_NUM_CANDIES=10
+
+        This will result in a build where every occurrence of
+        ${_FAVORITE_COLOR} in certain fields is replaced by "blue", and
+        similarly for ${_NUM_CANDIES} and "10".
+
+        Only the following built-in variables can be specified with the
+        --substitutions flag: REPO_NAME, BRANCH_NAME, TAG_NAME, REVISION_ID,
+        COMMIT_SHA, SHORT_SHA.
+
+        For more details, see:
+        https://cloud.google.com/cloud-build/docs/api/build-requests#substitutions
+
+     At most one of these can be specified:
 
        --branch=BRANCH
           Branch to run.