feat: Implementation of Build Failure Info: - Added message FailureInfo field (#255)

PiperOrigin-RevId: 385847244

Source-Link: googleapis/googleapis@f84d1e2

Source-Link: googleapis/googleapis-gen@ff9cf56

Author: gcf-owl-bot[bot]

packages/google-devtools-cloudbuild/protos/google/devtools/cloudbuild/v1/cloudbuild.proto

@@ -681,6 +681,40 @@ message Build {
     Priority priority = 2;
   }
 
+  // A fatal problem encountered during the execution of the build.
+  message FailureInfo {
+    // The name of a fatal problem encountered during the execution of the
+    // build.
+    enum FailureType {
+      // Type unspecified
+      FAILURE_TYPE_UNSPECIFIED = 0;
+
+      // Unable to push the image to the repository.
+      PUSH_FAILED = 1;
+
+      // Final image not found.
+      PUSH_IMAGE_NOT_FOUND = 2;
+
+      // Unauthorized push of the final image.
+      PUSH_NOT_AUTHORIZED = 3;
+
+      // Backend logging failures. Should retry.
+      LOGGING_FAILURE = 4;
+
+      // A build step has failed.
+      USER_BUILD_STEP = 5;
+
+      // The source fetching has failed.
+      FETCH_SOURCE_FAILED = 6;
+    }
+
+    // The name of the failure.
+    FailureType type = 1;
+
+    // Explains the failure issue in more detail using hard-coded text.
+    string detail = 2;
+  }
+
   // Possible status of a build or build step.
   enum Status {
     // Status of the build is unknown.
@@ -842,6 +876,9 @@ message Build {
   // Output only. Non-fatal problems encountered during the execution of the
   // build.
   repeated Warning warnings = 49 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Contains information about the build when status=FAILURE.
+  FailureInfo failure_info = 51 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Artifacts produced by a build that should be uploaded upon