Rust microservice template

This is a template supposed to be used for rust microservices.

It contains an example implementation of a production user service. Anything related to specific uses may be removed, but the general template should remain the same.

How to use this template

1. Clone it git clone https://github.com/exapsy/rust-microservice.git
2. Make sure you acquire the required dependencies
3. Change the configuration to your liking
4. Change the CHANGELOG.md every time there is a new version.
5. Run cargo run :)

Requirements

• rustup
• rust 1.66.0-nightly

Configurations

Rocket.toml

Rocket.toml is a configuration file that contains the configuration for Rocket http server library. For more information take guidance from the v0.5-rc documentation.

.env (Environment variables)

• GRPC_HOST: the address to listen to for GRPC requests
• DB_NAME: is the name of the database that will be used for this service.
• MONGO_URI: used to specify the mongodb database URI. If not used then no MongoDB connection is set.
• ROCKET_CONFIG: Rocket is the HTTP handler. This value is used to specify the path for the rocket configuration. If not found, rocket will use the default values.

Known bugs

• Graceful shutdown doesn't work properly. Either kill it with kill -9 (SIGKILL) or kill it twice so both HTTP and GRPC threads get killed.