Skip to content

MG-334: add user docs - #377

Draft
neha037 wants to merge 3 commits into
openshift:masterfrom
neha037:MG-334
Draft

MG-334: add user docs#377
neha037 wants to merge 3 commits into
openshift:masterfrom
neha037:MG-334

Conversation

@neha037

@neha037 neha037 commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Summary by CodeRabbit

  • Documentation
    • Added guidance for updating Support Log Gather documentation for general availability.
    • Clarified permissions, service account requirements, subscription channels, installation steps, and validation behavior.
    • Updated examples and parameter descriptions to reflect current configuration rules.
    • Documented restrictions for auditing, timeouts, storage, proxies, trusted certificates, credentials, and immutable settings.
    • Added troubleshooting guidance, invalid examples, deferred topics, and a documentation checklist.

@openshift-ci-robot openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label Jul 28, 2026
@openshift-ci-robot

openshift-ci-robot commented Jul 28, 2026

Copy link
Copy Markdown

@neha037: This pull request references MG-334 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the story to target the "5.0.0" version, but no target version was set.

Details

In 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 openshift-eng/jira-lifecycle-plugin repository.

@openshift-ci openshift-ci Bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Jul 28, 2026
@openshift-ci

openshift-ci Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

@coderabbitai

coderabbitai Bot commented Jul 28, 2026

Copy link
Copy Markdown

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository: openshift/coderabbit/.coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 62d0a065-d50d-4e83-b5af-aa4c78951d1d

📥 Commits

Reviewing files that changed from the base of the PR and between 30a9166 and d3d4ee1.

📒 Files selected for processing (1)
  • docs/MG-334-support-log-gather-docs-update.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/MG-334-support-log-gather-docs-update.md

Walkthrough

This documentation change request defines GA updates for Support Log Gather. It covers permissions, installation examples, CLI configuration, corrected MustGather examples, parameter references, validation notes, and writer checklists.

Changes

Support Log Gather GA documentation

Layer / File(s) Summary
GA overview and installation guidance
docs/MG-334-support-log-gather-docs-update.md
Removes Technology Preview references, updates service-account permission wording, and changes CLI subscription examples to use <GA_CHANNEL>.
CLI configuration and validation procedure
docs/MG-334-support-log-gather-docs-update.md
Revises prerequisites, MustGather examples, restriction callouts, proxy and storage notes, and validation guidance.
Examples, parameter reference, and writer validation
docs/MG-334-support-log-gather-docs-update.md
Corrects service-account and parameter examples, documents secret and storage details, and adds invalid-pattern, deferred-topic, unchanged-module, fact-check, and writer-checklist appendices.

Estimated code review effort: 2 (Simple) | ~10 minutes

🚥 Pre-merge checks | ✅ 15
✅ Passed checks (15 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly identifies the main change: adding user documentation for the must-gather operator.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Stable And Deterministic Test Names ✅ Passed The PR diff adds only one Markdown documentation file; no Ginkgo test constructs or test titles were changed or added.
Test Structure And Quality ✅ Passed The PR diff adds only one Markdown documentation file; no Go or Ginkgo test files changed, and the document contains no Ginkgo test constructs.
Microshift Test Compatibility ✅ Passed The PR commit adds only one documentation file (+578 lines) and changes no test paths or Ginkgo tests, so MicroShift test compatibility is not applicable.
Single Node Openshift (Sno) Test Compatibility ✅ Passed The effective PR diff adds only a 578-line documentation change request; it adds no Ginkgo e2e tests or multi-node test behavior.
Topology-Aware Scheduling Compatibility ✅ Passed The PR adds only a documentation change-request file; the diff contains no manifests, controller code, replicas, affinity, topology, selectors, tolerations, or PDB changes.
Ote Binary Stdout Contract ✅ Passed The effective PR diff adds only docs/MG-334-support-log-gather-docs-update.md; no Go or build-script changes can introduce process-level stdout writes.
Ipv6 And Disconnected Network Test Compatibility ✅ Passed The PR adds only one Markdown change-request document; no Ginkgo e2e test declarations or changed test files were introduced.
No-Weak-Crypto ✅ Passed The PR adds only a documentation change-request file; its added lines contain no MD5, SHA1, DES, RC4, Blowfish, ECB, custom crypto, or non-constant-time comparison usage.
Container-Privileges ✅ Passed The PR adds one documentation change-request file; its YAML examples contain no privileged:true, host namespaces, SYS_ADMIN, root execution, or allowPrivilegeEscalation:true.
No-Sensitive-Data-In-Logs ✅ Passed The PR adds only a documentation change request; it introduces no logging code or log output containing passwords, tokens, PII, hostnames, or customer data.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Comment @coderabbitai help to get the list of available commands.

@openshift-ci

openshift-ci Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: neha037
Once this PR has been reviewed and has the lgtm label, please assign devppratik for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🧹 Nitpick comments (1)
docs/MG-334-support-log-gather-docs-update.md (1)

180-190: 🎯 Functional Correctness | 🔵 Trivial | ⚡ Quick win

Link the bundled RBAC manifests. The controller only checks that the service account exists; point users to the must-gather-admin ClusterRole/ClusterRoleBinding so the prerequisite is actionable.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/MG-334-support-log-gather-docs-update.md` around lines 180 - 190, Update
the service-account prerequisite near the MustGather CR requirements to link to
the bundled must-gather-admin ClusterRole and ClusterRoleBinding manifests,
instructing users to apply or configure them for the service account. Keep the
existing namespace and permissions guidance intact.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/MG-334-support-log-gather-docs-update.md`:
- Around line 304-305: Update the oc verification commands in this
documentation, including the must-gather lookup and the referenced command
ranges, to explicitly target the must-gather-operator namespace. Preserve the
existing resource names and output formats while ensuring every check queries
the namespace where the examples create resources.
- Around line 193-195: Remove the invalid proxyConfig field from the example
MustGather YAML and all later duplicated examples in this document. Keep proxy
configuration represented only through the operator environment variables
HTTP_PROXY, HTTPS_PROXY, and NO_PROXY.

---

Nitpick comments:
In `@docs/MG-334-support-log-gather-docs-update.md`:
- Around line 180-190: Update the service-account prerequisite near the
MustGather CR requirements to link to the bundled must-gather-admin ClusterRole
and ClusterRoleBinding manifests, instructing users to apply or configure them
for the service account. Keep the existing namespace and permissions guidance
intact.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository: openshift/coderabbit/.coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: be5d1b8e-f824-425e-9fe2-67a86bd8bf9e

📥 Commits

Reviewing files that changed from the base of the PR and between 501f600 and dc5e1e0.

📒 Files selected for processing (1)
  • docs/MG-334-support-log-gather-docs-update.md

Comment thread docs/MG-334-support-log-gather-docs-update.md
Comment on lines +304 to +305
$ oc get mustgather example-mg -o yaml
----

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Scope verification commands to the CR namespace.

The examples create resources in must-gather-operator, but these commands use the current namespace and can report false “missing” results.

Proposed fix
-$ oc get mustgather
+$ oc get mustgather -n must-gather-operator

-$ oc get pods
+$ oc get pods -n must-gather-operator

-$ oc logs -f pod/<mustgather-pod-name> -c upload
+$ oc logs -n must-gather-operator -f pod/<mustgather-pod-name> -c upload

Also applies to: 370-377, 384-384

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/MG-334-support-log-gather-docs-update.md` around lines 304 - 305, Update
the oc verification commands in this documentation, including the must-gather
lookup and the referenced command ranges, to explicitly target the
must-gather-operator namespace. Preserve the existing resource names and output
formats while ensuring every check queries the namespace where the examples
create resources.

@coderabbitai

coderabbitai Bot commented Aug 12, 2026

Copy link
Copy Markdown

Note

GitHub couldn't provide a complete incremental comparison for this pull request, so CodeRabbit is performing a full review instead. This review may take a little longer.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. jira/valid-reference Indicates that this PR references a valid Jira ticket of any type.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants