Cloud Run CLI

Use the gcloud run command to manage your Cloud Run applications.

Basic Syntax

gcloud run [GROUP] [COMMAND] [FLAGS]

Deploy a service from an image:

gcloud run deploy my-service \
    --image us-docker.pkg.dev/cloudrun/container/hello:latest \
    --quiet

Deploy from source code:

gcloud run deploy my-service --source . --quiet

Deploy a Cloud Run function:

gcloud run deploy my-service
--source . --function example-hello --base-image go126 --region us-central1 --quiet

Update traffic split:

gcloud run services update-traffic my-service --to-revisions=REV1=50,REV2=50 --quiet

Create a job:

gcloud run jobs create my-job \
  --image us-docker.pkg.dev/cloudrun/container/job:latest \
  --quiet

List job executions:

gcloud run executions list --job my-job

Deploy a worker pool from an image:

gcloud run worker-pools deploy my-workerpool \
  --image us-docker.pkg.dev/cloudrun/container/worker-pool:latest \
  --quiet

Deploy from source code:

gcloud run worker-pools deploy my-workerpool --source . --quiet

List worker pools:

gcloud run worker-pools list --region us-central1 --quiet

Configure scaling (manual):

gcloud run worker-pools deploy my-workerpool --instances=5 \
  --image us-docker.pkg.dev/cloudrun/container/worker-pool:latest \
  --quiet

View more details about a service: gcloud run services describe my-service

View logs:

gcloud logging read "resource.type=cloud_run_revision AND \
  resource.labels.service_name=my-service" \
  --quiet