Merge branch 'readiness-get-action' into 'main'

Support customization of readiness probe get action

See merge request weblogic-cloud/weblogic-kubernetes-operator!4654

(cherry picked from commit 7a76a1b)

c0658b2 Support customization of readiness probe get action
68c9bc6 Update solution to use full standard probe schema
2d20af9 Correct JSON documentation references
2ccb976 Use builder to prevent modifying original

Author: rjeberhard

documentation/domains/Cluster.json

@@ -109,6 +109,21 @@ HostAlias holds the mapping between IP and hostnames that will be injected as an
 | `hostnames` | Array of string | Hostnames for the above IP address. |
 | `ip` | string | IP address of the host file entry. |
 
+### Probe
+
+Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `exec` | [Exec Action](#exec-action) | One and only one of the following should be specified. Exec specifies the action to take. |
+| `failureThreshold` | integer | Minimum consecutive failures for the probe to be considered failed after having succeeded. Defaults to 3. Minimum value is 1. |
+| `httpGet` | [HTTP Get Action](#http-get-action) | HTTPGet specifies the http request to perform. |
+| `initialDelaySeconds` | integer | Number of seconds after the container has started before liveness probes are initiated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
+| `periodSeconds` | integer | How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. |
+| `successThreshold` | integer | Minimum consecutive successes for the probe to be considered successful after having failed. Defaults to 1. Must be 1 for liveness. Minimum value is 1. |
+| `tcpSocket` | [TCP Socket Action](#tcp-socket-action) | TCPSocket specifies an action involving a TCP port. TCP hooks not yet supported |
+| `timeoutSeconds` | integer | Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
+
 ### Pod Security Context
 
 PodSecurityContext holds pod-level security attributes and common container settings. Some fields are also present in container.securityContext.  Field values of container.securityContext take precedence over field values of PodSecurityContext.
@@ -308,6 +323,21 @@ A label selector is a label query over a set of resources. The result of matchLa
 | Name | Type | Description |
 | --- | --- | --- |
 
+### Exec Action
+
+| Name | Type | Description |
+| --- | --- | --- |
+
+### HTTP Get Action
+
+| Name | Type | Description |
+| --- | --- | --- |
+
+### TCP Socket Action
+
+| Name | Type | Description |
+| --- | --- | --- |
+
 ### Sysctl
 
 | Name | Type | Description |

documentation/domains/Cluster.md

@@ -1,4 +1,4 @@
-// Copyright (c) 2019, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2019, 2024, Oracle and/or its affiliates.
 // Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
 
 package oracle.kubernetes.json;
@@ -10,7 +10,7 @@
 
 public class KubernetesSchemaReference {
   private static final String K8S_SCHEMA_URL =
-      "https://github.com/garethr/kubernetes-json-schema/blob/master/v%s/_definitions.json";
+      "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/v%s/_definitions.json";
   private static final String K8S_SCHEMA_CACHE = "caches/kubernetes-%s.json";
   private static final String K8S_MARKDOWN_LINK = "k8s%s.md";
 

documentation/domains/Domain.json

@@ -1,4 +1,4 @@
-// Copyright (c) 2018, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2018, 2024, Oracle and/or its affiliates.
 // Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
 
 package oracle.kubernetes.json;
@@ -27,7 +27,7 @@
 class SchemaGeneratorTest {
 
   private static final String K8S_SCHEMA_URL =
-      "https://github.com/garethr/kubernetes-json-schema/blob/master/v1.9.0/_definitions.json";
+      "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/v1.9.0/_definitions.json";
   private static final String K8S_CACHE_FILE = "caches/kubernetes-1.9.0.json";
   private final SchemaGenerator generator = new SchemaGenerator();
 

documentation/domains/Domain.md

@@ -1,4 +1,4 @@
-// Copyright (c) 2019, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2019, 2024, Oracle and/or its affiliates.
 // Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
 
 package oracle.kubernetes.json;
@@ -20,7 +20,7 @@
 import static org.hamcrest.junit.MatcherAssert.assertThat;
 
 class YamlDocGeneratorTest {
-  private static final String K8S_VERSION = "1.13.5";
+  private static final String K8S_VERSION = "1.28.2";
   private final SchemaGenerator schemaGenerator = new SchemaGenerator();
   @SuppressWarnings("unused")
   @Description("An annotated field")