Skip to content

docs: Add new feature documentation and stubs#115

Open
JeromeJaggi wants to merge 2 commits intoprod-stagingfrom
jeromejaggi/docs-comprehensive-update
Open

docs: Add new feature documentation and stubs#115
JeromeJaggi wants to merge 2 commits intoprod-stagingfrom
jeromejaggi/docs-comprehensive-update

Conversation

@JeromeJaggi
Copy link
Copy Markdown
Member

Summary

Comprehensive documentation update covering new and upcoming platform
features. All content sourced from platform code analysis.

New feature documentation

  • Inline ROMs (roms.mdx): files array, encoding options,
    ephemeral behavior, 16-file / 1KB limits
  • Queued PATCH updates (instances.mdx): queue behavior for
    running instances, supported properties, retry logic
  • Copy-on-write checkpointing (snapshots.mdx): COW fork
    mechanism, async writes, dirty page tracking
  • Volume mount/unmount hooks (volumes.mdx): custom scripts
    for remote storage and encrypted volumes

Feature stubs

  • Continuous checkpointing (snapshots.mdx)
  • Resource controls / cgroups (instances.mdx)
  • Live migration (live-migration.mdx, preview)
  • Sandbox API (sandbox-api.mdx, in development)

Files changed

  • pages/features/roms.mdx (modified)
  • pages/features/snapshots.mdx (modified)
  • pages/platform/instances.mdx (modified)
  • pages/platform/volumes.mdx (modified)
  • pages/features/live-migration.mdx (new)
  • pages/features/sandbox-api.mdx (new)

Review guidance

This PR is intended as a single preview deployment for CEO review
of all new documentation before splitting into individual PRs for
merge.

@JeromeJaggi JeromeJaggi temporarily deployed to pull-requests April 3, 2026 14:46 — with GitHub Actions Inactive
Comment thread pages/platform/volumes.mdx Outdated
- The mount script runs before a volume attaches to an instance.
- The unmount script runs after all instances detach from the volume.

This enables remote storage (NFS, iSCSI), encrypted volumes, and overlay filesystems.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

📝 [vale] reported by reviewdog 🐶
[Microsoft.Acronyms] 'NFS' has no definition.

@github-actions github-actions Bot temporarily deployed to pull-requests April 3, 2026 14:49 Inactive
@JeromeJaggi JeromeJaggi force-pushed the jeromejaggi/docs-comprehensive-update branch from a984ea9 to 1285c3b Compare April 3, 2026 14:52
@JeromeJaggi JeromeJaggi changed the title docs: Add inline ROMs, queued updates, COW checkpointing, and feature stubs docs: Add new feature documentation and stubs Apr 3, 2026
@JeromeJaggi JeromeJaggi temporarily deployed to pull-requests April 3, 2026 14:52 — with GitHub Actions Inactive
@github-actions github-actions Bot temporarily deployed to pull-requests April 3, 2026 14:55 Inactive
@JeromeJaggi JeromeJaggi force-pushed the jeromejaggi/docs-comprehensive-update branch from 1285c3b to 28cd50e Compare April 4, 2026 13:25
@JeromeJaggi JeromeJaggi temporarily deployed to pull-requests April 4, 2026 13:25 — with GitHub Actions Inactive
@github-actions github-actions Bot temporarily deployed to pull-requests April 4, 2026 13:28 Inactive
@JeromeJaggi JeromeJaggi force-pushed the jeromejaggi/docs-comprehensive-update branch from 28cd50e to 8b4201c Compare April 4, 2026 13:29
@JeromeJaggi JeromeJaggi temporarily deployed to pull-requests April 4, 2026 13:29 — with GitHub Actions Inactive
@github-actions github-actions Bot temporarily deployed to pull-requests April 4, 2026 13:32 Inactive
@JeromeJaggi JeromeJaggi force-pushed the jeromejaggi/docs-comprehensive-update branch from 8b4201c to e81fd0f Compare April 4, 2026 13:50
@JeromeJaggi JeromeJaggi temporarily deployed to pull-requests April 4, 2026 13:50 — with GitHub Actions Inactive
@github-actions github-actions Bot temporarily deployed to pull-requests April 4, 2026 13:52 Inactive
@JeromeJaggi JeromeJaggi force-pushed the jeromejaggi/docs-comprehensive-update branch from e81fd0f to af404cf Compare April 4, 2026 14:46
@JeromeJaggi JeromeJaggi temporarily deployed to pull-requests April 4, 2026 14:46 — with GitHub Actions Inactive
@github-actions github-actions Bot temporarily deployed to pull-requests April 4, 2026 14:49 Inactive
@JeromeJaggi JeromeJaggi force-pushed the jeromejaggi/docs-comprehensive-update branch from af404cf to 2fd2008 Compare April 4, 2026 15:22
@JeromeJaggi JeromeJaggi temporarily deployed to pull-requests April 4, 2026 15:22 — with GitHub Actions Inactive
@github-actions github-actions Bot temporarily deployed to pull-requests April 4, 2026 15:25 Inactive
Add inline ROMs, ROM lifecycle, volume
lifecycle, instance logs, queued updates,
COW checkpointing, volume hooks, K8s CRD
specs, 10 diagrams, and feature stubs.

Signed-off-by: Jerome Jaggi <[email protected]>
@JeromeJaggi JeromeJaggi force-pushed the jeromejaggi/docs-comprehensive-update branch from 2fd2008 to ca82883 Compare April 4, 2026 16:51
@JeromeJaggi JeromeJaggi temporarily deployed to pull-requests April 4, 2026 16:51 — with GitHub Actions Inactive
|---|---|---|---|
| `cloud.unikraft.v1.services/domain` | string | — | Custom domain for the Unikraft Cloud service. For multi-container pods, prefix with the container name (`cloud.unikraft.v1.services/domain.<containerName>`) to set a per-container domain, or use the global annotation to derive `<containerName>-<domain>` automatically. |

## CRD reference
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🚫 [vale] reported by reviewdog 🐶
[Microsoft.Headings] 'CRD reference' should use sentence-style capitalization.

|---|---|---|---|
| `cloud.unikraft.v1.services/domain` | string | — | Custom domain for the Unikraft Cloud service. For multi-container pods, prefix with the container name (`cloud.unikraft.v1.services/domain.<containerName>`) to set a per-container domain, or use the global annotation to derive `<containerName>-<domain>` automatically. |

## CRD reference
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

📝 [vale] reported by reviewdog 🐶
[Microsoft.Acronyms] 'CRD' has no definition.


The operator defines three CRDs in the `unikraft.com/v1alpha1` API group.

### Instance CRD
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🚫 [vale] reported by reviewdog 🐶
[Microsoft.Headings] 'Instance CRD' should use sentence-style capitalization.


The operator defines three CRDs in the `unikraft.com/v1alpha1` API group.

### Instance CRD
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

📝 [vale] reported by reviewdog 🐶
[Microsoft.Acronyms] 'CRD' has no definition.

Most spec fields don't change after creation.
Fields marked mutable accept in-place updates.

### Service CRD
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🚫 [vale] reported by reviewdog 🐶
[Microsoft.Headings] 'Service CRD' should use sentence-style capitalization.

Most spec fields don't change after creation.
Fields marked mutable accept in-place updates.

### Service CRD
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

📝 [vale] reported by reviewdog 🐶
[Microsoft.Acronyms] 'CRD' has no definition.


Service CRDs don't support in-place updates.

### Volume CRD
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🚫 [vale] reported by reviewdog 🐶
[Microsoft.Headings] 'Volume CRD' should use sentence-style capitalization.


Service CRDs don't support in-place updates.

### Volume CRD
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

📝 [vale] reported by reviewdog 🐶
[Microsoft.Acronyms] 'CRD' has no definition.

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.

2 participants