frodera/awesome-cloudrun

👓 ⏩ A curated list of resources about all things Cloud Run

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, ✏️: interactive tutorial

Documentation

• 📙 Official Documentation
• 📰 Community driven FAQ
• 🎬 Playlist of recommended Cloud Run videos
• 🎬 Serverless Toolbox Playlist

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)

Run popular languages and stacks

Languages

• Node.js
  • 📦 Hello World
  • 📦 Node.js and Cloud SQL
  • 📰 Node.js web app
• 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
• Java:
  • 📦 SpringBoot
  • 📦 Micronaut sample
  • 📦 Micronaut with GraalVM
  • 📦 Micronaut with GraalVM
  • 📦 Launching/installing a Micronaut app with Cloud Shell
  • 📰 Java web app
  • 📰 Java Logging with Stackdriver
  • Quarkus:
    • 📰 Quarkus tutorial
    • 📦 Quarkus with GraalVM (extracting text from PDF files)
• 📦 Shell
• 📦 Scala
• 📦 Clojure
• Dart
  • 📦 Dart
  • 📰 Dart is ready for FaaS with Cloud Run
• Elixir:
  • 📦 Elixir
  • 🎬 Elixir
• 📦 Haskell
• 📦 Rust
• C# and .NET
  • 📦 C#
  • 📰 C# backend (for a Unity game)
• 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
• 📦 Nim
• 📦 Pascal
• Static files:
  • 📦 Static files
  • 📰 Static website in 5 minutes using nginx.
  • 📰 How to Run a Static Site On Google Cloud Run?
  • 📙 Firebase Hosting is likely a better option

Popular stacks

• 📰 Build and deploy serverless Node.js dockerized API
• 🎬 Nuxt.js and Firebase Hosting (video)
• 📰 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
• 📰 Facebook chatbot
• 📰 TensorFlow
• Headless Chrome
  • 📰 Python
  • 📦 Node.js (with puppeteer)

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

Tutorials

• 📰+📦 Step by step of many Cloud Run concepts

Containers

• 📰 Multiple processes in a container

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)

Security

• 📰 Help! I forgot to click "Allow unauthenticated invocations"
• 📰 Using per service Identity and encrypting secrets
• 📰 Cloud Run with static outgoing IP

Local development

• 📙 Using Docker
• 📰 Using Docker Compose

Migration

• 📰 Migrating Node.js apps from Heroku to Cloud Run

Networking

• 📰 Serverless gRPC with Cloud Run
• 📰 Authenticating with gRPC on Cloud Run
• 📰 gRPC Authentication with Cloud Run

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.

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.
  • 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.
• 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

Fun

• 📦 DOOM on Cloud Run: Play DOOM over HTTP
• 📦 Python 1.x on Cloud Run
• 📦 Fortran 90 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!)