Rust Greeter

A rust-lang demo on building API using axum.

The demo application will be crossed compiled into,

• [x] linux/arm64 (aarch64-unknown-linux-musl)
• [x] linux/amd64 (x86_64-unknown-linux-musl)

The demo uses cargo-zigbuild as tool for cross compilation.

Pre-requisites

• Docker Desktop
• rust-lang
• drone cli
• Taskfile

Building Locally

shell cargo build

Start the server,

shell ./target/debug/rgreeter

Testing

Open a new terminal Start the application to run integration tests,

shell PORT=8080 cargo run

On another terminal run,

shell cargo test

Testing Application

Once the server is up you can try the following REST URIs,

• Default curl http://localhost:3000/ returns Hello World!
• Greeting: curl http://localhost:3000/greet returns Hello! Anonymous!
• Greeting a person: curl http://localhost:3000/greet?name=Jack returns Hello! Jack!

Build and Push Image to Docker Registry

Create a file .env under $PROJECT_HOME,

NOTE: You can copy the file .env.example to .env and update with your setting

shell PLUGIN_USERNAME=<container registry username> PLUGIN_PASSWORD=<container registry password> PLUGIN_REPO=<container image repo to push image> PLUGIN_REGISTRY=<container registry to use>

e.g.

shell PLUGIN_USERNAME=octocat PLUGIN_PASSWORD=octocat registry password PLUGIN_REPO=ghcr.io/octocat/rgreeter PLUGIN_REGISTRY=ghcr.io

shell task ci

Once the image is pushed run the following command,

shell docker-compose up

Find the exposed port using the command docker ps and test the application the URIs.

NOTE: If the port 8080 is not available on your machine, try using other ports.