Skip to content

Document GCP IAM roles and minimal custom-role mode#244

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/gcp-permissions-1778533621
Open

Document GCP IAM roles and minimal custom-role mode#244
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/gcp-permissions-1778533621

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 11, 2026

Summary

Porter now supports a minimal-permission mode on GCP. When enabled for a project, Porter provisions a project-scoped IAM custom role named porterManager that grants only the permissions Porter actually uses, in place of broad predefined roles like roles/storage.admin, roles/compute.admin, and roles/container.admin. The mode is rolled out per project.

Changes

  • Added a Permissions Porter grants section under the GCP tab of cloud-accounts/connecting-a-cloud-account.mdx, covering:
    • The default set of predefined roles Porter binds to the Porter service account
    • The new minimal custom-role mode (porterManager), including which broad roles it replaces and the bootstrap roles that remain
    • The list of GCP APIs Porter enables
  • Updated the revoking-access steps to mention deleting the porterManager custom role when minimal mode was enabled.

Why

Customers in regulated environments need a clear reference for the IAM permissions Porter requires on their GCP project, and the new minimal-permission mode is a notable scoping change worth surfacing in the connecting-a-cloud-account guide.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 11, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
porter 🟢 Ready View Preview May 11, 2026, 9:11 PM

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants