Redo-OSDOCS-14786 [NETOBSERV] Add section for IPSec

[gwynnemonahan]

https://issues.redhat.com/browse/OSDOCS-14786 [NETOBSERV] Add section for IPsec

Version(s):
Merge to only the no-1.9 branch - no cherrypicks are required.
I will open one PR against main to incorporate all of the NetObserv content just before its GA.

Cherry-pick to OCP 4.12, 4.14, 4.16+

Issue:
https://issues.redhat.com/browse/OSDOCS-14786

Link to docs preview:

• IPsec: https://95159--ocpdocs-pr.netlify.app/openshift-enterprise/latest/observability/network_observability/observing-network-traffic.html#network-observability-working-with-ipsec_nw-observe-network-traffic

QE review:

• QE has approved this change.

Additional information:

Redo/copy of #93858 which I somehow messed up. So this is a copy of the Dev/QE approved PR, and making this copy revealed that the content in the following already merged PRs is no longer present in the no-1.9 branch:

• Update netobserv-reader to netobserv-loki-reader: OSDOCS-14861 [NETOBSERV] Update netobserv-reader to netobserv-loki-reader #94341
• Update callout <2>: OSDOCS-14850 [NETOBSERV] Update callout <2> #94334
• UDN: OSDOCS-14822 UDN NetObserv Content #94271
• NetObserv 1.9 CLI documentation updates: OSDOCS-13901 NetObserv 1.9 CLI documentation updates #93795
• Flowlogs flp flitering: OSDOCS-14601 [NETOBSERV-2053] Flowlogs Flp filtering #93270
• Context about mulit-flow filtering capability, updated yaml: OSDOCS-14366 Additional context about the multi-flow filtering capability, updated yaml #92375

The only new content is proc_working-with-ipsec.adoc, and this addition to observing-network-traffic.adoc for IPsec:

include::modules/proc_network-observability-working-with-ipsec.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources
*xref:../../networking/network_security/configuring-ipsec-ovn.adoc#configuring-ipsec-ovn[Configuring IPsec encryption]

//Traffic flows continued

The remaining files have been reviewed and merged as part of the PRs listed above. However, removing those files results in build failures as that content has vanished from the no-1.9 branch for reasons no one has been able to identify.

The previously reviewed and merged content is now part of this PR, and hopefully this will fix the no-1.9 branch and return it to its updated state with all NetObserv 1.9 content. And hopefully that will resolve existing open PRs against no-1.9 that now have these same previously merged PRs.

Copied from 93858:
API reference updates are being handled by #94756

First time doing NETOBSERV release, and did not realize API/CLI changes were automatically generated, and those updates to prod docs are generally handed separately and not in individual PRs where CLI/API changes may occur.

[ocpdocs-previewbot]

🤖 Fri Jun 27 15:48:09 - Prow CI generated the docs preview:

https://95159--ocpdocs-pr.netlify.app/openshift-enterprise/latest/observability/network_observability/configuring-operator.html
https://95159--ocpdocs-pr.netlify.app/openshift-enterprise/latest/observability/network_observability/flowcollector-api.html
https://95159--ocpdocs-pr.netlify.app/openshift-enterprise/latest/observability/network_observability/installing-operators.html
https://95159--ocpdocs-pr.netlify.app/openshift-enterprise/latest/observability/network_observability/netobserv_cli/netobserv-cli-reference.html
https://95159--ocpdocs-pr.netlify.app/openshift-enterprise/latest/observability/network_observability/observing-network-traffic.html

[gwynnemonahan]

/label peer-review-needed

[gabriel-rh]

/LGTM

Good work on very technical info - only a few trivial comments

[gwynnemonahan]

Here's hoping merging this PR puts all the files back in the no-1.9 branch, that a rebase of existing open PRs against no-1.9 works, and all returns to normal.

[gwynnemonahan]

/label merge-review-needed

[lahinson]

Just a few nits for your consideration. Let me know when you've reviewed the comments and made any changes, and I'll merge this.

[lahinson]

Not part of your changes here, but in the preview, I noticed some wonky formatting in this file:

[openshift-ci]

@gwynnemonahan: all tests passed!

Full PR test history. Your PR dashboard.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

[lahinson]

Thanks for incorporating my suggestions! Merging now :)