Skip to content

docs: add Ruby deploy guide and runnable example for Datum compute#135

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

docs: add Ruby deploy guide and runnable example for Datum compute#135
scotwells wants to merge 1 commit into
mainfrom
docs/deploy-guide-ruby

Conversation

@scotwells
Copy link
Copy Markdown
Contributor

@scotwells scotwells commented Jun 2, 2026

What this delivers

A complete, copy-pasteable path for a developer to take a Ruby HTTP service from source to a live, reachable Instance on Datum compute.

  • Guide (docs/guides/deploy-a-ruby-app.md): build a Ruby app into a Unikraft unikernel image, publish it to the metro registry, deploy it with datumctl compute deploy, verify the live HTTP response, update, and clean up. Includes a troubleshooting section covering the common Ruby-on-unikernel failure modes (rootfs RAM-disk overflow, missing shared libraries, image-pull and scheduling issues).
  • Runnable example (examples/hello-ruby/): the guide's files materialized as a ready-to-deploy folder so users can clone and ship without copying snippets out of prose:
    • server.rb — the Ruby service (stdlib only)
    • Dockerfile — builds the trimmed Ruby rootfs
    • Kraftfile — Unikraft Cloud packaging
    • workload.yaml — the Datum Workload manifest
    • README.md — one-line description, link back to the guide, and the key build + deploy commands

The guide links out to the example, and the example links back to the guide, so either entry point lands the user in the right place.

🤖 Generated with Claude Code

@scotwells scotwells force-pushed the docs/deploy-guide-ruby branch from 82b9f4c to 030fe77 Compare June 2, 2026 20:44
@scotwells scotwells changed the title docs: add guide for deploying a Ruby service on Datum compute docs: add Ruby deploy guide and runnable example for Datum compute Jun 2, 2026
@scotwells scotwells force-pushed the docs/deploy-guide-ruby branch from 030fe77 to 0a498d1 Compare June 2, 2026 20:55
@scotwells scotwells force-pushed the docs/deploy-guide-ruby branch from 0a498d1 to f6201cd Compare June 2, 2026 20:58
scotwells added a commit that referenced this pull request Jun 2, 2026
The Go, Rust, Node.js, Python, PHP, and Ruby deploy guides and their
runnable examples/ apps have moved to their own focused PRs (#130-#135).
Dropping them here keeps this PR scoped to the ConfigMap/Secret mount
feature and shrinks the diff for reviewers.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@scotwells scotwells added the documentation Improvements or additions to documentation label Jun 2, 2026
@scotwells scotwells requested review from a team and savme June 2, 2026 23:05
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.

what, no 'no ruby'!?

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.

2 participants