feat: [deploy] add Skaffold remote config support for GCB repos (#5267)

* feat: add Skaffold remote config support for GCB repos
docs: clarified related comments

PiperOrigin-RevId: 626346409

Source-Link: googleapis/googleapis@357c057

Source-Link: googleapis/googleapis-gen@06261c1
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRlcGxveS8uT3dsQm90LnlhbWwiLCJoIjoiMDYyNjFjMTI0YTg0MzRlZGYwZDBjYTcwZjg2ZDFkMmYyYWVjMTg1MSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

packages/google-cloud-deploy/protos/google/cloud/deploy/v1/cloud_deploy.proto

@@ -35,6 +35,10 @@ option (google.api.resource_definition) = {
   type: "cloudbuild.googleapis.com/Build"
   pattern: "projects/{project}/locations/{location}/builds/{build}"
 };
+option (google.api.resource_definition) = {
+  type: "cloudbuild.googleapis.com/Repository"
+  pattern: "projects/{project}/locations/{location}/connections/{connection}/repositories/{repository}"
+};
 option (google.api.resource_definition) = {
   type: "container.googleapis.com/Cluster"
   pattern: "projects/{project}/locations/{location}/clusters/{cluster}"
@@ -1606,7 +1610,7 @@ message SkaffoldModules {
     // Optional. Relative path from the repository root to the Skaffold file.
     string path = 2 [(google.api.field_behavior) = OPTIONAL];
 
-    // Optional. Git ref the package should be cloned from.
+    // Optional. Git branch or tag to use when cloning the repository.
     string ref = 3 [(google.api.field_behavior) = OPTIONAL];
   }
 
@@ -1621,6 +1625,26 @@ message SkaffoldModules {
     string path = 2 [(google.api.field_behavior) = OPTIONAL];
   }
 
+  // Cloud Build V2 Repository containing Skaffold Configs.
+  message SkaffoldGCBRepoSource {
+    // Required. Name of the Cloud Build V2 Repository.
+    // Format is
+    // projects/{project}/locations/{location}/connections/{connection}/repositories/{repository}.
+    string repository = 1 [
+      (google.api.field_behavior) = REQUIRED,
+      (google.api.resource_reference) = {
+        type: "cloudbuild.googleapis.com/Repository"
+      }
+    ];
+
+    // Optional. Relative path from the repository root to the Skaffold Config
+    // file.
+    string path = 2 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Branch or tag to use when cloning the repository.
+    string ref = 3 [(google.api.field_behavior) = OPTIONAL];
+  }
+
   // Optional. The Skaffold Config modules to use from the specified source.
   repeated string configs = 1 [(google.api.field_behavior) = OPTIONAL];
 
@@ -1631,6 +1655,9 @@ message SkaffoldModules {
 
     // Cloud Storage bucket containing the Skaffold Config modules.
     SkaffoldGCSSource google_cloud_storage = 3;
+
+    // Cloud Build V2 repository containing the Skaffold Config modules.
+    SkaffoldGCBRepoSource google_cloud_build_repo = 4;
   }
 }