3 releases
new 0.0.2 | Mar 15, 2025 |
---|---|
0.0.1 | Dec 26, 2024 |
0.0.0 | Dec 26, 2024 |
#40 in #deployment
29KB
436 lines
cargo-cloudrun
cargo-cloudrun is a command-line tool for deploying Rust applications to Google Cloud Run. It wraps the gcloud
CLI to simplify the deployment process—no manual Docker builds or direct interaction with the Google Cloud Console required.
Inspired by the ergonomics of cargo-lambda
, cargo-cloudrun can be used to create Cloud Run services that handle HTTP requests or event triggers in a function-like style.
It also supports monolithic Rust applications.
It uses google-cloudevents to handle cloud events from the axum runtime.
This is nessesary for cloud events but cargo cloudrun can be used with any runtime. as long as it binds to port 8080
.
Features
-
Easy Deployments
Deploy Rust applications to Cloud Run with a single command (cargo cloudrun deploy
)—no Dockerfiles or manual steps needed. -
HTTP & Event Support
Similar to Cloud Run Functions, you can build services that handle HTTP requests or respond to events. -
Monolithic or Microservice
Works equally well for single-crate monoliths or multi-crate, microservice-style architectures. -
No Docker Skills Needed
Under the hood, cargo-cloudrun uses thegcloud
CLI and automatically manages Docker images for you.
Quick Start
Install cargo-cloudrun
:
cargo install cargo-cloudrun
Usage
cargo cloudrun new my-service
cd my-service
cargo cloudrun deploy
Dependencies
~7–16MB
~190K SLoC