Container Image Validation with fs-verity Metadata Files

Resolve Bottlenecks,
Find Innovative Solutions
Generate Solutions

Solution Overview

Problem

Existing containerization technologies lack effective methods to validate the integrity of files and filesystems extracted from container image layers at runtime, which are crucial for ensuring the security and reliability of containerized applications.

Innovation Solution

Implementing fs-verity on a metadata file describing the directory structure of extracted container image files, making the files and filesystem immutable by generating digests, which are used to verify the integrity of the files and filesystem upon access or container initiation.

Engineering Contradictions & Design Principles

VSEngineering Contradiction Analysis

1Speed

If container image layers are extracted to local filesystem for runtime use, then container execution efficiency is improved, but file integrity and security cannot be guaranteed

Engineering Contradiction:
Improvecontainer execution efficiencyVSAvoidfile integrity
Core Design Contradiction:
SpeedVSReliability

Solution Approach 1:

The patent applies preliminary action by generating the metadata file and computing file digests before the container actually runs. The metadata file is created during image extraction, containing digest information for all files in the container image layers. This pre-computed metadata enables rapid integrity verification during container execution without hindering runtime performance, thus resolving the contradiction between execution efficiency and file integrity guarantee.

Inventive Principle:
Principle #10Preliminary action

2Reliability

If fs-verity is enabled on metadata file to ensure immutability, then security and reliability are improved, but system complexity increases

Engineering Contradiction:
ImprovesecurityVSAvoidsystem complexity
Core Design Contradiction:
ReliabilityVSDevice complexity

Solution Approach 1:

The patent introduces a metadata file as an intermediary between the container image layers and the fs-verity verification mechanism. Instead of directly applying fs-verity to numerous individual container files, the system creates a single metadata file that describes the directory structure and contains digests of all container files. This intermediary approach simplifies the verification process by reducing many verification operations to a single metadata file check, thus improving security while managing system complexity.

Inventive Principle:
Principle #24Intermediary (Mediator)

3Measurement precision

If digest verification is performed on all files upon container initiation, then integrity validation is improved, but startup time increases

Engineering Contradiction:
Improveintegrity validationVSAvoidstartup time
Core Design Contradiction:
Measurement precisionVSLoss of time

Solution Approach 1:

The patent merges the integrity validation of all container files into a single metadata file structure. Instead of verifying each file individually upon container startup, the system consolidates digest information for all files into one metadata file with a hierarchical structure representing the directory tree. This allows the system to perform a single verification operation on the metadata file that implicitly validates all container files, thereby maintaining high measurement precision for integrity validation while significantly reducing startup time.

Inventive Principle:
Principle #5Merging (Combining)

Data Source

PatentUS12405923B2Validation of container images
Publication Date: 2025.09.02 RED HAT INC
  • US12405923B2 patent drawing
  • US12405923B2 patent drawing
  • US12405923B2 patent drawing

AI summary

A computing device receives a container image from a container registry, the container image comprising a plurality of layers. The computing device extracts, from the container image, a plurality of files into a filesystem of the computing device, each file of the plurality of files corresponding to one of the layers of the plurality of layers. The computing device generates a metadata file that describes a directory structure of the plurality of files in the filesystem. The computing device mounts the metadata file to a location in the filesystem, wherein mounting the metadata file causes a digest of the metadata file to be generated and the metadata file and the plurality of files in the filesystem to be read-only.