github.com/opencontainers/umoci@v0.4.8-0.20240508124516-656e4836fb0d/oci/layer/README.md (about)

     1  ### `umoci/oci/layer` ###
     2  
     3  This is my own implementation of the [currently under development
     4  `oci-create-layer` functions][create-layer]. The reason for implementing this
     5  myself is that we use [`mtree` specifications][mtree] which are not the same
     6  method that `oci-create-layer` uses. While the two implementations could be
     7  combined (since this implementation is more general), in order to speed things
     8  up I just decided to implement it myself.
     9  
    10  This also implements `oci-create-runtime-bundle`, since it's under layer
    11  management. The real difference is that we've split up the API (and based it on
    12  CAS) so we have more control when generating the bundle.
    13  
    14  I'm hoping that this will be merged upstream, but since it's just a whiteout
    15  tar archive generator there isn't a *huge* requirement that this is kept up to
    16  date. Though, it should be noted that [the whiteout format may change in the
    17  future][whiteout-disc].
    18  
    19  [create-layer]: https://github.com/opencontainers/image-tools/pull/8
    20  [mtree]: https://github.com/vbatts/go-mtree
    21  [whiteout-disc]: https://github.com/opencontainers/image-spec/issues/24