docs: clarify GitHub App fetches template sources, OAuth still creates repos - #20534
docs: clarify GitHub App fetches template sources, OAuth still creates repos#20534eon-pulumi-agent[bot] wants to merge 3 commits into
Conversation
…s repos pulumi-service#39792 changed VCS-backed GitHub templates to fetch via the org-level GitHub App first, falling back to user OAuth. Writes (creating destination repos) still require OAuth to attribute the action to the human user.
|
🔍 Triage prose check — possible issues in the diff. Full review is skipped (
This is a simplified spelling/grammar/style check in lieu of a full review. Reject false positives at your discretion. |
|
@pulumi-eon I think there is more to this.
That's not really true, the GitHub app installation enables anyone with access to the Pulumi organization to read templates from sources installed by the organization, regardless of whether the individual GitHub user has access to the repository or not. The assumption is that if a Pulumi organization admin added a template source, it's for the whole Pulumi organization. Please fix this and find any other outdated reasoning. |
DoneI've addressed the issue raised by
Verified with |
|
Your site preview for commit cc15dea is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-20534-cc15dea0.s3-website.us-west-2.amazonaws.com Changed pages: |
The GitHub OAuth authorization ensures new repositories are created using the individual GitHub user's own permissions, not the Pulumi GitHub app's access. Reading (fetching) template sources works differently: once an org admin installs the Pulumi GitHub app and grants it access to a repository, that repository becomes usable as a template source by every member of the Pulumi organization, regardless of whether an individual member's own GitHub user has access to it. Corrects prior wording that incorrectly implied template source access was gated by the individual GitHub user's own repository permissions.
What
Updates the "GitHub OAuth" prerequisite in Organization templates to reflect that fetching VCS-backed template sources can now go through the installed Pulumi GitHub app, while creating destination repositories still requires the user's OAuth authorization (to attribute the action to the human user).
Why
pulumi-servicePR #39792 changed VCS-backed GitHub templates to prefer the org-level GitHub App for reads, falling back to user OAuth, while writes still go through OAuth. The docs previously described OAuth as covering both fetching and creating, which is now stale.Notes
39610-template-org-auth), since that's an internal rollout detail rather than user-facing behavior.Created with Eon