Documentation and samples updates for 2.4.0 (#1331)

* update prereqs

* [enel] update pv sample to fix pv fs owner

* archive static docs from 2.3.0

* archive 2.3.0 docs

* update javadoc and domains swagger

* update operator swagger docs

* archive site docs

* fix archived 2.3.0 docs to have the 'old' message on it

* update release notes

* fix create domain job template - had too many volumes sections

* update docs for 2.4.0

* fx javadocs

* add chart

* resolve merge conflicts

Author: markxnelson

docs-source/content/_index.md

@@ -17,8 +17,8 @@ Oracle is finding ways for organizations using WebLogic Server to run important
 The fastest way to experience the operator is to follow the [Quick Start guide]({{< relref "/quickstart/_index.md" >}}), or you can peruse our [documentation]({{< relref "/userguide/_index.md" >}}), read our [blogs](https://blogs.oracle.com/weblogicserver/how-to-weblogic-server-on-kubernetes), or try out the [samples]({{< relref "/samples/_index.md" >}}).
 
 ***
-The [current release of the operator](https://github.com/oracle/weblogic-kubernetes-operator/releases) is 2.3.0.
-This release was published on August 27th, 2019.
+The [current release of the operator](https://github.com/oracle/weblogic-kubernetes-operator/releases) is 2.4.0.
+This release was published on November 15th, 2019.
 ***
 
 {{% notice note %}}

docs-source/content/quickstart/get-images.md

@@ -19,7 +19,7 @@ and accept the license agreement for the [WebLogic Server image](https://hub.doc
 1. Pull the operator image:
 
     ```bash
-    $ docker pull oracle/weblogic-kubernetes-operator:2.3.0
+    $ docker pull oracle/weblogic-kubernetes-operator:2.4.0
     ```
 
 1. Pull the Traefik load balancer image:

docs-source/content/quickstart/install.md

@@ -57,7 +57,7 @@ $ helm install stable/traefik \
     $ helm install kubernetes/charts/weblogic-operator \
       --name sample-weblogic-operator \
       --namespace sample-weblogic-operator-ns \
-      --set image=oracle/weblogic-kubernetes-operator:2.3.0 \
+      --set image=oracle/weblogic-kubernetes-operator:2.4.0 \
       --set serviceAccount=sample-weblogic-operator-sa \
       --set "domainNamespaces={}" \
       --wait

docs-source/content/release-notes.md

@@ -8,6 +8,7 @@ draft: false
 
 | Date | Version | Introduces backward incompatibilities | Change |
 | --- | --- | --- | --- |
+| November 15, 2019 | v2.4.0 | no | Includes fixes for a variety of issues related to FMW infrastructure domains and pod variable substitution.  Operator now uses WebLogic Deploy Tooling 1.6.0 and the latest version of the Kubernetes Java Client. 
 | August 27, 2019 | v2.3.0 | no  | Added support for Coherence cluster rolling, pod templating and additional pod content, and experimental support for running under an Istio service mesh.
 | June 20, 2019 | v2.2.1 | no  | The operator now supports Kubernetes 1.14.0+.  This release is primarily a bug fix release and resolves the following issues:<br><ul><li>Servers in domains, where the domain home is on a persistent volume, would sometimes fail to start. These failures would be during the introspection phase following a full domain shutdown.  Now, the introspection script better handles the relevant error conditions.</li><li>The domain resource provides an option to <a href="https://github.com/oracle/weblogic-kubernetes-operator/blob/master/docs/domains/Domain.md#server-service">pre-create Kubernetes services</a> for WebLogic Servers that are not yet running so that the DNS addresses of these services are resolvable.  These services are now created as non-headless so that they have an IP address.</li></ul>
 | June 6, 2019 | v2.2.0 | no  | Added support for FMW Infrastructure domains. WebLogic Server instances are now gracefully shut down by default and shutdown options are configurable. Operator is now built and runs on JDK 11.

docs-source/content/samples/simple/domains/domain-home-on-pv/_index.md

@@ -20,6 +20,28 @@ The following prerequisites must be handled prior to running the create domain s
 * In the same Kubernetes namespace, create the Kubernetes persistent volume (PV) where the domain home will be hosted, and the Kubernetes persistent volume claim (PVC) for the domain. For samples to create a PV and PVC, see [Create sample PV and PVC]({{< relref "/samples/simple/storage/_index.md" >}}). By default, the `create-domain.sh` script creates a domain with the `domainUID` set to `domain1` and expects the PVC `domain1-weblogic-sample-pvc` to be present. You can create `domain1-weblogic-sample-pvc` using [create-pv-pvc.sh](https://github.com/oracle/weblogic-kubernetes-operator/blob/master/kubernetes/samples/scripts/create-weblogic-domain-pv-pvc/create-pv-pvc.sh) with an inputs file that has the `domainUID` set to `domain1`.
 * Create the Kubernetes secrets `username` and `password` of the administrative account in the same Kubernetes namespace as the domain.
 
+{{% notice note %}}
+Please note the following important considerations about using persistent storage.
+{{% /notice %}}
+
+There are a number of different Kubernetes storage providers that can be used to create persistent
+volumes.  Depending on which variant and version of Kubernetes you are using, there will be different
+steps required to create persistent volumes.  You must use a storage provider that suppports
+the `ReadWriteMany` option.
+
+Many storage providers will create a file system on
+the persistent volume which is owned by the `root` user.  In those cases, you will need to update the
+file permissions and/or ownership so that the `oracle` user (`uid 1000`) that is used in the standard
+WebLogic Server Docker images can write to the file system in the persistent volume.
+ 
+This sample will automatically set the owner of all files on the persistent
+volume to `uid 1000`.  If you want to change that behavior, please edit `kubernetes/samples/scripts/create-weblogic-domain/domain-home-on-pv/create-domain-job-template.yaml` and edit or remove the
+`initContainer` section.
+ 
+In some variants of Kubernetes (for example OpenShift) you may also need to configure your pods
+to run with user 1000 to make sure that the WebLogic processes can access the file system on the
+persistent volume.
+
 #### Use the script to create a domain
 
 Make a copy of the `create-domain-inputs.yaml` file, and run the create script, pointing it at your inputs file and an output directory:

docs-source/content/userguide/introduction/architecture.md

@@ -18,7 +18,7 @@ The operator is packaged in a [Docker image](https://hub.docker.com/r/oracle/web
 
 ```
 $ docker login
-$ docker pull oracle/weblogic-kubernetes-operator:2.3.0
+$ docker pull oracle/weblogic-kubernetes-operator:2.4.0
 ```
 
 For more details on acquiring the operator image and prerequisites for installing the operator, consult the [Quick Start guide]({{< relref "/quickstart/_index.md" >}}).

docs-source/content/userguide/introduction/introduction.md

@@ -16,7 +16,7 @@ Detailed instructions are available [here]({{< relref "/userguide/managing-opera
 
 ### Operator prerequisites
 
-* Kubernetes 1.11.5+, 1.12.3+, 1.13.0+, and 1.14.0+  (check with `kubectl version`).
+* Kubernetes 1.11.5+, 1.12.3+, 1.13.0+, 1.14.0+, and 1.15.0+  (check with `kubectl version`).
 * Flannel networking v0.9.1-amd64 (check with `docker images | grep flannel`).
 * Docker 18.9.1 (check with `docker version`) *or* CRI-O 1.14.7 (check with `crictl version | grep RuntimeVersion`).
 * Helm 2.14.3+ (check with `helm version`).
@@ -26,21 +26,35 @@ Detailed instructions are available [here]({{< relref "/userguide/managing-opera
    * Check the WLS version with `docker run container-registry.oracle.com/middleware/weblogic:12.2.1.3 sh -c` `'source $ORACLE_HOME/wlserver/server/bin/setWLSEnv.sh > /dev/null 2>&1 && java weblogic.version'`.
    * Check the WLS patches with `docker run container-registry.oracle.com/middleware/weblogic:12.2.1.3 sh -c` `'$ORACLE_HOME/OPatch/opatch lspatches'`.
 * You must have the `cluster-admin` role to install the operator.
-* We do not currently support running WebLogic in non-Linux containers. 
+* We do not currently support running WebLogic in non-Linux containers.
+
+### Important note about Kubernetes 1.16
+
+Kubernetes 1.16 introduced changes to some Kubernetes APIs that are used by the operator.
+At this time, the operator is not guaranteed to work on Kubernetes 1.16.
+When we have completed testing and made any necessary code changes, we will update this
+page to confirm support of 1.16.
 
 ### Cloud providers
 
 The Oracle [Global Pricing and Licensing site](https://www.oracle.com/corporate/pricing/specialty-topics.html)
-provides details about licensing practices and policies. 
+provides details about licensing practices and policies.
 WebLogic Server and the operator are supported on "Authorized Cloud Environments" as defined in
-[this Oracle licensing policy](https://www.oracle.com/assets/cloud-licensing-070579.pdf) and 
+[this Oracle licensing policy](https://www.oracle.com/assets/cloud-licensing-070579.pdf) and
 [this list of eligible products](http://www.oracle.com/us/corporate/pricing/authorized-cloud-environments-3493562.pdf).
 
 The official document that defines the [supported configurations is here](https://www.oracle.com/middleware/technologies/ias/oracleas-supported-virtualization.html).
 
 In accordance with these policies, the operator and WebLogic Server are supported on Oracle Cloud
 Infrastructure using *Oracle Container Engine for Kubernetes*, or in a cluster running *Oracle Linux
-Container Servies for use with Kubernetes* on OCI Compute; and on "authorized cloud environments".
+Container Services for use with Kubernetes* on OCI Compute, and on "authorized cloud environments".
+
+### Oracle Linux Cloud Native Environment
+
+[Oracle Linux Cloud Native Environment](https://docs.oracle.com/en/operating-systems/olcne/) is a fully integrated suite for the development and management of cloud-native applications. Based on the Open Container Initiative (OCI) and Cloud Native Computing Foundation (CNCF) standards, Oracle Linux Cloud Native Environment delivers a simplified framework for installations, updates, upgrades, and configuration of key features for orchestrating microservices.
+
+WebLogic Server and the WebLogic Kubernetes operator are certified and supported on Oracle Linux Cloud Native Environment.
+
 
 ### OpenShift
 
@@ -55,16 +69,16 @@ There are a number of development-focused distributions of Kubernetes, like kind
 Often these run Kubernetes in a virtual machine on your development machine.  We have found that these distributions
 present some extra challenges in areas like:
 
-* Separate Docker image stores, making it necessary to save/load images to move them between Docker file systems,
-* Default virtual machine file sizes and resource limits that are too small to run WebLogic or hold the necessary images,
-* Storage providers that do not always support the features that the operator and/or WebLogic rely on, 
-* Load balancing implementations that do not always support the features that the operator and/or WebLogic rely on.
+* Separate Docker image stores, making it necessary to save/load images to move them between Docker file systems
+* Default virtual machine file sizes and resource limits that are too small to run WebLogic or hold the necessary images
+* Storage providers that do not always support the features that the operator and/or WebLogic rely on
+* Load balancing implementations that do not always support the features that the operator and/or WebLogic rely on
 
-As such, we *do not* recommend using these distributions to run the operator and/or WebLogic, and we do not 
+As such, we *do not* recommend using these distributions to run the operator and/or WebLogic, and we do not
 provide support for WebLogic or the operator running in these distributions.
 
 We have found that Docker for Desktop does not seem to suffer the same limitations, and we do support that as a
-dev/test option. 
+development/test option.
 
 ### Operator Docker image
 

docs-source/content/userguide/managing-domains/domain-lifecycle/restarting.md

@@ -161,7 +161,7 @@ d. Update the `image` property of the domain resource specifying the new image n
      ```
         domain:
               spec:
-                   image: oracle/weblogic-updated:2.3.0
+                   image: oracle/weblogic-updated:2.4.0
      ```
 e. The operator will now initiate a rolling restart, which will apply the updated image, for all the server pods in the domain.
 

docs-source/content/userguide/managing-operators/using-the-operator/using-helm.md

@@ -111,7 +111,7 @@ javaLoggingLevel:  "FINE"
 
 Specifies the Docker image containing the operator code.
 
-Defaults to `weblogic-kubernetes-operator:2.3.0`.
+Defaults to `weblogic-kubernetes-operator:2.4.0`.
 
 Example:
 ```
@@ -488,6 +488,3 @@ To recover:
 If you create a new domain in a namespace that is deleted and recreated, the domain does not start up until you notify the operator.
 
 Refer to [Domain Namespace Management] ({{<relref "/faq/namespace-management.md">}}) for more information about the problem and solutions.
-
-
-

docs-source/themes/hugo-theme-learn/layouts/partials/menu-footer.html

@@ -1,6 +1,9 @@
 <p>Created with <i class="fas fa-heart"></i> from <a href="https://www.oracle.com">Oracle</a></p>
 <p>&nbsp;</p>
+<p>You are viewing the archived documentation for version 2.3.0. To view the documentation for the current release, please 
+[click here](https://oracle.github.io/weblogic-kubernetes-operator)</p>
+<p>&nbsp;</p>
 <p><a href="https://github.com/oracle/weblogic-kubernetes-operator"><i class="fab fa-github"></i> GitHub repo</a></p>
 <p><a href="https://weblogic-slack-inviter.herokuapp.com/"><i class="fab fa-slack"></i> Public Slack #operator</a></p>
 <p>&nbsp;</p>
-<img src="http://build.weblogick8s.org:8080/buildStatus/icon?job=weblogic-kubernetes-operator">
+<img src="http://build.weblogick8s.org:8080/buildStatus/icon?job=weblogic-kubernetes-operator">