Skip to content

docs: list every role a source deploy needs, not just the first three - #123

Merged
sgardoll merged 1 commit into
mainfrom
fix/runner-sa-roles-doc
Oct 4, 2026
Merged

sgardoll merged 1 commit into
mainfrom
fix/runner-sa-roles-doc

Conversation

@sgardoll

@sgardoll sgardoll commented Oct 4, 2026 •

Copy link
Copy Markdown
Owner

The documented runner service-account roles were wrong twice, and each omission cost a failed deploy:

  1. Missing Artifact Registry -> PERMISSION_DENIED: artifactregistry.repositories.get
  2. Missing Storage -> does not have storage.buckets.get access to ... run-sources-low-code-connect-us-west1

gcloud run deploy --source uploads the source to a bucket, builds an image, then pushes it — each step needs its own permission, and gcloud reports only the first one missing. So the list is now complete, as a table with the reason for each, including the concrete bucket name.

Docs only; no code change.


Devin Review

The runner service account's role list named run.admin, cloudbuild and
serviceAccountUser and missed Artifact Registry and Storage. A source deploy
uploads the source to a bucket, builds, then pushes the image, and it fails
naming only the permission it is missing - so the list was corrected twice
against real failures, once per missing permission.

Documented as a table with the reason for each, so the next person grants them
all at once instead of discovering them one deploy at a time.

@devin-ai-integration devin-ai-integration Bot left a comment

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.

Devin Review found 1 potential issue.

Devin Review

Comment thread DEPLOYMENT.md
Comment on lines +188 to +189
| `roles/artifactregistry.writer` | push the built image (else `artifactregistry.repositories.get` is denied) |
| `roles/storage.objectAdmin` | read/write the source bucket `run-sources-<project>-<region>` (else `storage.buckets.get` is denied) |

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.

🔍 Workflow comment still lists three roles

The authentication step's credential comment still names only three roles. Readers following that comment can miss the two roles added here.

Devin Review


Was this helpful? React with 👍 or 👎 to provide feedback.

@sgardoll
sgardoll merged commit cac45be into main Oct 4, 2026
7 checks passed
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.

1 participant