cloud-run

Manage Cloud Run services and jobs.

run (v1)

PREREQUISITE: Ensure you have the gcloud CLI installed and authenticated with gcloud auth login. Set your project with gcloud config set project [PROJECT_ID].

gcloud run <resource> <method> [flags]

Helper Commands

CommandDescription
deployCreate or update a Cloud Run service or job.

API Resources

services

  • list — List available services in the specified region.
  • describe — Obtain details about a given service, such as its URL and configuration.
  • update — Update Cloud Run environment variables, concurrency settings, and other configuration.
  • delete — Delete a service and its associated revisions.
  • update-traffic — Adjust the traffic assignments for a Cloud Run service.
  • proxy — Proxy a service to localhost authenticating as the active account.
  • logs read — Read logs for a Cloud Run service.
  • replace - Create or replace a service from a YAML service specification.
  • add-iam-policy-binding — Add IAM policy binding to a Cloud Run service (e.g., to make it public).
  • remove-iam-policy-binding - Remove IAM policy binding of a Cloud Run service.
  • get-iam-policy - Get the IAM policy for a Cloud Run service.
  • set-iam-policy - Set the IAM policy for a Cloud Run service.

jobs

  • create — Create a Cloud Run job.
  • execute — Start an execution of a Cloud Run job.
  • list — List available jobs.
  • describe — Obtain details about a given job.
  • deploy - Create or update a Cloud Run job
  • update — Update a Cloud Run job configuration.
  • delete — Delete a Cloud Run job.
  • replace - Create or replace a Cloud Run job from a YAML job specification.
  • executions list — List executions of a Cloud Run job.
  • logs read — Read logs for a Cloud Run job.
  • add-iam-policy-binding — Add IAM policy binding to a Cloud Run job.
  • remove-iam-policy-binding - Remove IAM policy binding of a Cloud Run job.
  • get-iam-policy - Get the IAM policy for a Cloud Run job.
  • set-iam-policy - Set the IAM policy for a Cloud Run job.

domain-mappings

  • list — List domain mappings.
  • create — Create a new domain mapping.
  • describe — Obtain details about a domain mapping.
  • delete — Delete a domain mapping.

multi-region-services

  • list — List multi-region services.
  • describe — Obtain details about a multi-region service.
  • update — Update settings for multi-region services.
  • delete — Delete a multi-region service.
  • replace - Create or Update multi-region service from YAML specification.

revisions

  • list — List available revisions for a service.
  • describe — Obtain details about a specific revision.
  • delete — Delete a specific revision.

regions

  • list — View available Cloud Run (fully managed) regions.

compose

  • up — Deploy to Cloud Run from a compose specification.

Discovering Commands

Before calling any command, inspect it for help:

# Browse resources and methods
gcloud run --help

# Inspect a specific resource methods
gcloud run services --help

# Inspect a specific resource's sub-group methods
gcloud run jobs executions --help

# Inspect a method's specific flags and arguments
gcloud run deploy --help

Use the output of --help to discover available flags like --image, --env-vars, --memory, etc.