README.md

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)

Courses

• ✏️+📦 Qwiklabs Course - Application Development with Cloud Run
• ✏️+📦 Coursera Course - Application Development with Cloud Run
• ✏️+📦 Pluralsight Course - Application Development with Cloud Run

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)
• ✏️ Serverless Workshop Codelab

Run popular languages and stacks

Languages

• Node.js
  • 📦 Hello World
  • 📦 Node.js and Cloud SQL
  • 📰 Node.js web app
• Deno
  • 📰 Deno on Cloud Run
  • 📰 Deploy a Dockerized Deno App to Google Cloud Run
• Go
  • 📰 Running a serverless Go web application
  • 📦 Go
• 📦 Python
• Ruby
  • 📦 Ruby sample
  • 📙 Running Rails on the Cloud Run
  • ✏️ Ruby on Rails Cloud Run workshop/tutorial with CI/CD
• 📦 PHP
  • 📦 Hello World
  • 📦 Laravel
  • 📦 Laravel 6 - 📰 Blog post
  • 📦 Symfony - 📰 Blog post
• Kotlin:
  • 📦 Kotlin Knative sample
  • 📦 Kotlin with Ktor
  • 📦 Kotlin Spring Boot
  • 🎬 Go full-stack with Kotlin or Dart on Google Cloud
• 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
  • 📦 Samples
  • 📰 Dart is ready for FaaS with Cloud Run
  • 🎬 Go full-stack with Kotlin or Dart on Google Cloud
• 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
• C++
  • 📦 C++ Hello World
  • 📰 C++ Functions Framework

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
• 📰 React + Flask
• 📦 Apache Superset
• 📰 Server-side Google Tag Manager
• 📦 Remix

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
• How to deploy a Django app to Google Cloud Run using Terraform

Podcast episodes

• 🎧 GCP Podcast - Cloud Run with Steren Giannini and Ryan Gregg
• 🎧 GCP Podcast - Serverless, Redefined with Jason Polites
• 🎧 Software Engineering Daily - Cloud Run: Serverless Applications with Steren Giannini
• 🎧 Software Engineering Daily -Serverless Runtimes with Steren Giannini

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)

Custom domain

• Use Firebase Hosting (Recommended for side projects, free of charge)
  • 📙 Add Cloud Run to your Firebase Hosting config
  • 🛠️ Script to set up Firebase Hosting in front of Cloud Run without using the firebase CLI
• Use a Global External HTTPS Load Balancer (Recommended for production setup)
• Use Cloud Run Domain Mappings (Limited availability, in Preview)

CDN / Static file hosting

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

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

Storing Data

• 📰 Cloud Run & CockroachDB Serverless
• 📰 Using Memorystore with Cloud Run
• 📰 Mount a file as a volume in Cloud Run
• 📙 Using Filestore with Cloud Run tutorial
• 📙 Using Cloud Storage FUSE with Cloud Run tutorial

Local development

• 📙 Using Docker
• 📰 Using Docker Compose

Migration

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

Networking and load balancing

• 📰 Serving users from multiple regions with Cloud Run
• 🛠️ runsd: Service discovery (unofficial tool)
• 📰 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
• Ship your Go applications faster to Cloud Run with ko

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
  • 📰 Deploy to Cloud Run using GitLab CI

• Using Travis CI

• Using Bitbucket Pipelines

• Using Drone

• 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)
  • Deploy to Cloud Run - Google GitHub Actions
  • Github Action for Google Cloud Run

• Serverless Jenkins Pipelines with Cloud Run

• Terraform

  • 📙 Google Cloud Secret Manager: Recommended Use its client libraries to consume secregoogle_cloud_run_service terraform resource
  • 📰 Using Terraform To Deploy Application On Google Cloud Run With CI/CD And API Gateway
  • Cloud Run Release Manager: provides an automated way to gradually roll out new versions of your Cloud Run services. By using metrics, it automatically decides to slowly increase traffic to a new version or roll back to the previous one.

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
• 📦 LogPaste A minimalist web service for uploading and sharing log files. (installation instructions)
• 📰 Bokeh
• 📰 Server-Side Google Tag Manager
• 📰 Bazel remote cache on Google Cloud Run & Storage

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
• 📰 Deploying using Go

Meetups

Meetup material

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