{"id":49632,"date":"2025-06-10T05:37:25","date_gmt":"2025-06-10T05:37:25","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=49632"},"modified":"2025-06-10T05:37:25","modified_gmt":"2025-06-10T05:37:25","slug":"google-cloud-gcloud-run-commands","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/google-cloud-gcloud-run-commands\/","title":{"rendered":"Google Cloud: gcloud run commands"},"content":{"rendered":"\n<p>Here\u2019s a comprehensive guide to <strong>all <code>gcloud run<\/code> subcommands<\/strong> with examples and explanations:<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud83d\udce6 1. Deploying Services<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><code>gcloud run deploy<\/code><\/h3>\n\n\n\n<p>Create or update a fully-managed service.<\/p>\n\n\n<pre class=\"wp-block-code\"><span><code class=\"hljs\">gcloud run deploy SERVICE_NAME \\\n  --image=gcr.io\/my-project\/my-image:tag \\\n  --platform=managed \\\n  --region=asia-northeast1 \\\n  --allow-unauthenticated\n<\/code><\/span><\/pre>\n\n\n<ul class=\"wp-block-list\">\n<li>Builds and deploys a new revision.<\/li>\n\n\n\n<li>Automatically handles traffic, IAM settings, and service creation.<br>(<a href=\"https:\/\/stackoverflow.com\/questions\/78589607\/gcloud-run-deploy-vs-gcloud-run-services-update?utm_source=chatgpt.com\" target=\"_blank\" rel=\"noopener\">stackoverflow.com<\/a>)<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud83d\udee0\ufe0f 2. Managing Services<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><code>gcloud run services list<\/code><\/h3>\n\n\n\n<p>List all Cloud Run services in a region.<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-1\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\">gcloud run services <span class=\"hljs-keyword\">list<\/span> \\\n  --platform=managed \\\n  --region=asia-northeast1 \\\n  --format=<span class=\"hljs-string\">\"table(metadata.name,status.url)\"<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-1\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<h3 class=\"wp-block-heading\"><code>gcloud run services describe<\/code><\/h3>\n\n\n\n<p>Show detailed info (config, traffic, URL, latest revision, etc.).<\/p>\n\n\n<pre class=\"wp-block-code\"><span><code class=\"hljs\">gcloud run services describe my-service \\\n  --platform=managed \\\n  --region=asia-northeast1\n<\/code><\/span><\/pre>\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud83d\udd0d 3. Managing Revisions<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><code>gcloud run revisions list<\/code><\/h3>\n\n\n\n<p>List all revisions of a service.<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-2\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\">gcloud run revisions <span class=\"hljs-keyword\">list<\/span> \\\n  --platform=managed \\\n  --region=asia-northeast1 \\\n  --filter=<span class=\"hljs-string\">\"metadata.labels.service=my-service\"<\/span> \\\n  --format=<span class=\"hljs-string\">\"table(metadata.name,metadata.creationTimestamp)\"<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-2\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<h3 class=\"wp-block-heading\"><code>gcloud run revisions describe<\/code><\/h3>\n\n\n\n<p>Get detailed metadata of a specific revision.<\/p>\n\n\n<pre class=\"wp-block-code\"><span><code class=\"hljs\">gcloud run revisions describe my-service-00005-xyz \\\n  --platform=managed \\\n  --region=asia-northeast1\n<\/code><\/span><\/pre>\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud83d\udc65 4. IAM &amp; Permissions<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><code>gcloud run services add-iam-policy-binding<\/code><\/h3>\n\n\n\n<p>Grant roles to members.<\/p>\n\n\n<pre class=\"wp-block-code\"><span><code class=\"hljs\">gcloud run services add-iam-policy-binding my-service \\\n  --member=user:me@gmail.com \\\n  --role=roles\/run.invoker \\\n  --platform=managed \\\n  --region=asia-northeast1\n<\/code><\/span><\/pre>\n\n\n<p>Likewise: <code>remove-iam-policy-binding<\/code>, <code>get-iam-policy<\/code>, <code>set-iam-policy<\/code>.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u2699\ufe0f 5. Updating Services<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><code>gcloud run services update<\/code><\/h3>\n\n\n\n<p>Apply config changes to a service (without redeploying code).<\/p>\n\n\n<pre class=\"wp-block-code\"><span><code class=\"hljs\">gcloud run services update my-service \\\n  --platform=managed \\\n  --region=asia-northeast1 \\\n  --concurrency=100 \\\n  --memory=512Mi\n<\/code><\/span><\/pre>\n\n\n<ul class=\"wp-block-list\">\n<li>Doesn\u2019t rebuild the image\u2014just modifies runtime configuration<br>(<a href=\"https:\/\/stackoverflow.com\/questions\/78589607\/gcloud-run-deploy-vs-gcloud-run-services-update?utm_source=chatgpt.com\" target=\"_blank\" rel=\"noopener\">stackoverflow.com<\/a>, <a href=\"https:\/\/www.reddit.com\/r\/googlecloud\/comments\/187mz7z\/is_it_possible_to_run_gcloud_command_inside_a\/?utm_source=chatgpt.com\" target=\"_blank\" rel=\"noopener\">reddit.com<\/a>, <a href=\"https:\/\/www.reddit.com\/r\/googlecloud\/comments\/qu84q4\/possible_to_see_equivalent_gcloud_commands_when\/?utm_source=chatgpt.com\" target=\"_blank\" rel=\"noopener\">reddit.com<\/a>)<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud83d\udccb 6. Metadata Inspection<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>To view YAML or JSON output: <code>gcloud run services describe my-service \\ --platform=managed \\ --region=asia-northeast1 \\ --format=json<\/code><\/li>\n\n\n\n<li>To extract specific fields: <code># 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)\"<\/code><\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud83e\uddea 7. Jobs (Cloud Run jobs)<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><code>gcloud run jobs list<\/code><\/h3>\n\n\n\n<p>List all jobs.<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-3\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\">gcloud run jobs <span class=\"hljs-keyword\">list<\/span> \\\n  --platform=managed \\\n  --region=asia-northeast1 \\\n  --format=<span class=\"hljs-string\">\"table(metadata.name, status.lastRunState)\"<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-3\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<h3 class=\"wp-block-heading\"><code>gcloud run jobs describe<\/code><\/h3>\n\n\n\n<p>Describe a job.<\/p>\n\n\n<pre class=\"wp-block-code\"><span><code class=\"hljs\">gcloud run jobs describe my-job \\\n  --platform=managed \\\n  --region=asia-northeast1\n<\/code><\/span><\/pre>\n\n\n<h3 class=\"wp-block-heading\"><code>gcloud run jobs execute<\/code><\/h3>\n\n\n\n<p>Run the job now.<\/p>\n\n\n<pre class=\"wp-block-code\"><span><code class=\"hljs\">gcloud run jobs execute my-job \\\n  --platform=managed \\\n  --region=asia-northeast1\n<\/code><\/span><\/pre>\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud83d\udd01 8. Alpha\/Beta Commands<\/h2>\n\n\n\n<p>Additional flags and features exist in <code>beta<\/code> or <code>alpha<\/code>:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>gcloud beta run deploy<\/code><\/li>\n\n\n\n<li><code>gcloud beta run services update<\/code><\/li>\n\n\n\n<li><code>gcloud alpha run ...<\/code><\/li>\n<\/ul>\n\n\n\n<p>Install via:<\/p>\n\n\n<pre class=\"wp-block-code\"><span><code class=\"hljs\">gcloud components install beta\ngcloud beta run deploy ...\n<\/code><\/span><\/pre>\n\n\n<p>Shows future enhancements and experimental options not in GA (<a href=\"https:\/\/www.reddit.com\/r\/googlecloud\/comments\/qu84q4\/possible_to_see_equivalent_gcloud_commands_when\/?utm_source=chatgpt.com\" target=\"_blank\" rel=\"noopener\">reddit.com<\/a>, <a href=\"https:\/\/www.youtube.com\/watch?pp=ygUKI2dkY2V0dXRvZQ%3D%3D&amp;v=q8jed3aU_FY&amp;utm_source=chatgpt.com\" target=\"_blank\" rel=\"noopener\">youtube.com<\/a>, <a href=\"https:\/\/cloud.google.com\/sdk\/gcloud\/reference\/run?utm_source=chatgpt.com\" target=\"_blank\" rel=\"noopener\">cloud.google.com<\/a>, <a href=\"https:\/\/www.reddit.com\/r\/googlecloud\/comments\/187mz7z\/is_it_possible_to_run_gcloud_command_inside_a\/?utm_source=chatgpt.com\" target=\"_blank\" rel=\"noopener\">reddit.com<\/a>, <a href=\"https:\/\/stackoverflow.com\/questions\/78589607\/gcloud-run-deploy-vs-gcloud-run-services-update?utm_source=chatgpt.com\" target=\"_blank\" rel=\"noopener\">stackoverflow.com<\/a>, <a href=\"https:\/\/cloud.google.com\/sdk\/gcloud?utm_source=chatgpt.com\" target=\"_blank\" rel=\"noopener\">cloud.google.com<\/a>)<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud83d\udee0\ufe0f 9. Global Options<\/h2>\n\n\n\n<p>Common flags available to all commands:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>--project=PROJECT_ID<\/code><\/li>\n\n\n\n<li><code>--platform=[managed|gke]<\/code><\/li>\n\n\n\n<li><code>--region=REGION<\/code><\/li>\n\n\n\n<li><code>--format=[json|table|yaml|value]<\/code><\/li>\n\n\n\n<li><code>--filter=...<\/code><\/li>\n\n\n\n<li><code>--verbosity=[debug|info]<\/code><\/li>\n\n\n\n<li><code>--async<\/code> (non-blocking execution)<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\u2705 TL;DR: Quick Reference<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Category<\/th><th>Command<\/th><th>Use Case<\/th><\/tr><\/thead><tbody><tr><td>Deploy<\/td><td><code>gcloud run deploy<\/code><\/td><td>Create\/update service with container or source<\/td><\/tr><tr><td>Manage<\/td><td><code>gcloud run services list\/describe<\/code><\/td><td>View services and metadata<\/td><\/tr><tr><td>Update Config<\/td><td><code>gcloud run services update<\/code><\/td><td>Change service settings without redeploy<\/td><\/tr><tr><td>Revisions<\/td><td><code>gcloud run revisions list\/describe<\/code><\/td><td>Inspect immutable deployment snapshots<\/td><\/tr><tr><td>IAM<\/td><td><code>add\/remove\/get-iam-policy-binding<\/code><\/td><td>Manage access permissions<\/td><\/tr><tr><td>Jobs<\/td><td><code>gcloud run jobs list\/describe\/execute<\/code><\/td><td>Run batch jobs with Cloud Run<\/td><\/tr><tr><td>Metadata format<\/td><td><code>--format=<\/code><\/td><td>Get output as JSON\/YAML\/fields<\/td><\/tr><tr><td>Filtering<\/td><td><code>--filter=<\/code><\/td><td>Query services or revisions dynamically<\/td><\/tr><tr><td>Async execution<\/td><td><code>--async<\/code><\/td><td>Don\u2019t wait for operations to complete<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Here\u2019s a comprehensive guide to all gcloud run subcommands with examples and explanations: \ud83d\udce6 1. Deploying Services gcloud run deploy Create or update a fully-managed service. \ud83d\udee0\ufe0f 2. Managing Services&#8230; <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[2],"tags":[],"class_list":["post-49632","post","type-post","status-publish","format-standard","hentry","category-uncategorised"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49632","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=49632"}],"version-history":[{"count":1,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49632\/revisions"}],"predecessor-version":[{"id":49633,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49632\/revisions\/49633"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=49632"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=49632"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=49632"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}