Skip to content

fix: add compute.instances.listReferrers permission to runner role#1

Merged
nandajavarma merged 1 commit into
mainfrom
n/fix-list-referrers-perm
Apr 9, 2026
Merged

fix: add compute.instances.listReferrers permission to runner role#1
nandajavarma merged 1 commit into
mainfrom
n/fix-list-referrers-perm

Conversation

@nandajavarma
Copy link
Copy Markdown
Collaborator

Problem

The warm pool allocator calls ListReferrers on claimed instances to verify they are fully detached from their MIG before handing them to an environment. The runner service account is missing the compute.instances.listReferrers permission, causing a 403 error:

googleapi: Error 403: Required 'compute.instances.listReferrers' permission for
'projects/gcp-runner-test/zones/us-east1-c/instances/ona-wp-...'

The runner proceeds anyway (the check is non-fatal), but the readiness verification is effectively skipped.

Fix

Add compute.instances.listReferrers to the runner custom IAM role and update the runner role docs (docs/iam.md, docs/detailed_iam_reference.md).

Mirror of https://github.com/gitpod-io/gitpod-gcp-terraform/pull/141.

The warm pool code calls ListReferrers to check if an instance is fully
detached from its MIG before handing it to an environment. Without this
permission the call fails with a 403, causing the runner to skip the
readiness check and proceed with a potentially unready instance.

Co-authored-by: Ona <no-reply@ona.com>
@nandajavarma nandajavarma merged commit 7c2c923 into main Apr 9, 2026
1 check passed
easyCZ pushed a commit that referenced this pull request May 21, 2026
fix: add compute.instances.listReferrers permission to runner role
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