Skip to content
Merged
Show file tree
Hide file tree
Changes from 4 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
33 changes: 33 additions & 0 deletions documentation/staging/content/userguide/istio/istio.md
Original file line number Diff line number Diff line change
Expand Up @@ -142,6 +142,39 @@ If the WebLogic administration port is enabled on the Administration Server:
Additionally, when Istio support is enabled for a domain, the operator
ensures that the Istio sidecar is not injected into the introspector job's pods.

#### Support for network changes in Istio v1.10 and later

Prior to Istio release 1.10, the Istio Envoy proxy redirected all inbound traffic to the localhost
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think the "prior to" paragraph is necessary and you can just begin with "Starting with Istio 1.10". Also, let's link to that article describing the change.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see that you did link the article later. Move the link up here :)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changed. Moved the link up.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also, removed the text describing the previous Istio network behavior.

network interface. The network channels listed above, which the operator automatically added,
were bound to the localhost interface in order for WebLogic to receive the inbound traffic.
Starting with Istio 1.10, the networking behavior was changed in that the proxy no longer redirects
the traffic to the localhost interface, but instead forwards it to the network interface associated
to the pod's IP. In order to support Istio v1.10 and later, as well as pre-1.10 releases, the
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"pre-1.10 releases" -> "previous releases"

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changed.

operator will:

* Add an additional WebLogic HTTP protocol network channel for the readiness probe that is bound to the localhost network interface.
* Add additional WebLogic network channels, bound to the localhost network interface, for each defined custom network channel.
* Continue to automatically add the network channels described above in [How Istio-enabled domains differ from regular domains](#how-istio-enabled-domains-differ-from-regular-domains)

When adding additional WebLogic network channels for the readiness probe and any defined custom channels,
the name of the additional channel will be appended with '-lhNN', where NN represents
a two digit value for uniqueness.

For example, the additional WebLogic HTTP protocol network channel for the readiness probe would be
defined as follows:

|Name|Port|Listening address|Protocol|Exposed as a container port|
|----|----|----|--------|-----|
|`http-probe-lh01`|From configuration Istio `readinessPort` | `127.0.0.1` | `http`| No |

As another example, for a custom WebLogic network channel defined as `T3Channel` with port `5556`
and protocol `t3`, the additional channel would be defined as follows:

|Name|Port|Listening address|Protocol|Exposed as a container port|
|----|----|----|--------|-----|
|`T3Channel-lh01`| `5556` | `127.0.0.1` | `t3`| Yes |

To learn more about changes to Istio networking beginning with Istio 1.10, see [Upcoming networking changes in Istio 1.10](https://istio.io/latest/blog/2021/upcoming-networking-changes//).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does the user need to do anything if upgrading istio from 1.9 to 1.10 or higher, does he/she needs to re-run the introspector by updating the introspectVersion or something else?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a very good question. With this change, we can support all versions of Istio and so I don't believe re-running introspection would make much difference or is necessary. Do we have a documented process for upgrading Istio in a cluster? That is, do we recommend shutting down the domain before upgrading Istio or can you upgrade Istio while a domain is running?


### Apply the Domain YAML file

Expand Down
Loading