Skip to content

Document pods/exec RBAC requirement for SDK support bundle collectors#4090

Merged
AmberAlston merged 1 commit into
mainfrom
sdk-support-bundle-exec-rbac
May 22, 2026
Merged

Document pods/exec RBAC requirement for SDK support bundle collectors#4090
AmberAlston merged 1 commit into
mainfrom
sdk-support-bundle-exec-rbac

Conversation

@AmberAlston
Copy link
Copy Markdown
Member

Summary

  • Adds an RBAC requirements for exec collectors section to the support bundle customizing page, explaining that the SDK's built-in support bundle spec uses exec collectors requiring pods/exec with create verb
  • Adds a troubleshooting entry to the support bundle generating page for the "No app-info file found" / "No license file found" Vendor Portal warnings
  • Documents that KOTS installations already include the needed RBAC, while Helm CLI installations require vendors to ensure the permission exists

Closes sc-136407

Context

The SDK's default support bundle spec calls internal API endpoints (/api/v1/app/info, /api/v1/license/info) via exec collectors. When pods/exec RBAC is missing, these collectors fail silently and the bundle uploads without app-info.json or license.yaml. The only indication is VP warnings after upload.

Test plan

  • Verify the new section renders correctly on the customizing page
  • Verify the troubleshooting entry renders correctly on the generating page
  • Confirm the #exec-rbac anchor link from the generating page resolves correctly

🤖 Generated with Claude Code

…ctors

The SDK's built-in support bundle spec uses exec collectors to call
internal API endpoints, but the pods/exec RBAC requirement was not
documented. Without it, app-info.json and license.yaml are silently
missing from bundles. This adds an RBAC requirements section to the
customizing page and a troubleshooting entry to the generating page.

sc-136407

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@AmberAlston AmberAlston requested a review from a team as a code owner May 22, 2026 16:27
@netlify
Copy link
Copy Markdown

netlify Bot commented May 22, 2026

Deploy Preview for replicated-docs-upgrade ready!

Name Link
🔨 Latest commit fd70378
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs-upgrade/deploys/6a1083fffd34090008390e0e
😎 Deploy Preview https://deploy-preview-4090--replicated-docs-upgrade.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link
Copy Markdown

netlify Bot commented May 22, 2026

Deploy Preview for replicated-docs ready!

Name Link
🔨 Latest commit fd70378
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs/deploys/6a1083ffa5160f00089dc678
😎 Deploy Preview https://deploy-preview-4090--replicated-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@replicated-ci replicated-ci added type::docs Improvements or additions to documentation type::feature labels May 22, 2026
verbs: ["create"]
```

Without this permission, the `exec` collectors fail silently. The support bundle is still generated and can be uploaded to the Vendor Portal, but `app-info.json` and `license.yaml` will be missing. The Vendor Portal displays warnings such as "No app-info file found" and "No license file found" when these files are absent.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

📝 [vale] reported by reviewdog 🐶
[Replicated.Passive] In general, use active voice instead of passive voice ('be uploaded').


#### Cause

The Replicated SDK's built-in support bundle spec uses `exec` collectors to retrieve application and license information from the SDK pod. If the service account running the support bundle does not have `pods/exec` permissions with the `create` verb, these collectors fail silently and the data is not included in the bundle.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

📝 [vale] reported by reviewdog 🐶
[Replicated.SentenceLength] Try to keep your sentence length to 26 words or fewer.

@AmberAlston AmberAlston merged commit 0847da9 into main May 22, 2026
6 checks passed
@AmberAlston AmberAlston deleted the sdk-support-bundle-exec-rbac branch May 22, 2026 16:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type::docs Improvements or additions to documentation type::feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants