meta-virtualization/docs
Bruce Ashfield 4d8fc28985 image-oci: add layer caching for multi-layer OCI builds
Add layer caching to speed up multi-layer OCI image rebuilds. When
enabled, pre-installed package layers are cached to disk and restored
on subsequent builds, avoiding repeated package installation.

New variables:
- OCI_LAYER_CACHE: Enable/disable caching (default "1")
- OCI_LAYER_CACHE_DIR: Cache location (default ${TOPDIR}/oci-layer-cache/${MACHINE})

Cache key is computed from:
- Layer name and type
- Sorted package list
- Package versions from PKGDATA_DIR
- MACHINE and TUNE_PKGARCH

Cache automatically invalidates when:
- Package versions change
- Layer definition changes
- Architecture changes

Benefits:
- First build: ~10-30s per layer (cache miss, packages installed)
- Subsequent builds: ~1s per layer (cache hit, files copied)
- Shared across recipes with identical layer definitions

Build log shows cache status:
  NOTE: OCI Cache HIT: Layer 'base' (be88c180f651416b)
  NOTE: OCI: Pre-installed packages for 3 layers (cache: 3 hits, 0 misses)

Also adds comprehensive pytest suite for multi-layer OCI functionality
including tests for 1/2/3 layer modes and cache behavior.

Signed-off-by: Bruce Ashfield <bruce.ashfield@gmail.com>
2026-01-21 18:00:26 -05:00
..
00-INDEX docs: add container bundling and vdkr/vpdmn documentation 2026-01-21 18:00:26 -05:00
00-README docs: create initial documentation subdirectory structure 2013-03-18 07:08:33 -07:00
container-bundling.md image-oci: add layer caching for multi-layer OCI builds 2026-01-21 18:00:26 -05:00
openvswitch.txt openvswitch: uprev to 1.10 and documentation update. 2013-06-03 18:07:39 -04:00
podman.txt podman: Add support for rootless mode 2022-07-15 17:11:58 -04:00
podman.txt.license podman: Add support for rootless mode 2022-07-15 17:11:58 -04:00
xvisor.txt docs: Add initial Xvisor doc 2020-08-16 21:18:21 -04:00