gcloud: Fri Mar 24 11:31:22 UTC 2023

gcloud/alpha/builds/triggers/create/webhook

@@ -8,12 +8,13 @@ SYNOPSIS
           | --inline-config=PATH | [--dockerfile=DOCKERFILE
           : --dockerfile-dir=DOCKERFILE_DIR;
           default="/" --dockerfile-image=DOCKERFILE_IMAGE])
-          : --description=DESCRIPTION
-          --github-enterprise-config=GITHUB_ENTERPRISE_CONFIG --name=NAME
-          --region=REGION --require-approval --service-account=SERVICE_ACCOUNT
+          : --description=DESCRIPTION --name=NAME --region=REGION
+          --require-approval --service-account=SERVICE_ACCOUNT
           --subscription-filter=SUBSCRIPTION_FILTER
-          --substitutions=[KEY=VALUE,...]
-          --repo=REPO --repo-type=REPO_TYPE (--branch=BRANCH | --tag=TAG)])
+          --substitutions=[KEY=VALUE,...] (--branch=BRANCH
+          | --tag=TAG) (--repository=REPOSITORY
+          | [--repo=REPO --repo-type=REPO_TYPE
+          : --github-enterprise-config=GITHUB_ENTERPRISE_CONFIG])])
         [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
@@ -32,6 +33,19 @@ EXAMPLES
             --repo=https://www.github.com/owner/repo --repo-type=GITHUB \
             --branch=my-branch
 
+    To create a Webhook trigger that requires secret
+    projects/my-project/secrets/my-secret/versions/2 and builds off branch
+    my-branch in a 2nd-gen GitHub repository:
+
+        $ gcloud alpha builds triggers create webhook \
+            --name=my-webhook-trigger \
+            --service-account="projects/my-project/serviceAccounts/my-byosa@\
+        my-project.iam.gserviceaccount.com" \
+            --secret=projects/my-project/secrets/my-secret/versions/2 \
+            --branch=my-branch \
+            --repository=projects/my-proj/locations/us-west1/connections/\
+        my-conn/repositories/my-repo
+
 REQUIRED FLAGS
      Exactly one of these must be specified:
 
@@ -53,12 +67,6 @@ REQUIRED FLAGS
          --description=DESCRIPTION
             Build trigger description.
 
-         --github-enterprise-config=GITHUB_ENTERPRISE_CONFIG
-            The resource name of the GitHub Enterprise config that should be
-            applied to this source. Format:
-            projects/{project}/locations/{location}/githubEnterpriseConfigs/{id}
-            or projects/{project}/githubEnterpriseConfigs/{id}
-
          --name=NAME
             Build trigger name.
 
@@ -147,21 +155,7 @@ REQUIRED FLAGS
                 Use a build configuration (cloudbuild.yaml) file for building
                 multiple images in a single trigger.
 
-         Flags for repository information
-
-           --repo=REPO
-              URI of the repository. Currently only HTTP URIs for GitHub and
-              Cloud Source Repositories are supported.
-
-              This flag argument must be specified if any of the other
-              arguments in this group are specified.
-
-           --repo-type=REPO_TYPE
-              Type of the repository. Currently only GitHub and Cloud Source
-              Repository types are supported.
-
-              This flag argument must be specified if any of the other
-              arguments in this group are specified.
+         Flags for repository and branch information
 
            Exactly one of these must be specified:
 
@@ -171,6 +165,36 @@ REQUIRED FLAGS
              --tag=TAG
                 Tag to build.
 
+           Flags for repository information
+
+           Exactly one of these must be specified:
+
+             --repository=REPOSITORY
+                Repository resource (2nd gen) to use, in the format
+                "projects/*/locations/*/connections/*/repositories/".
+
+             1st-gen repository settings.
+
+               --repo=REPO
+                  URI of the repository (1st gen). Currently only HTTP URIs for
+                  GitHub and Cloud Source Repositories are supported.
+
+                  This flag argument must be specified if any of the other
+                  arguments in this group are specified.
+
+               --repo-type=REPO_TYPE
+                  Type of the repository (1st gen). Currently only GitHub and
+                  Cloud Source Repository types are supported.
+
+                  This flag argument must be specified if any of the other
+                  arguments in this group are specified.
+
+               --github-enterprise-config=GITHUB_ENTERPRISE_CONFIG
+                  The resource name of the GitHub Enterprise config that should
+                  be applied to this source (1st gen). Format:
+                  projects/{project}/locations/{location}/githubEnterpriseConfigs/{id}
+                  or projects/{project}/githubEnterpriseConfigs/{id}
+
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,
     --billing-project, --configuration, --flags-file, --flatten, --format,