GCP Job RunnerFocus on the job

A CLI tool to run scripts locally or on Cloud Run. Simple code, zero boilerplate.

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

GCP Job Runner gives you a CLI to define, discover, and execute jobs from your terminal. Write your logic as a simple function, and run it against any environment — locally on your machine or remotely on Cloud Run — with a single command.

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: