Cloud Run Jobs API

Execute background jobs on Google Cloud Run Jobs platform.

What It Does

The Cloud Run Jobs API provides a simplified interface for executing background jobs on Google Cloud Run Jobs. It handles job invocation, environment variable overrides, and automatic GCP project detection for seamless job orchestration.

Key Capabilities

• Job Execution: Programmatically execute Cloud Run jobs
• Environment Overrides: Pass custom environment variables to containers
• Auto Project Detection: Automatic GCP project ID resolution
• Long Running Operations: Returns operation tracking for async jobs
• Regional Configuration: Default us-central1 location

Main Component

CloudRunTaskService

async executeJobs(
  jobName: string,
  overrides?: Record<string, any>
): Promise<Operation>

Parameters:

• jobName: Cloud Run job name (e.g., “microservice-jobs”)
• overrides: Optional environment variables as key-value pairs

Returns: LROperation for tracking execution status

Usage Pattern

await cloudRunTaskService.executeJobs(
  'user-processing-jobs',
  {
    JOB_NAME: 'processUsers',
    BATCH_SIZE: '1000',
    ENVIRONMENT: 'production'
  }
)

Common Use Cases

• Background data processing
• Batch operations and ETL jobs
• Scheduled maintenance tasks
• Long-running computations
• Job orchestration from microservices

Roadmap

Multi-Cloud Support

This API currently supports Google Cloud Platform. Future versions will add support for additional cloud providers and container-based deployment options, enabling greater flexibility in infrastructure choices.

What Customers Don’t Have to Build

• Cloud Run Jobs API integration
• GCP project ID resolution
• Environment variable transformation
• Resource name construction
• Operation tracking
• JobsClient configuration