Awesome Cloud Run

A curated list of resources about all things Cloud Run. Feel free to send Pull Requests!

Inspired by the awesome list project.

Short link to product page: https://cloud.run

Cloud Run is on Stackshare and StackOverflow

Legend: 📙: doc, 📰: article, 📦: sample, 🎬: video, 🖼️: slides, ✏️: interactive tutorial, 🎧 : audio, 🛠️: tool

Documentation

• 📙 Official Documentation
• 📰 Community driven FAQ

Quickstarts

• 📙 2min: Deploy a prebuilt sample container
• 📙 10min: Build and deploy your favorite language (includes many samples and Dockerfiles)

Interactive tutorials

• ✏️ Serverless quest on Google Cloud training
• ✏️ Hello Cloud Run Codelab (use your own GCP account)
• ✏️ Hello Cloud Run Qwiklab (use temp Qwiklabs resources)
• ✏️ Cloud Run 101 (no project needed)
• ✏️ Serverless Workshop Codelab

Run popular languages and stacks

Languages

• Node.js
  • 📦 Hello World
  • 📦 Node.js and Cloud SQL
  • 📰 Node.js web app
• 📰 Deno
• Go
  • 📰 Running a serverless Go web application
  • 📦 Go
• 📦 Python
• 📦 Ruby
• 📦 PHP
  • 📦 Hello World
  • 📦 Laravel
  • 📦 Laravel 6 - 📰 Blog post
  • 📦 Symfony - 📰 Blog post
• Kotlin:
  • 📦 Kotlin Knative sample
  • 📦 Kotlin with Ktor
  • 📦 Kotlin Spring Boot
• Java:
  • 📦 Spring Boot
  • 📦 Micronaut sample
  • 📦 Micronaut with GraalVM
  • 📦 Micronaut with GraalVM
  • 📦 Launching/installing a Micronaut app with Cloud Shell
  • 📦 Deploying a Java 14 based Micronaut application
  • 📰 Java web app
  • 📰 Java Logging with Stackdriver
  • Quarkus:
    • 📰 Quarkus tutorial
    • 📦 Quarkus with GraalVM (extracting text from PDF files)
• Shell
  • 📦 Shell Knative sample
  • 📦 sh server
• 📦 Scala
• 📦 Clojure
• Dart
  • 📦 Dart
  • 📰 Dart is ready for FaaS with Cloud Run
• Elixir:
  • 📦 Elixir
  • 🎬 Elixir
• 📦 Haskell
• Rust
  • 📦 Rust Knative sample
  • 📦 Rust sample
• C# and .NET
  • 📦 C#
  • 📰 C# backend (for a Unity game)
  • 📰 Running with C# on GCP Cloud Run
• Swift
  • 📦 helloworld-swift
  • 📦 SwiftCloudRun
  • 📰 Deploy Swift Hello World in 5 minutes
  • 📰 Serverless Server-side Swift using Google Cloud Run
• R
  • 📦 R Hello World with Plumber
  • 📦 R Hello World
  • 📦 R Knative Hello World
  • 📰 Serverless R functions with Cloud Run
  • 📰 Serverless Machine Learning with R on Cloud Run
• 📦 Nim
• 📦 Pascal

Popular stacks

• 📰 Build and deploy serverless Node.js dockerized API
• 🎬 Nuxt.js and Firebase Hosting (video)
• 📰 NestJS on Google Cloud Run
• 📰 Ruby on Rails real life example
• 📰 Rust REST API with Diesel, Rocket, and MySQL
• 📰 GraphQL API
• 📰 Hugo blog
• 📰 Apache NiFi workflows
• 📰 Camunda BPM
• 📰 Webmention
• Wordpress
  • 📰 Wordpress site on Google Cloud Run
  • 📰 WordPress in a GCP Cloud Run instance with Cloud SQL
• 📰 Facebook chatbot
• 📰 TensorFlow
• Headless Chrome
  • 📰 Python
  • 📦 Node.js (with puppeteer)
• 📰 Hosting Azure Functions in Google Cloud Run
• 📦 FastAPI, PostgreSQL, Secrets Manager, and Cloud Build
• 📰 OpenFaaS Functions on Cloud Run for free
• 📰 Ghost

Articles

• 📰 Cloud Run: Bringing serverless to containers
• 📰 Google Cloud Run — Deploying Containerized Applications to a Serverless Environment ⚡
• 📰 Powerful serverless with Cloud Run
• 📰 The best features of Google Cloud Run
• 📰 3 cool Cloud Run features that developers love
• 📰 Cloud Run and Cloud Function: What I use? And Why?
• 📰 Minimizing Cold Starts
• 📰 Cloud Run VS Cloud Functions: What’s the lowest cost?
• 📰 12 factor apps and Cloud Run
• 📰 Migrating to Google Cloud Run Serverless Container Platform
• 📰 Say hello to serverless containers with Cloud Run
• 📰 Functions Framework on Cloud Run
• 📰 5 compelling reasons to opt for serverless containers
• 📰 Google Cloud Run: What every IT Ops team should know
• 🎬 From 0 to working Serverless URL for a Containerized app with Google Cloud Run
• 🖼️ Going Serverless with Google Cloud Run
• 📰 3 Reasons Why Google Cloud Run is Different
• 📰 5 compelling reasons to opt for serverless containers
• 📰 Cloud Run vs. AWS Lambda: Is Cloud Run a Serverless Game Changer? Part 1, Part 2, Part 3
• 🎬 Awesome Serverless using Google Cloud Run

Podcast episodes

• 🎧 GCP Podcast - Episode 173. Cloud Run with Steren Giannini and Ryan Gregg

Tutorials

• 📰+📦 Step by step of many Cloud Run concepts
• 🎬+📦 Deploying a CI/CD Nuxt.js site in universal mode with Google Cloud Run and Cloud Build

Private microservices

• 📰 Making requests with a Service Account
• 📰 Service-to-service authentication

Async and events

• 📙 Sending Pub/Sub events to Cloud Run by Google Cloud
• 📰 Using a Cloud Run service as async worker
• 📰 Cloud Run as an internal async worker
• 📰 Using Cloud Run as a webhook for Actions on Google
• 📰 Use Cloud Run to pre-process raw events from PubSub and publish them to new topic
• 📰 (hack) Run long background tasks (not recommended)

CDN / Static file hosting

• 📰 Firebase hosting and Cloud Run cache
• 🎬 Deploy Python on Firebase Hosting with Cloud Run - Firecasts
• 📙 Firebase Hosting and Cloud Run docs
• 📙 Cloud CDN via Cloud Load Balancing and Serverless NEGs

Security

• 📰 Help! I forgot to click "Allow unauthenticated invocations"
• 📰 Using per service Identity and encrypting secrets
• 📰 Secret Manager: Improve Cloud Run security without changing the code
• 📰 Cloud Run with static outgoing IP
• 📦 Vault on Cloud Run (using Terraform)
• 📦 [Vault on Cloud Run] https://github.com/kelseyhightower/serverless-vault-with-cloud-run

Storing Data

• 📰 Using Memorystore with Cloud Run

Local development

• 📙 Using Docker
• 📰 Using Docker Compose

Migration

• 🛠️ App Engine to Cloud Run migration tool
• 📰 Migrating Node.js apps from Heroku to Cloud Run

Networking and load balancing

• 📰 Serving users from multiple regions with Cloud Run
• 📰 Multi Region Load Balancing with GO and Google Cloud Run
• gRPC
  • 📰 Serverless gRPC with Cloud Run
  • 📰 Authenticating with gRPC on Cloud Run
  • 📰 gRPC Authentication with Cloud Run
  • 📰 Cloud Run service with gRPC Using Spring Boot
  • 📰 gRPC comes to Cloud Run
  • 📙 Invoking with gRPC

Help

• 📙 Troubleshooting guide
• Use the google-cloud-run tag on StackOverflow

Building containers

Container tools

• Docker: docker build . --tag gcr.io/[PROJECT-ID]/[IMAGE] then docker push gcr.io/[PROJECT-ID]/[IMAGE]
• Google Cloud Build: pay-per-use cloud-based docker and custom builds
• Buildpacks: pack build to transform apps in popular languages to container images.
• Java Jib: Build container images for your Java applications.
• R containerit: Package R script/session/workspace and all dependencies as a Docker container.
• kontain.me to build container images on the fly from GitHub, Go packages, or mirror DockerHub

Container guides

• Dockerfile Best Practices

Tools

• Terraform:
  • 📰 Configuring Cloud Run with Terraform
  • 📙 google_cloud_run_service to manage your Cloud Run services as Code.
• Secrets:
  • 📙 Google Cloud Secret Manager: Recommended Use its client libraries to consume secrets from Cloud Secret Manager ins Cloud Run services (see 📰 Cloud Run and Clodu Secret manager tutorial)
  • Berglas unofficial tool to manage secrets on Google Cloud
  • konfig to use Kubernetes configmaps and secrets with Cloud Run
• Cloud Run Button: Add a deploy button to a README to enable two-click deployment of a repo
• cloudRunner: As easy as possible R scripts in the cloud, via Cloud Run, Cloud Build and Cloud Scheduler.
• cloud-run-compose: Deploy docker-compose configurations to Cloud Run.
• Pulumi:
  • 📰 Pulumi: intro to Build, deploy and manage Cloud Run services using your favorite language with Pulumi.
  • 📦 Typescript sample: example of deploying a custom Docker image into Google Cloud Run service using TypeScripe.

CI/CD

• Using Cloud Build:
  • Official docs
  • Awesome Cloud Build
  • Simplified Continuous Deployment on Google Cloud Platform
  • Continuous Deployment to Cloud Run Services based on a New Container Image
  • How to deploy a webapp to Google Cloud Run with Cloud Build
• Using Semaphore
• GitLab
  • 📰 Using GitLab
  • 📰 GitLab CI / CD to Cloud Run
• Using Travis CI
• Using Bitbucket Pipelines
• Using GitHub Actions:
  • 📰 Deploying projects to Cloud Run using GitHub Actions
  • 📰 Publish your Cloud Run App with GitHub Actions
  • 📰 Automate Cloud Run deployment in a minute (with GitHub actions)
  • Github Action for Google Cloud Run

Integrations

• Firebase Hosting: Static files, advanced path-based routing, and global CDN for Cloud Run
• Twilio
  • 📦 Create a TwiML app to trigger a Cloud Run service from SMS message: Create a TwiML app to trigger a Cloud Run service from SMS message.
  • 📰 Build paperless remote friendly process with Go, Twilio and Google Cloud Run
• Flic buttons: How to use Flic buttons with Cloud Run and Cloud PubSub
• Datasette: Publish your Datasette to Cloud Run.

Samples and microservices

Useful

• 📦 pdf: Transform Word documents to PDF.
• 📦 screenshot: Take screenshots of webpages using Chromium via puppeteer
• 📦 render: Render a Blender 3D scene with custom text.
• 📦 meme: Generate meme images from a base image and text.
• 📦 trace: Transform pixel images to SVG.
• 📦 inkscape: Transform SVG images to PNG.
• 📦 gcr-cleaner: Delete untagged image refs in Google Container Registry, as a service
• 📦 buildstatus Cloud Build status notifications in Slack using Cloud Run
• 📦 serverless-registry-proxy: Generic serverless docker-registry v2 proxy (e.g. GCR.io on custom domains)
• 📦 plantuml-image-converter: UML diagrams to images
• 📦 .xlsx parser
• 📦 GitHub activity counter
• 📦 django-demo-app-unicodex: Django in Cloud Run with Cloud SQL and Cloud Storages.
• 📦 ytdl: Serverless video downloader
• 📦 microurl: Url shortener and code snippet sharing tool
• 📦 tweethingz: Twitter follower histogramc
• 📦 datastore-cleaner: Automatically clean up old Google Cloud Datastore entities.
• 📦 Domain redirector
• 📦 Badger generates build status images based on Cloud Build status info.
• 📦 hasura: GraphQL server.
• 📦 odoo: Open Source ERP
• 📰 Telegram bots on Cloud Run

Fun

• 📦 DOOM on Cloud Run: Play DOOM over HTTP
• 📦 Python 1.x on Cloud Run
• 📦 Fortran 90 on Cloud Run
• 📦 COBOL on Cloud Run
• 📰 45-year old Pascal program on Cloud Run
• 📦 ih-aas: Generate cross-stitch patterns from image uploads.

Cloud Run API

• 📙 REST API Reference
• 📰 Understanding the APIs
• 📰 knative.tips Pragmatic, example-oriented introduction to Knative API

Meetups

Meetup material

• Cloud Run hexagon logo
• 🖼️ Cloud Run Club slide deck (feel free to re-use it!)