Bug 1929230 - be clearer about "multitenant isolation" vs "multitenant mode"
Summary: be clearer about "multitenant isolation" vs "multitenant mode"
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 4.8
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: ---
Assignee: Jason Boxman
QA Contact: Xiaoli Tian
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2021-02-16 14:15 UTC by Dan Winship
Modified: 2021-04-07 15:47 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2021-04-07 15:47:20 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Dan Winship 2021-02-16 14:15:53 UTC
Document URL: https://docs.openshift.com/container-platform/4.6/networking/network_policy/multitenant-network-policy.html

Section Number and Name: (title)

Describe the issue: 

"Multitenant mode" refers to a specific way of configuring OpenShift SDN such that it isolates all namespaces from each other automatically and does not support NetworkPolicy.

The linked page is currently titled "Configuring multitenant mode with network policy", but it is NOT about using Multitenant mode, it's about how to get behavior similar to Multitenant mode when using NetworkPolicy mode.

This is a problem because now sometimes customers say things like "I am using multitenant mode and I want to do X", and we tell them "you can't do that in multitenant mode, sorry", and then later it turns out that they were not actually using Multitenant mode, they were using NetworkPolicy mode and following the instructions on this page, and so they *can* do what they wanted.

Suggestions for improvement: 

The words "multitenant mode" should only be used to refer to clusters with `mode: Multitenant`. The linked page should be called something like "Configuring multitenant isolation with network policy".

Additional information:

Comment 1 Jason Boxman 2021-03-16 04:38:07 UTC
I've created a draft PR[0] to clarify this and avoid any confusion.

[0] https://github.com/openshift/openshift-docs/pull/30507


Note You need to log in before you can comment on or make changes to this bug.