Skip to content

Documentation and samples updates for 2.4.0 #1331

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 15 commits into from
Nov 16, 2019
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs-source/content/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 %}}
Expand Down
2 changes: 1 addition & 1 deletion docs-source/content/quickstart/get-images.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
2 changes: 1 addition & 1 deletion docs-source/content/quickstart/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs-source/content/userguide/introduction/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -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" >}}).
Expand Down
22 changes: 11 additions & 11 deletions docs-source/content/userguide/introduction/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ 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

Expand All @@ -38,20 +38,20 @@ 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.
[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.

Expand All @@ -69,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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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:
```
Expand Down Expand Up @@ -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.