/cloud-run

name: cloud-run
description: 'Manage Cloud Run services and jobs.'
metadata:
  version: 0.1.0
  openclaw:
    category: 'compute'
    requires:
      bins:
        - gcloud
    cliHelp: 'gcloud run --help'

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

| Command | Description | | -------- | -------------------------------------------- | | `deploy` | Create 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.