Skip to content

docs(platform): Document on-demand instance template creation#128

Open
JeromeJaggi wants to merge 1 commit into
prod-stagingfrom
jeromejaggi/docs-on-demand-templates
Open

docs(platform): Document on-demand instance template creation#128
JeromeJaggi wants to merge 1 commit into
prod-stagingfrom
jeromejaggi/docs-on-demand-templates

Conversation

@JeromeJaggi

Copy link
Copy Markdown
Member

Summary

Adds an "On-demand template creation" sub-section to the Instance Templates section of pages/platform/instances.mdx, explaining how customers can use prepare: true together with create_args so that the platform creates a template the first time it's needed on a node.

This is the recommended pattern when a service runs on more than one node and avoids having to manually copy template snapshot files between hosts.

Background

The feature exists today but wasn't surfaced anywhere in the narrative documentation — only in the OpenAPI schema. A customer recently asked how to handle templated snapshots in horizontal scaling and the answer wasn't findable. This PR closes that gap.

What's added

  • New ### On-demand template creation sub-section under ## Instance templates
  • Explains that templates are per-node
  • Provides the API example with prepare, create_args
  • Lists the four-step controller flow when the template doesn't exist yet on the target node
  • Notes the first-request cost on a fresh node

Verification


This PR was created by an AI agent.

Add an On-demand template creation section explaining how to use
prepare=true and create_args so that templates get created the
first time a node needs them, avoiding manual snapshot copying
between nodes when a service runs on more than one host.

Signed-off-by: Jerome Jaggi <jerome@unikraft.io>
@JeromeJaggi JeromeJaggi temporarily deployed to pull-requests April 29, 2026 07:53 — with GitHub Actions Inactive
@github-actions github-actions Bot temporarily deployed to pull-requests April 29, 2026 07:56 Inactive
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant