Here’s a comprehensive guide to all gcloud run subcommands with examples and explanations:

---

📦 1. Deploying Services

gcloud run deploy

Create or update a fully-managed service.

gcloud run deploy SERVICE_NAME \
  --image=gcr.io/my-project/my-image:tag \
  --platform=managed \
  --region=asia-northeast1 \
  --allow-unauthenticated

• Builds and deploys a new revision.
• Automatically handles traffic, IAM settings, and service creation.
  (stackoverflow.com)

---

🛠️ 2. Managing Services

gcloud run services list

List all Cloud Run services in a region.

gcloud run services list \
  --platform=managed \
  --region=asia-northeast1 \
  --format="table(metadata.name,status.url)"

gcloud run services describe

Show detailed info (config, traffic, URL, latest revision, etc.).

gcloud run services describe my-service \
  --platform=managed \
  --region=asia-northeast1

---

🔍 3. Managing Revisions

gcloud run revisions list

List all revisions of a service.

gcloud run revisions list \
  --platform=managed \
  --region=asia-northeast1 \
  --filter="metadata.labels.service=my-service" \
  --format="table(metadata.name,metadata.creationTimestamp)"

gcloud run revisions describe

Get detailed metadata of a specific revision.

gcloud run revisions describe my-service-00005-xyz \
  --platform=managed \
  --region=asia-northeast1

---

👥 4. IAM & Permissions

gcloud run services add-iam-policy-binding

Grant roles to members.

gcloud run services add-iam-policy-binding my-service \
  --member=user:me@gmail.com \
  --role=roles/run.invoker \
  --platform=managed \
  --region=asia-northeast1

Likewise: remove-iam-policy-binding, get-iam-policy, set-iam-policy.

---

⚙️ 5. Updating Services

gcloud run services update

Apply config changes to a service (without redeploying code).

gcloud run services update my-service \
  --platform=managed \
  --region=asia-northeast1 \
  --concurrency=100 \
  --memory=512Mi

• Doesn’t rebuild the image—just modifies runtime configuration
  (stackoverflow.com, reddit.com, reddit.com)

---

📋 6. Metadata Inspection

• To view YAML or JSON output: gcloud run services describe my-service \ --platform=managed \ --region=asia-northeast1 \ --format=json
• To extract specific fields: # Service URL: gcloud run services describe my-service \ --platform=managed \ --region=asia-northeast1 \ --format="value(status.url)" # Container image: gcloud run services describe my-service \ --platform=managed \ --region=asia-northeast1 \ --format="value(spec.template.spec.containers[0].image)"

---

🧪 7. Jobs (Cloud Run jobs)

gcloud run jobs list

List all jobs.

gcloud run jobs list \
  --platform=managed \
  --region=asia-northeast1 \
  --format="table(metadata.name, status.lastRunState)"

gcloud run jobs describe

Describe a job.

gcloud run jobs describe my-job \
  --platform=managed \
  --region=asia-northeast1

gcloud run jobs execute

Run the job now.

gcloud run jobs execute my-job \
  --platform=managed \
  --region=asia-northeast1

---

🔁 8. Alpha/Beta Commands

Additional flags and features exist in beta or alpha:

• gcloud beta run deploy
• gcloud beta run services update
• gcloud alpha run ...

Install via:

gcloud components install beta
gcloud beta run deploy ...

Shows future enhancements and experimental options not in GA (reddit.com, youtube.com, cloud.google.com, reddit.com, stackoverflow.com, cloud.google.com)

---

🛠️ 9. Global Options

Common flags available to all commands:

• --project=PROJECT_ID
• --platform=[managed|gke]
• --region=REGION
• --format=[json|table|yaml|value]
• --filter=...
• --verbosity=[debug|info]
• --async (non-blocking execution)

---

✅ TL;DR: Quick Reference

Category	Command	Use Case
Deploy	gcloud run deploy	Create/update service with container or source
Manage	gcloud run services list/describe	View services and metadata
Update Config	gcloud run services update	Change service settings without redeploy
Revisions	gcloud run revisions list/describe	Inspect immutable deployment snapshots
IAM	add/remove/get-iam-policy-binding	Manage access permissions
Jobs	gcloud run jobs list/describe/execute	Run batch jobs with Cloud Run
Metadata format	--format=	Get output as JSON/YAML/fields
Filtering	--filter=	Query services or revisions dynamically
Async execution	--async	Don’t wait for operations to complete

---