More detailed error message for DeadlineExceededException

Author: alai8

operator/src/main/java/oracle/kubernetes/operator/JobWatcher.java

@@ -256,7 +256,7 @@ public NextAction apply(Packet packet) {
                     // be available for reading
                     if (isJobFailed && "DeadlineExceeded".equals(getFailedReason(job))) {
                       fiber.terminate(
-                          new DeadlineExceededException(job.getMetadata().getName()), packet);
+                          new DeadlineExceededException(job), packet);
                     }
                     fiber.resume(packet);
                   }
@@ -304,15 +304,37 @@ public NextAction onSuccess(
   }
 
   static class DeadlineExceededException extends Exception {
-    final String job;
+    final V1Job job;
 
-    public DeadlineExceededException(String job) {
+    public DeadlineExceededException(V1Job job) {
       super();
       this.job = job;
     }
 
     public String toString() {
-      return "Job " + job + " failed. Reason: DeadlineExceeded";
+      StringBuilder sb = new StringBuilder("Job ")
+          .append(job.getMetadata().getName()).append(" failed due to reason: DeadlineExceeded.")
+          .append(" ActiveDeadlineSeconds of the job is configured with "
+              + job.getSpec().getActiveDeadlineSeconds()
+              + " seconds.")
+          .append(getJobStartedSecondsMessage())
+          .append(" Ensure all domain dependencies have been deployed")
+          .append(" (any secrets, config-maps, PVs, and PVCs that the domain resource references).")
+          .append(" Use kubectl describe the job and its pod for more job failure information.")
+          .append(" The job may be retried by the operator up to "
+              + DomainPresence.getDomainPresenceFailureRetryMaxCount()
+              + " times with longer ActiveDeadlineSeconds value in each subsequent retry.")
+          .append(" Use tuning parameter \"domainPresenceFailureRetryMaxCount\" to configure max retries.");
+      return sb.toString();
+    }
+
+    private String getJobStartedSecondsMessage() {
+      if (job.getStatus() != null && job.getStatus().getStartTime() != null) {
+        return " The job was started "
+            + ((System.currentTimeMillis() - job.getStatus().getStartTime().getMillis()) / 1000)
+            + " seconds ago.";
+      }
+      return null;
     }
   }
 }