-
Notifications
You must be signed in to change notification settings - Fork 1.9k
OADP-4001 Self-Service #89043
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
OADP-4001 Self-Service #89043
Conversation
|
/label OADP |
|
🤖 Mon May 26 06:43:43 - Prow CI generated the docs preview: |
dc07fa0 to
d87b95c
Compare
e672e74 to
568298f
Compare
|
@anarnold97 - Requesting your review please and thanks. |
|
|
||
| The `NonAdminBackupStorageLocation` (NABSL) CR administrator approval workflow is an opt-in feature. As a cluster administrator, you must explicitly enable the feature in the `DataProtectionApplication` (DPA) CR by setting the `nonAdmin.requireApprovalForBSL` field to `true`. | ||
|
|
||
| You also need to set the `noDefaultBackupLocation` field in the DPA to `true`. This setting indicates that, there is no default backup storage location configured in the DPA and the namespace admin user can create a NABSL CR and send the CR request for approval. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
In my opinion, setting the noDefaultBackupLocation field to true in the DPA is optional in this context. To make that clearer, consider rephrasing this section to reflect that. For example
The noDefaultBackupLocation field can be optionally set to true only if the cluster admin does not wish to configure a default backup storage location (BSL) in the DPA. When this is set, namespace admin must explicitly create a NABSL CR and submit it for approval.
If a default BSL is desired, the cluster admin may configure it and omit setting noDefaultBackupLocation to true. In this case, namespace admin can still request their own NABSLs with approval, or use the default BSL if permitted.
~~~~~~~~~~~~~~~~~~~~~~
@weshayutin @shubham-pampattiwar WDYT ^^ ?
|
Taking this XXL to review between today and tomorrow IST EOD. |
xenolinux
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Provided the peer review comments/changes. Overall it looks really great! Very nice job putting this all together.
Some general comments about consistency:
- The object names:
Veleroandveleroare used inconsistent in the PR and in the repo too. So I am not sure what is the correct form. Should there be back ticks and the lowercase letter v --velero? - I am wondering how is the resource name and its abbreviation used consistently; one example
NonAdminController(NAC) CR. Is the full CR name specified for its first instance and then for the later instances is the abbreviation (NAC) used? OR both are used interchangeably? - Should
adminfrom “namespace admin user.” be in back ticks? Consider keeping either of it consistently throughout the PR.
backup_and_restore/application_backup_and_restore/oadp-self-service/oadp-self-service.adoc
Outdated
Show resolved
Hide resolved
...lication_backup_and_restore/oadp-self-service/oadp-self-service-cluster-admin-use-cases.adoc
Outdated
Show resolved
Hide resolved
...cation_backup_and_restore/oadp-self-service/oadp-self-service-namespace-admin-use-cases.adoc
Outdated
Show resolved
Hide resolved
...tore/application_backup_and_restore/oadp-self-service/oadp-self-service-troubleshooting.adoc
Outdated
Show resolved
Hide resolved
@xenolinux - Thank you so much for taking this time to review an XXL sized PR. I know it must have taken up a lot of your time. I always like your reviews, Servesha. They are very thorough and with explanations. I really appreciate you patiently reviewing each and every line and providing suggestions. My PRs always come out cleaner after your reviews. I have applied all your suggestions. Just a couple of places where need to verify with SMEs, and the places where I need to remove extra lines. Thanks again Servesha for your time, patience, and effort! cc: @kalexand-rh - I can't thank Servesha enough for her very meticulous and detailed review :) |
Signed-off-by: Shruti Deshpande <shdeshpa@redhat.com>
bf1f18e to
7c5ea32
Compare
|
@shdeshpa07: all tests passed! Full PR test history. Your PR dashboard. DetailsInstructions 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. |
|
/label merge-review-needed @ merge reviewer, As this is a huge PR, I would like to get the PR merge-reviewed and merged. I have commented-out the topic_map.yml file entry for this feature. After this PR gets merged, I will un-comment the topic_map.yml lines and create another PR and get that merged on the date of GA. I discussed this approach with @kalexand-rh in a group chat with my content strategist and manager, and everyone agrees to the approach. Thanks. |
|
/label merge-review-needed |
|
can someone repost a preview link |
|
/label merge-review-in-progress |
|
Still reviewing. Due to the scope and since I started late in the day, the review will carry over into tomorrow. |
@weshayutin - Sorry, I should have kept you in loop. This PR is now on merge review, therefore I had to comment out the entries in the _topic_map.yaml file for the feature. This caused the preview links to no longer work. But I understand that you might need to preview the Self-Service docs, so I created a separate temp branch (from this one) and a separate temp PR to generate a preview link. TL;DR -> Here is the temporary preview link. OADP Self-Service preview After this current PR gets merged, I will loop back and provide you with a latest preview link again. Thanks! |
michaelryanpeter
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I found a few nits. Nothing major and nothing worth blocking a merge. If you get the chance, please try to address the nits before publication.
Great work!
| .Example RBAC | ||
| [source,yaml] | ||
| ---- | ||
| ... |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Reminder to include the apiVersion and kind in YAML files. https://github.com/openshift/openshift-docs/blob/main/contributing_to_docs/doc_guidelines.adoc#yaml-formatting-for-kubernetes-and-openshift-api-objects
Not a blocker.
|
/cherrypick enterprise-4.19 |
|
@michaelryanpeter: new pull request created: #93885 DetailsIn response to this:
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. |
Thank you @michaelryanpeter . I'll address all of these merge review comments in a separate PR (I am opening one for uncommenting the _topic_map.yaml entries). Thank you for your review! |
Thank you @michaelryanpeter. I have addressed most of your comments in this new PR. |
Jira
OADP Self-Service feature
Version
Preview
Self-Service
Self-Service cluster admin use cases
Self-Service namespace admin use cases
Self-Service troubleshooting
QE Review