gitpod-io/Ephemeral GCE GitHub self-hosted runner

Creates ephemeral GCE based GitHub Action self-hosted runner. It uses startup script to bootstrap the VM.

Trust Signals

workflow.ymlSHA-pinned

uses: gitpod-io/gce-github-runner@d5fc1669c36a44d972a234760f58433bbcc01801 # no releases — HEAD as of 2026-07-11

tags can be moved; commit SHAs can't. why a SHA?

name	description	required	default
runner_token	GitHub auth token, needs `repo`/`public_repo` scope: https://docs.github.com/en/rest/reference/actions#self-hosted-runners.	yes	—
project_id	ID of the Google Cloud Platform project. If provided, this will configure gcloud to use this project ID.	no	public-github-runners
machine_zone	GCE zone	no	europe-west1-b
machine_type	GCE machine type; https://cloud.google.com/compute/docs/machine-types	yes	n2d-standard-32
disk_size	VM disk size.	no	500GB
image_project	The Google Cloud project against which all image and image family references will be resolved.	no	public-github-runners
image	Specifies the name of the image that the disk will be initialized with. If not provided, will use the latest gh-runner-* image.	no	—
image_family	The image family for the operating system that the boot disk will be initialized with.	no	—
label	Runner label. Can be set to override the VM name to recreate a runner with a specific label, e.g. to replace a runner that was shutdown. If set, 'task' will be ignored.	no	—
scopes	Scopes granted to the VM, defaults to full access (cloud-platform).	yes	cloud-platform
shutdown_timeout	Shutdown grace period (in seconds).	yes	30s
task	Additional context about the workflow	yes	default
gcp_credentials	GCP JSON credentials	yes	—

name	description
label	Unique runner label. This label can be used to request a specific runner for the workflow job.
machine-zone	VM availability zone