Google Cloud Run
This repository contains sample applications for Google Cloud Run, a managed compute platform for running stateless containers. It provides ready-to-run code examples in multiple languages to help developers build, deploy, and troubleshoot Cloud Run services and jobs. It is intended for developers using Cloud Run who need reference implementations for common patterns like logging, Pub/Sub, SQL, and authentication.
✨ Key features
- Sample apps in Go, Node.js, Python, Java, PHP, Ruby, and more
- Covers services, jobs, logging, Pub/Sub, and SQL
- Includes snippets for global state and lazy initialization
- Demonstrates gRPC and service-to-service authenticated requests
- Provides 'broken' sample for troubleshooting
- One-click deploy via Cloud Run Button
🎯 Use cases
- Quickstart deployment of a Hello World service
- Implementing structured logging without a client library
- Handling Pub/Sub push messages in a service
- Connecting Cloud Run to Cloud SQL (MySQL or Postgres)
- Building event-driven image processing pipelines
📦 Installation
🧰 Requirements: Requires a Google Cloud project with Cloud Run enabled and the gcloud CLI for deployment; specific samples may need additional services like Pub/Sub or Cloud SQL.
git clone https://github.com/GoogleCloudPlatform/cloud-run-samples.git
cd cloud-run-samples
Then follow the sample-specific instructions in the README or documentation.
🚀 Usage
# Example: Deploy the Hello World Python sample
gcloud run deploy hello-world \
--source . \
--region us-central1 \
--allow-unauthenticated
(Refer to the sample's README for exact commands.)
⚠️ Good to know
The repository does not accept entirely new samples; only bug fixes are welcome.
❓ FAQ
What languages are supported in the samples?
Samples are available in Go, Node.js, Python, Java, PHP, Ruby, Shell, and C++ for various use cases.
How can I deploy a sample quickly?
Some samples have a Cloud Run Button that opens Cloud Shell and deploys the service with a click.
Are there samples for troubleshooting?
Yes, the 'Hello Broken' sample is intentionally broken to help you practice debugging Cloud Run services.
Can I contribute new samples?
No, entirely new samples are not accepted; only bug fixes are welcome.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.