Comment on page

Deployment

Because it's a bummer when your laptop runs out of battery and makes your server inaccessible.
Running code locally is all well and good, but how about actually running it on a server somewhere in the cloud? Not many people want to (or have the capability to!) run an always-on home server, so most code is deployed elsewhere. This can be an arduous and annoying process, especially for such a simple server.
Luckily for us, we're writing in rust and have a service called shuttle.rs at our disposal! We'll be able to run our code with very minor changes, in the cloud, easy peasy.
Start off by installing shuttle if you haven't already
cargo install cargo-shuttle
Next, let's add some extra dependencies for shuttle, namely these two:
shuttle-aws-rds = { version = "0.7", features = ["postgres"] }
shuttle-service = { version = "0.7", features = ["web-thruster"] }
These will allow shuttle to hook into our service. It'll also provide a cloud database for us. Integrating with our existing app is super simple, we just add another entrypoint in lib.rs
// Had to add a bunch of dependencies for below
use app::{Ctx, ServerConfig};
use shuttle_service::error::CustomError;
use sqlx::{Executor, PgPool};
use thruster::{HyperServer, ThrusterServer};
​
pub mod app;
pub mod controllers;
pub mod models;
​
// New bit here!
#[shuttle_service::main]
async fn shuttle(
#[shuttle_aws_rds::Postgres] pool: PgPool,
) -> shuttle_service::ShuttleThruster<HyperServer<Ctx, ServerConfig>> {
pool.execute(include_str!("../schema.sql"))
.await
.map_err(CustomError::new)?;
​
let app = app::app(pool).await.expect("Could not create app");
Ok(HyperServer::new(app))
}
​
Believe it or not, that's all the additional setup we need! We just need to run a few shuttle commands now. If you haven't signed in yet, you'll need to run
cargo shuttle login
Then setup a new shuttle project
cargo shuttle project new
Finally, run (you might need --allow-dirty if you haven't been committing using git as you go along!)
cargo shuttle deploy
That's it! You're deployed! Try running the curl commands from earlier and see if they still work (they should! Congrats!)
Next up we'll be making a quick little CLI to automate the generation and retrieval of secrets.