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 RunDeploying 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: Whats 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 - 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!)