tanhaa / 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

Documentation

• 📙 Official Documentation
• 📰 Community driven FAQ

Quickstarts

• 📙 Build and Deploy Quickstart (includes many samples and Dockerfiles)
• Hello Cloud Run Codelab (use your own GCP account)
• Hello Cloud Run Qwiklab (use temp Qwiklabs resources)

Hello World and samples

Languages

• Node.js
  • 📦 Hello World
  • 📦 Node.js and Cloud SQL
  • 📰 Node.js web app
• 📦 Go
• 📦 Python
• 📦 Ruby
• 📦 PHP
  • 📦 Laravel
• 📦 Kotlin
• Java:
  • 📦 SpringBoot
  • 📦 Micronaut sample
  • 📦 Micronaut with GraalVM
  • 📦 Launching/installing a Micronaut app with Cloud Shell
  • 📰 Java web app
  • 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 (video)
• 📦 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
  • 📰 Serverless R functions with Cloud Run
• 📦 Nim
• 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
• Multiple processes in a container
• TensorFlow

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

Tutorials

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
• 📰 Hacking Google Cloud Run (Run long background tasks)

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

Help

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

Building containers

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.

Guides

• Dockerfile Best Practices

Tools

• Secrets:
  • Berglas unofficial tool to manage secrets on Google Cloud
  • konfig to use Kubernetes configmaps and secrets with Cloud Run
• GCR Cleaner: Delete untagged image refs in Google Container Registry, as a service
• Cloud Run Button: Add a deploy button to a README to enable two-click deployment of a repo
• buildstatus Cloud Build status notifications in Slack using Cloud Run

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
• Using GitLab
• 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

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

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-custom-domains: Expose gcr.io container registries on your custom domain names.
• 📦 plantuml-image-converter: UML diagrams to images
• 📦 .xlsx parser
• 📦 GitHub activity counter

Fun

• 📦 DOOM on Cloud Run: Play DOOM over HTTP
• 📦 Python 1.x on Cloud Run
• 📦 Fortran 90 on Cloud Run

Cloud Run API

• 📙 REST API Reference
• 📰 Understanding the APIs

Meetups

Meetup material

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