OSDOCS-12099#Add CLI cmd for PVC usage

[lpettyjo]

Version(s): 4.19+

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

Link to docs preview: https://90971--ocpdocs-pr.netlify.app/openshift-enterprise/latest/storage/understanding-persistent-storage.html#pvc-cli-command-usage_understanding-persistent-storage

QE review:

• QE has approved this change.

Additional information:

PTAL: @dobsonj @tsmetana @gcharot @ropatil010

[ocpdocs-previewbot]

🤖 Tue May 06 20:15:38 - Prow CI generated the docs preview:

https://90971--ocpdocs-pr.netlify.app/microshift/latest/microshift_storage/understanding-persistent-storage-microshift.html
https://90971--ocpdocs-pr.netlify.app/openshift-dedicated/latest/storage/understanding-persistent-storage.html
https://90971--ocpdocs-pr.netlify.app/openshift-enterprise/latest/storage/understanding-persistent-storage.html
https://90971--ocpdocs-pr.netlify.app/openshift-rosa-hcp/latest/storage/understanding-persistent-storage.html
https://90971--ocpdocs-pr.netlify.app/openshift-rosa/latest/storage/understanding-persistent-storage.html

[gcharot]

LGTM but i would prefer to avoid showing internal namespace references such as clusters-hypershift-ci-339424
Can we replace them with fake names?
thx !

[lahinson]

Looks good! Just one nit and a couple of comments for your consideration.

[gcharot]

LGTM thanks!

[ropatil010]

Should we need to add the execution steps for kubeadmin/normal user privilages which is mentioned in doc: https://docs.google.com/document/d/1QAWt6ZEnUbWJ66-nycyhivNij5Md656nONXdvPhYPKs/edit?disco=AAABgFGCobw
Without those steps it does not work.
cc: @gcharot @tsmetana @dobsonj

[gcharot]

is it specific to ROSA ? if so maybe it can be added to the rosa doc and linked from here?

[ropatil010]

is it specific to ROSA ? if so maybe it can be added to the rosa doc and linked from here?

Hi Gregory,
#90971 (comment)

The execution steps mentioned under limitations 1 and 2 in doc is on all OCP/ROSA clusters.
3rd limitation is specific to rosa-hcp-external-auth profile. Agree we can mention this on ROSA doc.

[dobsonj]

Should we need to add the execution steps for kubeadmin/normal user privilages which is mentioned in doc: https://docs.google.com/document/d/1QAWt6ZEnUbWJ66-nycyhivNij5Md656nONXdvPhYPKs/edit?disco=AAABgFGCobw Without those steps it does not work. cc: @gcharot @tsmetana @dobsonj

Agreed, it would be helpful to include these steps. Setting KUBECONFIG is not enough, you have to be logged in either as admin or as a user with an appropriate clusterrole.

[lpettyjo]

Should we need to add the execution steps for kubeadmin/normal user privilages which is mentioned in doc: https://docs.google.com/document/d/1QAWt6ZEnUbWJ66-nycyhivNij5Md656nONXdvPhYPKs/edit?disco=AAABgFGCobw Without those steps it does not work. cc: @gcharot @tsmetana @dobsonj

Agreed, it would be helpful to include these steps. Setting KUBECONFIG is not enough, you have to be logged in either as admin or as a user with an appropriate clusterrole.

I think I have this documented now. PTAL @dobsonj @tsmetana @gcharot @ropatil010

[openshift-ci]

@lpettyjo: all tests passed!

Full PR test history. Your PR dashboard.

Details

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.

[dobsonj]

LGTM!

[ropatil010]

LGTM, Thanks.
The limitation story is resolved. Mentioned the same in doc: https://docs.google.com/document/d/1QAWt6ZEnUbWJ66-nycyhivNij5Md656nONXdvPhYPKs/edit?disco=AAABgFGCobw

[tsmetana]

/lgtm

[lpettyjo]

/cherrypick enterprise-4.19

[openshift-cherrypick-robot]

@lpettyjo: new pull request created: #93183

Details

In response to this:

/cherrypick enterprise-4.19

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.