Run a Rust Rocket app
This example uses Rocket
, a popular Rust web framework.
To run this example, follow these steps:
-
Install the
kraft
CLI tool and a container runtime engine, e.g. Docker. -
Clone the
examples
repository andcd
into theexamples/http-rust1.75-rocket0.5/
directory:
Make sure to log into KraftCloud by setting your token and a metro close to you.
We use fra0
(Frankfurt, π©πͺ) in this guide:
When done, invoke the following command to deploy this application on KraftCloud:
The output shows the instance URL and other details:
In this case, the instance name is http-rust175-rocket05-tuwq3
and the URL is https://empty-bobo-n3htmpye.fra0.kraft.host
.
They are different for each run.
Use curl
to query any of the Rocket serverβs paths, for example:
At any point in time, you can list information about the instance:
When done, you can remove the instance:
Customize your Application
To customize the application, update the files in the repository, listed below:
src/main.rs
: the actual serverCargo.toml
: the Cargo package manager configuration fileKraftfile
: the KraftCloud specificationDockerfile
: the Docker-specified application filesystem
The following options are available for customizing the application:
-
If only updating the implementation in the
src/main.rs
source file, no other change is required. -
If new files are added, these have to be copied in the application filesystem, using the
COPY
command in theDockerfile
. If new Rust source code files are added, be sure to configure required dependencies in theCargo.toml
file. -
If a new executable is built, update the
cmd
line in theKraftfile
and replace/server
with the path to the new executable. -
More extensive changes may require expanding the
Dockerfile
with additionalDockerfile
commands.
Learn More
Use the --help
option for detailed information on using KraftCloud:
Or visit the CLI Reference.