Compare commits
2 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 69e66cba00 | |||
| 0e6384b3ee |
@@ -1,34 +0,0 @@
|
|||||||
# SmartVM Base Image Bundles
|
|
||||||
|
|
||||||
This directory documents the project-owned base image manifest format. The actual kernel and rootfs binaries should be hosted as release assets or in object storage, not committed to git.
|
|
||||||
|
|
||||||
## Bundle Layout
|
|
||||||
|
|
||||||
A hosted bundle should expose three files:
|
|
||||||
|
|
||||||
```text
|
|
||||||
smartvm-minimal-v1-x86_64.manifest.json
|
|
||||||
vmlinux
|
|
||||||
rootfs.ext4
|
|
||||||
```
|
|
||||||
|
|
||||||
The manifest is the only file shape `smartvm` needs to know. It points at the hosted kernel and rootfs artifacts and records checksums.
|
|
||||||
|
|
||||||
## Manifest Fields
|
|
||||||
|
|
||||||
- `schemaVersion`: currently `1`
|
|
||||||
- `bundleId`: stable cache key, using letters, numbers, dot, underscore, and dash only
|
|
||||||
- `arch`: `x86_64` or `aarch64`
|
|
||||||
- `firecrackerVersion`: Firecracker version validated with this bundle
|
|
||||||
- `rootfsType`: `ext4` or `squashfs`
|
|
||||||
- `rootfsIsReadOnly`: use `true` for squashfs or immutable rootfs images
|
|
||||||
- `bootArgs`: kernel boot args to use with the bundle
|
|
||||||
- `kernel`: hosted kernel artifact URL/path plus `sha256` for URL artifacts and optional `sizeBytes`
|
|
||||||
- `rootfs`: hosted rootfs artifact URL/path plus `sha256` for URL artifacts and optional `sizeBytes`
|
|
||||||
- `fileName`: optional plain output filename; path separators are rejected
|
|
||||||
|
|
||||||
`sha256` is required for hosted URL artifacts. `sizeBytes` is optional but helps catch incomplete downloads.
|
|
||||||
|
|
||||||
## Cache Behavior
|
|
||||||
|
|
||||||
Downloaded bundles are cached under `/tmp/.smartvm/base-images` by default. The cache keeps two bundles unless `maxStoredBaseImages` is configured. Eviction is announced with `console.warn`.
|
|
||||||
@@ -1,5 +1,11 @@
|
|||||||
# Changelog
|
# Changelog
|
||||||
|
|
||||||
|
## 2026-05-01 - 1.3.1 - fix(docs)
|
||||||
|
remove outdated base image bundle readme and consolidate hosted manifest documentation
|
||||||
|
|
||||||
|
- Deletes the dedicated assets/base-images/readme.md documentation file
|
||||||
|
- Keeps hosted base image manifest guidance and example usage in the main project README
|
||||||
|
|
||||||
## 2026-05-01 - 1.3.0 - feat(runtime)
|
## 2026-05-01 - 1.3.0 - feat(runtime)
|
||||||
stage VM runtime artifacts and writable drives in per-VM ephemeral storage by default
|
stage VM runtime artifacts and writable drives in per-VM ephemeral storage by default
|
||||||
|
|
||||||
|
|||||||
+1
-1
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "@push.rocks/smartvm",
|
"name": "@push.rocks/smartvm",
|
||||||
"version": "1.3.0",
|
"version": "1.3.1",
|
||||||
"private": false,
|
"private": false,
|
||||||
"description": "A TypeScript module wrapping Amazon Firecracker VMM for managing lightweight microVMs",
|
"description": "A TypeScript module wrapping Amazon Firecracker VMM for managing lightweight microVMs",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
|
|||||||
@@ -3,6 +3,6 @@
|
|||||||
*/
|
*/
|
||||||
export const commitinfo = {
|
export const commitinfo = {
|
||||||
name: '@push.rocks/smartvm',
|
name: '@push.rocks/smartvm',
|
||||||
version: '1.3.0',
|
version: '1.3.1',
|
||||||
description: 'A TypeScript module wrapping Amazon Firecracker VMM for managing lightweight microVMs'
|
description: 'A TypeScript module wrapping Amazon Firecracker VMM for managing lightweight microVMs'
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user