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

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.