yoroshikun / shuttle

Deploy Rust apps with a single Cargo command

Home Page:https://shuttle.rs

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


docs language build status discord


shuttle

Shuttle is a Rust-native cloud development platform that lets you deploy your Rust apps for free.

Shuttle is built for productivity, reliability and performance:

  • Zero-Configuration support for Rust using annotations
  • Automatic resource provisioning (databases, caches, subdomains, etc.) via Infrastructure-From-Code
  • First-class support for popular Rust frameworks (Rocket, Axum, Tide, Poem and Tower)
  • Support for deploying Discord bots using Serenity
  • Scalable hosting (with optional self-hosting)

πŸ“– Check out our documentation to get started quickly: docs.shuttle.rs

⭐ If you find shuttle interesting, consider starring this repo to help spread the word.

πŸ™‹β€β™‚οΈ If you have any questions, join our Discord server.

Getting Started

Run the following command to install shuttle:

cargo install cargo-shuttle

And then login:

cargo shuttle login

To initialize your project, simply write:

cargo shuttle init --axum hello-world

And to deploy it, write:

cargo shuttle project new
cargo shuttle project status // until the project is "ready"
cargo shuttle deploy

And that's... it.

$ cargo shuttle deploy
   Finished dev [unoptimized + debuginfo] target(s) in 1m 01s

        Project:            hello-world
        Deployment Id:      3d08ac34-ad63-41c1-836b-99afdc90af9f
        Deployment Status:  DEPLOYED
        Host:               hello-world.shuttleapp.rs
        Created At:         2022-04-01 08:32:34.412602556 UTC

Feel free to build on-top of the generated hello-world boilerplate or take a stab at one of our examples.

For the full documentation, visit our docs.

Contributing to shuttle

Contributing to shuttle is highly encouraged!

If you want to setup a local environment to test code changes to core shuttle packages, or want to contribute to the project check out our docs.

Even if you are not planning to submit any code; joining our Discord server and providing feedback helps us a lot!

Roadmap

For a comprehensive view of the shuttle roadmap check out this project board.

If you have any requests or suggestions feel free to open an issue.

Community & Support

  • Community Forum. Best for: help with building, discussion about best practices.
  • GitHub Issues. Best for: bugs and errors you encounter using Shuttle.
  • Discord. Best for: sharing your applications and hanging out with the community.
  • Twitter. Best for: keeping up with announcements and releases.

Status

  • Alpha: We are testing Shuttle, API and deployments may be unstable
  • Public Alpha: Anyone can sign up, but go easy on us, there are a few kinks
  • Public Beta: Stable enough for most non-enterprise use-cases
  • Public: Production-ready!

We are currently in Public Alpha. Watch "releases" of this repo to get notified of major updates!

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Ben

πŸ“ πŸ› πŸ’» ⚠️

Casey Bailey

πŸ› πŸ“–

Christos Hadjiaslanis

πŸ“ πŸ’» πŸ‘€ ⚠️ πŸ“Ή πŸ›

Damien

πŸ› πŸ’» πŸ“– πŸ” πŸ‘€ ⚠️

David Laban

πŸ› πŸ’» ⚠️

Ivan

πŸ“ πŸ› πŸ’» ⚠️

Lilian Anatolie Moraru

πŸ–‹

Luis CossΓ­o

πŸ’» ⚠️

Mario Idival

πŸ’» ⚠️

Matthew Aylward

πŸ’» ⚠️

Max

πŸ› πŸ’» πŸ’‘ πŸ‘€ ⚠️

Nahua

πŸ› πŸ’» ⚠️

Nodar Daneliya

πŸ’Ό πŸ”

OddbjΓΈrn GrΓΈdem

πŸ’» ⚠️

Pieter

πŸ› πŸ’» πŸ’‘ πŸ§‘β€πŸ« πŸ‘€ ⚠️ πŸ“–

Tsotne Nazarashvili

πŸ–‹

Xavientois

πŸ› πŸ’» ⚠️

jmwill86

πŸ› πŸ“– ⚠️ πŸ’»

This project follows the all-contributors specification. Contributions of any kind welcome!

About

Deploy Rust apps with a single Cargo command

https://shuttle.rs

License:Apache License 2.0


Languages

Language:Rust 79.8%Language:TypeScript 14.3%Language:HCL 3.6%Language:Shell 0.7%Language:JavaScript 0.6%Language:Makefile 0.5%Language:Dockerfile 0.3%Language:CSS 0.1%Language:Nix 0.1%