Skip to content

OADP must-gather for 1.4.5 #95588

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

Open
wants to merge 3 commits into
base: enterprise-4.18
Choose a base branch
from

Conversation

shdeshpa07
Copy link
Contributor

@shdeshpa07 shdeshpa07 commented Jul 3, 2025

Jira

OADP must-gather for OCP 4.18 4.17 4.16

Version

  • OCP 4.18
  • OCP 4.17
  • OCP 4.16

Preview

QE Review

  • QE has approved this change.

Signed-off-by: Shruti Deshpande <shdeshpa@redhat.com>
@openshift-ci openshift-ci bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Jul 3, 2025
@ocpdocs-previewbot
Copy link

ocpdocs-previewbot commented Jul 3, 2025

Signed-off-by: Shruti Deshpande <shdeshpa@redhat.com>
@shdeshpa07
Copy link
Contributor Author

/label OADP

@openshift-ci openshift-ci bot added the OADP Label for all OADP PRs label Jul 3, 2025
Copy link

@stillalearner stillalearner left a comment

Choose a reason for hiding this comment

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

lgtm

@shdeshpa07
Copy link
Contributor Author

/label peer-review-needed

@openshift-ci openshift-ci bot added the peer-review-needed Signifies that the peer review team needs to review this PR label Jul 10, 2025
@eromanova97
Copy link
Contributor

/remove-label peer-review-needed

/label peer-review-in-progress

@openshift-ci openshift-ci bot added peer-review-in-progress Signifies that the peer review team is reviewing this PR and removed peer-review-needed Signifies that the peer review team needs to review this PR labels Jul 10, 2025
Copy link
Contributor

@eromanova97 eromanova97 left a comment

Choose a reason for hiding this comment

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

I have finished the review and left a few comments.
Please also ensure to merge the commits before requesting merge review.

Thank you!

/remove-label peer-review-in-progress

/label peer-review-done

// * backup_and_restore/application_backup_and_restore/using-the-must-gather-tool.adoc

:_mod-docs-content-type: PROCEDURE
[id="oadp-running-must-gather_{context}"]
Copy link
Contributor

Choose a reason for hiding this comment

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

From OpenShift docs guidelines:

The anchor ID with _{context} must be lowercase and match the module’s file name.

Similarly in modularization guidelines:

At the top of every module, provide an anchor in the format [id="filename_{context}"] where filename is the exact name of the file, without the file extension (.adoc) and a module prefix

So I would recommend either renaming the file or changing the ID, so that the ID and file name matches

Comment on lines +17 to +22
For more information about the supported flags, use the help flag with the `must-gather` tool as shown in the following example:

[source,terminal,subs="attributes+"]
----
$ oc adm must-gather --image={must-gather-v1-4} -- /usr/bin/gather -h
----
Copy link
Contributor

@eromanova97 eromanova97 Jul 10, 2025

Choose a reason for hiding this comment

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

I do not usually see commands in the introduction of a procedure.

Could it be possibly moved to the procedure? and if not, maybe putting this into a note would work better here?

----
$ oc adm must-gather --image={must-gather-v1-4} -- /usr/bin/gather --request-timeout 15s --skip-tls #<1>
----
<1> In this example, the timeout is 15 seconds. By default, the `--skip-tls` flag value is `false`. Set the value to `true` to allow insecure TLS connections.
Copy link
Contributor

Choose a reason for hiding this comment

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

By default, the --skip-tls flag value is false. Set the value to true to allow insecure TLS connections.

The --skip-tls option is already used in the previous example command, so it would be better to explain this behavior sooner. It could be moved to the decription of "Insecure TLS connections" in the introduction.

@openshift-ci openshift-ci bot added peer-review-done Signifies that the peer review team has reviewed this PR and removed peer-review-in-progress Signifies that the peer review team is reviewing this PR labels Jul 10, 2025
Co-authored-by: Eliska Romanova <eromanov@redhat.com>
Copy link

openshift-ci bot commented Jul 15, 2025

@shdeshpa07: 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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
OADP Label for all OADP PRs peer-review-done Signifies that the peer review team has reviewed this PR size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants