GCP Job RunnerDefine once, run anywhere

Schema-driven CLI jobs that run locally during development and on Cloud Run in production. Same code, same secrets, same behavior.

Get Started

Cloud Jobs

Zod Validation

Define job arguments with Zod schemas. Input is validated before your handler runs, with auto-generated --help for every job.

Run Locally or in the Cloud

Switch between local and Cloud Run execution with a single word. The same code runs in both environments with the same secrets.

Smart Image Caching

A single Docker image contains all your jobs. Only source code changes trigger a rebuild — running different jobs or different arguments is instant.

GCP Secret Manager

Secrets are loaded from Secret Manager automatically. The execution environment is transparent — same secrets for local and cloud.

Monorepo Support

Workspace dependencies are automatically isolated into a standalone deployable package. No manual bundling or Docker configuration needed.

Interactive Mode

Browse and select jobs interactively. Argument prompts adapt to schema types — text inputs, selects for enums, confirmations for booleans.

Quick Look

Define a job with a Zod schema:

typescript

import { z } from "zod";
import { defineJob } from "gcp-job-runner";

export default defineJob({
  description: "Count down and exit",
  schema: z.object({
    seconds: z.number().default(10).describe("Number of seconds to count down"),
  }),
  handler: async ({ seconds }) => {
    for (let i = seconds; i > 0; i--) {
      console.log(`${i}...`);
      await new Promise((resolve) => setTimeout(resolve, 1000));
    }
    console.log("Done!");
  },
});

Run it locally:

bash

job local run stag countdown --seconds 5

Run it on Cloud Run: