Skip to content

docs: add PHP deploy guide and runnable example for Datum compute#134

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

docs: add PHP deploy guide and runnable example for Datum compute#134
scotwells wants to merge 1 commit into
mainfrom
docs/deploy-guide-php

Conversation

@scotwells

@scotwells scotwells commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a complete, product-focused guide for deploying a PHP web service on Datum compute, taking a developer from source code to a live, reachable Instance. Alongside the prose, this PR ships a ready-to-deploy example so users can clone and run it without copying snippets by hand.

What's included

  • Guide at docs/guides/deploy-a-php-app.md — walks through writing the app, packaging it as a Unikraft unikernel image with kraft, publishing to the metro registry, deploying with datumctl compute deploy, verifying the running Instance, updating, and cleaning up. Includes a troubleshooting section covering the common boot, image-pull, and scheduling failure modes.
  • Runnable example at examples/hello-php/ — the same files the guide describes, ready to deploy as-is:
    • server.php — the PHP HTTP service
    • Dockerfile — builds the trimmed shared-library closure the unikernel needs
    • Kraftfile — Unikraft Cloud packaging
    • workload.yaml — the Datum compute Workload manifest
    • README.md — one-line description, link back to the guide, and the key build + deploy commands

The guide links to the example, and the example links back to the guide, so a reader can move between the explanation and the working files in either direction.

🤖 Generated with Claude Code

@scotwells scotwells force-pushed the docs/deploy-guide-php branch from 7b3fbf6 to fab1589 Compare June 2, 2026 20:43
@scotwells scotwells changed the title docs: add guide for deploying a PHP service on Datum compute docs: add PHP deploy guide and runnable example for Datum compute Jun 2, 2026
@scotwells scotwells force-pushed the docs/deploy-guide-php branch from fab1589 to 12b3fa5 Compare June 2, 2026 20:55
@scotwells scotwells force-pushed the docs/deploy-guide-php branch from 12b3fa5 to 8288bdf Compare June 2, 2026 20:58
@scotwells scotwells requested review from a team, kevwilliams and savme June 2, 2026 23:05
@scotwells scotwells added the documentation Improvements or additions to documentation label Jun 2, 2026
@ecv

ecv commented Jun 3, 2026

Copy link
Copy Markdown

so help me god if this ends with datum running PHP apps at massive scale

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