shuttle_service
source link: https://docs.rs/shuttle-service/0.2.6/shuttle_service/
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
Shuttle - Deploy Rust apps with a single Cargo subcommand
Hello, and welcome to the shuttle API documentation!
Shuttle is an open-source app platform that uses traits and annotations to configure your backend deployments.
Usage
Depend on shuttle-service
in Cargo.toml
:
shuttle-service = { version = "0.2", features = ["web-rocket"] }
and make sure your crate has a cdylib
output target:
[lib]
crate-type = ["cdylib"]
See the shuttle_service::main macro for more information on supported services - like Axum. Here’s a simple example using rocket to get you started:
#[macro_use]
extern crate rocket;
use rocket::{Build, Rocket};
#[get("/hello")]
fn hello() -> &'static str {
"Hello, world!"
}
#[shuttle_service::main]
async fn init() -> Result<Rocket<Build>, shuttle_service::Error> {
let rocket = rocket::build().mount("/", routes![hello]);
Ok(rocket)
}
Complete examples can be found in the repository.
Deploying
You can deploy your service with the cargo shuttle
subcommand. To install run:
$ cargo install cargo-shuttle
in a terminal. Once installed, run:
$ cargo shuttle login
this will open a browser window and prompt you to connect using your GitHub account.
Then, deploy the service with:
$ cargo shuttle deploy
Your service will immediately be available at {crate_name}.shuttleapp.rs
. For example:
$ curl https://hello-world-rocket-app.shuttleapp.rs
Hello, world!
Using sqlx
Here is a quick example to deploy a service which uses a postgres database and sqlx:
Depend on shuttle-service
in Cargo.toml
:
shuttle-service = { version = "0.2", features = ["web-rocket", "sqlx-postgres"] }
#[macro_use]
extern crate rocket;
use rocket::{Build, Rocket};
use sqlx::PgPool;
struct MyState(PgPool);
#[get("/hello")]
fn hello(state: &State<MyState>) -> &'static str {
// Do things with `state.0`...
"Hello, Postgres!"
}
#[shuttle_service::main]
async fn rocket(pool: PgPool) -> Result<Rocket<Build>, shuttle_service::Error> {
let state = MyState(pool);
let rocket = rocket::build().manage(state).mount("/", routes![hello]);
Ok(rocket)
}
To learn more about shuttle managed services, see shuttle_service::main.
Configuration
The cargo shuttle
command can be customised by creating a Shuttle.toml
in the same location as your Cargo.toml
.
Getting API keys
After you’ve installed the cargo-shuttle command, run:
$ cargo shuttle login
this will open a browser window and prompt you to connect using your GitHub account.
Change the name of your serviceTo have your service deployed with a different name, add a name
entry in the Shuttle.toml
:
name = "hello-world"
If the name
key is not specified, the service’s name will be the same as the crate’s name.
We’re in alpha 🤗
Thanks for using shuttle! We’re very happy to have you with us!
During our alpha period, API keys are completely free and you can deploy as many services as you want.
Just keep in mind that there may be some kinks that require us to take all deployments down once in a while. In certain circumstances we may also have to delete all the data associated with those deployments.
To stay updated with the release status of shuttle, join our Discord!
Join Discord
If you have any questions, join our Discord server. There’s always someone on there that can help!
You can also open an issue or a discussion on GitHub.
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK