Init container support

Author: rjeberhard

docs/domains/Domain.json

@@ -457,6 +457,13 @@
             "$ref": "https://github.com/garethr/kubernetes-json-schema/blob/master/v1.9.0/_definitions.json#/definitions/io.k8s.api.core.v1.EnvVar"
           }
         },
+        "initContainers": {
+          "description": "Initialization containers",
+          "type": "array",
+          "items": {
+            "$ref": "https://github.com/garethr/kubernetes-json-schema/blob/master/v1.9.0/_definitions.json#/definitions/io.k8s.api.core.v1.Container"
+          }
+        },
         "nodeSelector": {
           "description": "Selector which must match a node\u0027s labels for the pod to be scheduled on that node.",
           "$ref": "#/definitions/Map"

docs/domains/Domain.md

@@ -102,6 +102,7 @@ ServerPod describes the configuration for a Kubernetes pod for a server.
 | annotations | Map | The annotations to be attached to generated resources. |
 | containerSecurityContext | [Security Context](k8s1.9.0.md#security-context) | Container-level security attributes. Will override any matching pod-level attributes. |
 | env | array of [Env Var](k8s1.9.0.md#env-var) | A list of environment variables to add to a server |
+| initContainers | array of [Container](k8s1.9.0.md#container) | Initialization containers |
 | labels | Map | The labels to be attached to generated resources. The label names must not start with 'weblogic.'. |
 | livenessProbe | [Probe Tuning](#probe-tuning) | Settings for the liveness probe associated with a server. |
 | nodeSelector | Map | Selector which must match a node's labels for the pod to be scheduled on that node. |

docs/domains/index.html

@@ -34,7 +34,7 @@
 <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="position:absolute;width:0;height:0">
   <defs>
     <symbol viewBox="0 0 20 20" id="unlocked">
-          <path d="M15.8 8H14V5.6C14 2.703 12.665 1 10 1 7.334 1 6 2.703 6 5.6V6h2v-.801C8 3.754 8.797 3 10 3c1.203 0 2 .754 2 2.199V8H4c-.553 0-1 .646-1 1.199V17c0 .549.428 1.139.951 1.307l1.197.387C5.672 18.861 6.55 19 7.1 19h5.8c.549 0 1.428-.139 1.951-.307l1.196-.387c.524-.167.953-.757.953-1.306V9.199C17 8.646 16.352 8 15.8 8z"></path>
+      <path d="M15.8 8H14V5.6C14 2.703 12.665 1 10 1 7.334 1 6 2.703 6 5.6V6h2v-.801C8 3.754 8.797 3 10 3c1.203 0 2 .754 2 2.199V8H4c-.553 0-1 .646-1 1.199V17c0 .549.428 1.139.951 1.307l1.197.387C5.672 18.861 6.55 19 7.1 19h5.8c.549 0 1.428-.139 1.951-.307l1.196-.387c.524-.167.953-.757.953-1.306V9.199C17 8.646 16.352 8 15.8 8z"></path>
     </symbol>
 
     <symbol viewBox="0 0 20 20" id="locked">
@@ -1377,6 +1377,13 @@
             "$ref": "https://github.com/garethr/kubernetes-json-schema/blob/master/v1.9.0/_definitions.json#/definitions/io.k8s.api.core.v1.EnvVar"
           }
         },
+        "initContainers": {
+          "description": "Initialization containers",
+          "type": "array",
+          "items": {
+            "$ref": "https://github.com/garethr/kubernetes-json-schema/blob/master/v1.9.0/_definitions.json#/definitions/io.k8s.api.core.v1.Container"
+          }
+        },
         "nodeSelector": {
           "description": "Selector which must match a node\u0027s labels for the pod to be scheduled on that node.",
           "$ref": "#/definitions/Map"
@@ -1474,4 +1481,4 @@
 </script>
 </body>
 
-</html>
+</html>

docs/domains/k8s1.9.0.md

@@ -67,6 +67,34 @@ EnvVar represents an environment variable present in a Container.
 | value | string | Variable references $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. Defaults to "". |
 | valueFrom | [Env Var Source](#env-var-source) | Source for the environment variable's value. Cannot be used if value is not empty. |
 
+### Container
+
+A single application container that you want to run within a pod.
+
+| Name | Type | Description |
+| --- | --- | --- |
+| args | array of string | Arguments to the entrypoint. The docker image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
+| command | array of string | Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
+| env | array of [Env Var](#env-var) | List of environment variables to set in the container. Cannot be updated. |
+| envFrom | array of [Env From Source](#env-from-source) | List of sources to populate environment variables in the container. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated. |
+| image | string | Docker image name. More info: https://kubernetes.io/docs/concepts/containers/images This field is optional to allow higher level config management to default or override container images in workload controllers like Deployments and StatefulSets. |
+| imagePullPolicy | string | Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images |
+| lifecycle | [Lifecycle](#lifecycle) | Actions that the management system should take in response to container lifecycle events. Cannot be updated. |
+| livenessProbe | [Probe](#probe) | Periodic probe of container liveness. Container will be restarted if the probe fails. Cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
+| name | string | Name of the container specified as a DNS_LABEL. Each container in a pod must have a unique name (DNS_LABEL). Cannot be updated. |
+| ports | array of [Container Port](#container-port) | List of ports to expose from the container. Exposing a port here gives the system additional information about the network connections a container uses, but is primarily informational. Not specifying a port here DOES NOT prevent that port from being exposed. Any port which is listening on the default "0.0.0.0" address inside a container will be accessible from the network. Cannot be updated. |
+| readinessProbe | [Probe](#probe) | Periodic probe of container service readiness. Container will be removed from service endpoints if the probe fails. Cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
+| resources | [Resource Requirements](#resource-requirements) | Compute Resources required by this container. Cannot be updated. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources |
+| securityContext | [Security Context](#security-context) | Security options the pod should run with. More info: https://kubernetes.io/docs/concepts/policy/security-context/ More info: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/ |
+| stdin | boolean | Whether this container should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the container will always result in EOF. Default is false. |
+| stdinOnce | boolean | Whether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If stdinOnce is set to true, stdin is opened on container start, is empty until the first client attaches to stdin, and then remains open and accepts data until the client disconnects, at which time stdin is closed and remains closed until the container is restarted. If this flag is false, a container processes that reads from stdin will never receive an EOF. Default is false |
+| terminationMessagePath | string | Optional: Path at which the file to which the container's termination message will be written is mounted into the container's filesystem. Message written is intended to be brief final status, such as an assertion failure message. Will be truncated by the node if greater than 4096 bytes. The total message length across all containers will be limited to 12kb. Defaults to /dev/termination-log. Cannot be updated. |
+| terminationMessagePolicy | string | Indicate how the termination message should be populated. File will use the contents of terminationMessagePath to populate the container status message on both success and failure. FallbackToLogsOnError will use the last chunk of container log output if the termination message file is empty and the container exited with an error. The log output is limited to 2048 bytes or 80 lines, whichever is smaller. Defaults to File. Cannot be updated. |
+| tty | boolean | Whether this container should allocate a TTY for itself, also requires 'stdin' to be true. Default is false. |
+| volumeDevices | array of [Volume Device](#volume-device) | volumeDevices is the list of block devices to be used by the container. This is an alpha feature and may change in the future. |
+| volumeMounts | array of [Volume Mount](#volume-mount) | Pod volumes to mount into the container's filesystem. Cannot be updated. |
+| workingDir | string | Container's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated. |
+
 ### 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.
@@ -165,6 +193,51 @@ Volume represents a named volume in a pod that may be accessed by any container
 | Name | Type | Description |
 | --- | --- | --- |
 
+### Env Var
+
+| Name | Type | Description |
+| --- | --- | --- |
+
+### Env From Source
+
+| Name | Type | Description |
+| --- | --- | --- |
+
+### Lifecycle
+
+| Name | Type | Description |
+| --- | --- | --- |
+
+### Probe
+
+| Name | Type | Description |
+| --- | --- | --- |
+
+### Container Port
+
+| Name | Type | Description |
+| --- | --- | --- |
+
+### Resource Requirements
+
+| Name | Type | Description |
+| --- | --- | --- |
+
+### Security Context
+
+| Name | Type | Description |
+| --- | --- | --- |
+
+### Volume Device
+
+| Name | Type | Description |
+| --- | --- | --- |
+
+### Volume Mount
+
+| Name | Type | Description |
+| --- | --- | --- |
+
 ### AWS Elastic Block Store Volume Source
 
 | Name | Type | Description |

model/src/main/java/oracle/kubernetes/weblogic/domain/ClusterConfigurator.java

@@ -1,9 +1,10 @@
-// Copyright 2018, Oracle Corporation and/or its affiliates.  All rights reserved.
+// Copyright 2018, 2019, Oracle Corporation and/or its affiliates.  All rights reserved.
 // Licensed under the Universal Permissive License v 1.0 as shown at
 // http://oss.oracle.com/licenses/upl.
 
 package oracle.kubernetes.weblogic.domain;
 
+import io.kubernetes.client.models.V1Container;
 import io.kubernetes.client.models.V1PodSecurityContext;
 import io.kubernetes.client.models.V1SecurityContext;
 
@@ -85,6 +86,8 @@ ClusterConfigurator withLivenessProbeSettings(
 
   ClusterConfigurator withAdditionalVolumeMount(String name, String path);
 
+  ClusterConfigurator withInitContainer(V1Container initContainer);
+
   ClusterConfigurator withPodLabel(String name, String value);
 
   ClusterConfigurator withPodAnnotation(String name, String value);

model/src/main/java/oracle/kubernetes/weblogic/domain/DomainConfigurator.java

@@ -1,9 +1,10 @@
-// Copyright 2018, Oracle Corporation and/or its affiliates.  All rights reserved.
+// Copyright 2018, 2019, Oracle Corporation and/or its affiliates.  All rights reserved.
 // Licensed under the Universal Permissive License v 1.0 as shown at
 // http://oss.oracle.com/licenses/upl.
 
 package oracle.kubernetes.weblogic.domain;
 
+import io.kubernetes.client.models.V1Container;
 import io.kubernetes.client.models.V1LocalObjectReference;
 import io.kubernetes.client.models.V1ObjectMeta;
 import io.kubernetes.client.models.V1PodSecurityContext;
@@ -200,6 +201,8 @@ protected DomainSpec getDomainSpec() {
 
   public abstract DomainConfigurator withAdditionalVolumeMount(String name, String path);
 
+  public abstract DomainConfigurator withInitContainer(V1Container initContainer);
+
   public abstract DomainConfigurator withPodLabel(String name, String value);
 
   public abstract DomainConfigurator withPodAnnotation(String name, String value);

model/src/main/java/oracle/kubernetes/weblogic/domain/ServerConfigurator.java

@@ -1,9 +1,10 @@
-// Copyright 2018, Oracle Corporation and/or its affiliates.  All rights reserved.
+// Copyright 2018, 2019, Oracle Corporation and/or its affiliates.  All rights reserved.
 // Licensed under the Universal Permissive License v 1.0 as shown at
 // http://oss.oracle.com/licenses/upl.
 
 package oracle.kubernetes.weblogic.domain;
 
+import io.kubernetes.client.models.V1Container;
 import io.kubernetes.client.models.V1PodSecurityContext;
 import io.kubernetes.client.models.V1SecurityContext;
 
@@ -81,6 +82,8 @@ ServerConfigurator withReadinessProbeSettings(
 
   ServerConfigurator withAdditionalVolumeMount(String name, String path);
 
+  ServerConfigurator withInitContainer(V1Container initContainer);
+
   ServerConfigurator withPodLabel(String name, String value);
 
   ServerConfigurator withPodAnnotation(String name, String value);

model/src/main/java/oracle/kubernetes/weblogic/domain/model/BaseConfiguration.java

@@ -6,6 +6,7 @@
 
 import com.google.gson.annotations.Expose;
 import com.google.gson.annotations.SerializedName;
+import io.kubernetes.client.models.V1Container;
 import io.kubernetes.client.models.V1EnvVar;
 import io.kubernetes.client.models.V1PodSecurityContext;
 import io.kubernetes.client.models.V1ResourceRequirements;
@@ -200,6 +201,10 @@ void addAdditionalVolumeMount(String name, String path) {
     serverPod.addAdditionalVolumeMount(name, path);
   }
 
+  void addInitContainer(V1Container initContainer) {
+    serverPod.addInitContainer(initContainer);
+  }
+
   Map<String, String> getPodLabels() {
     return serverPod.getLabels();
   }
@@ -236,6 +241,10 @@ public Map<String, String> getServiceAnnotations() {
     return serverService.getAnnotations();
   }
 
+  public List<V1Container> getInitContainers() {
+    return serverPod.getInitContainers();
+  }
+
   void addServiceAnnotation(String name, String value) {
     serverService.addAnnotations(name, value);
   }

model/src/main/java/oracle/kubernetes/weblogic/domain/model/ClusterSpec.java

@@ -4,6 +4,9 @@
 
 package oracle.kubernetes.weblogic.domain.model;
 
+import io.kubernetes.client.models.V1Container;
+import java.util.Collections;
+import java.util.List;
 import java.util.Map;
 import javax.annotation.Nonnull;
 
@@ -39,4 +42,14 @@ public abstract class ClusterSpec {
    */
   @Nonnull
   public abstract Map<String, String> getClusterAnnotations();
+
+  /**
+   * Returns the list of initContainers.
+   *
+   * @return a list of containers
+   */
+  @Nonnull
+  public List<V1Container> getInitContainers() {
+    return Collections.emptyList();
+  }
 }

model/src/main/java/oracle/kubernetes/weblogic/domain/model/ClusterSpecCommonImpl.java

@@ -4,6 +4,8 @@
 
 package oracle.kubernetes.weblogic.domain.model;
 
+import io.kubernetes.client.models.V1Container;
+import java.util.List;
 import java.util.Map;
 
 public class ClusterSpecCommonImpl extends ClusterSpec {
@@ -37,4 +39,9 @@ public Map<String, String> getClusterLabels() {
   public Map<String, String> getClusterAnnotations() {
     return cluster.getClusterAnnotations();
   }
+
+  @Override
+  public List<V1Container> getInitContainers() {
+    return cluster.getInitContainers();
+  }
 }