Skip to content

docs: add Rust deploy guide and runnable example for Datum compute#131

Open
scotwells wants to merge 1 commit into
mainfrom
docs/deploy-guide-rust
Open

docs: add Rust deploy guide and runnable example for Datum compute#131
scotwells wants to merge 1 commit into
mainfrom
docs/deploy-guide-rust

Conversation

@scotwells
Copy link
Copy Markdown
Contributor

@scotwells scotwells commented Jun 2, 2026

What this adds

A complete, runnable path for a developer to take a Rust HTTP service from source to a live, reachable Instance on Datum compute.

  • Guide at docs/guides/deploy-a-rust-app.md — the step-by-step walkthrough: write the service, package it as a Unikraft unikernel with kraft, deploy with datumctl compute, and verify the Instance is serving traffic.
  • Ready-to-deploy example at examples/hello-rust/ — every file the guide describes, materialized so a developer can clone the folder and go straight from source to a running Instance:
    • src/main.rs — the std-only Rust HTTP service
    • Cargo.toml — release profile tuned for a small static binary
    • Dockerfile — static, position-independent (PIE) musl build with a self-check that fails fast on a wrong-shaped binary
    • Kraftfile — Unikraft Cloud packaging config
    • workload.yaml — the Datum Workload manifest
    • README.md — one-line description, link back to the guide, and the build/deploy commands

Developer experience

Clone examples/hello-rust/, run the kraft cloud ... deploy --no-start build, then datumctl compute deploy -f workload.yaml -y, and curl the resulting Instance. No copy-pasting from the guide required — the example is the guide, made real.

🤖 Generated with Claude Code

@scotwells scotwells force-pushed the docs/deploy-guide-rust branch from ac498fa to b087a7e Compare June 2, 2026 20:43
@scotwells scotwells changed the title docs: add guide for deploying a Rust service on Datum compute docs: add Rust deploy guide and runnable example for Datum compute Jun 2, 2026
@scotwells scotwells force-pushed the docs/deploy-guide-rust branch from b087a7e to 5deb55e Compare June 2, 2026 20:54
@scotwells scotwells requested review from a team and savme June 2, 2026 21:44
@scotwells scotwells added the documentation Improvements or additions to documentation label Jun 2, 2026
Copy link
Copy Markdown

@ecv ecv left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it is with a heavy heart i agree we should allow rustaceans to use the platform

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants