Skip to content

v21.5.25
Compare
Choose a tag to compare
@pombredanne pombredanne released this 25 May 22:33
· 271 commits to main since this release
v21.5.25
4871738

This is a major release.

API changes

The Image and Layer object structures have changed significantly:

  • legacy parent_id and parent_digest attributes are removed from Image

  • new attributes have been added to correctly track the tarball of an image
    or layer and its extracted location:

    • "extracted_location" is the absolute path where an image or layer is extracted
    • "archive_location" is the absolute path to an image or layer archive

    Therefore we have these attribute renames, additions and deletions:

    • Image.base_location -> Image.extracted_location
    • Image.archive_location: added
    • Layer.extracted_to_location -> Layer.extracted_location
    • Layer.layer_location -> Layer.archive_location
    • Layer.layer_sha256 -> Layer.sha256

    Also:

    • Layer.layer_id is now the sha256 of the Layer archive
    • Image.sha256, os_version, variant: added

  • the layer_id is now based on the SHA256 of the layer tarball and not based on
    the UUID-like directory names that contain a "layer.tar" in Docker image.

  • Image.config_digest is now prefixed with "sha256:"

  • All mappings keys are now lowercased recursively, including for labels.

  • Dropped support for Python 2. The minimum Python version is now Python 3.6

  • Dropped support for Docker image v1-style format

  • Dropped support for Windows as it was never intended to run on Windows.
    Windows as a container is a target though.

  • The way Image and Layers archives are extracted has changed significantly.
    Images are extracted as before keeping symlinks (which are essential to support
    certain Docker image layouts). In contrast, Layers are now exracted using
    extractcode and links are ignored.

New features

  • Add new find_root function to find the root of a filesystem

  • Add new tests for distro detection and os-release handling using a large
    collection of os-release files

  • Layer/Image.to_dict() now accepts a new "exclude_fields" argument with a list
    of field names to optionally exclude.

  • Add experimental support for container images using the OCI layout and add a
    new Image attribute "image_format" with the value "docker" or "oci"

  • Add experimental support for Windows-based containers.

Misc

  • The experimental fetch module has been removed
  • The master branch has been renamed to main.
Assets 2