logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

umoci raw add-layer - add a layer archive verbatim to an image

Description

       Adds the uncompressed layer archive referenced by new-layer.tar verbatim to the image.  Note  that  since
       this is done verbatim, no changes are made to the layer and thus any OCI-specific tar extensions (such as
       .wh.  whiteout  files) will be included unmodified. Use of this command is therefore only recommended for
       expert users, and more novice users should look at umoci-repack(1) to create their layers.

       At the moment, umocirawadd-layer only supports appending layers to the end of the image layer list.

Example

       The following takes an existing diff directory, creates a new archive from it and then inserts it into an
       existing image. Note that the new archive is not compressed (umoci will compress the archive for you).

       % tar cfC diff-layer.tar diff/ .
       % umoci raw add-layer --image oci:foo diff-layer.tar

Name

       umoci raw add-layer - add a layer archive verbatim to an image

Options

       The global options are defined in umoci(1).

       --image=image[:tag]
         The source tag to use as the base of the image containing the new layer.
         image must be a path to a valid OCI image and tag must be a valid tag in
         the image. If tag is not provided it defaults to "latest".

       --tag=tag
         The destination tag to use for the newly created image. tag must be a valid
         tag in the image. If tag is not provided it defaults to the tag specified
         in --image (overwriting it).

       --no-history
         Causes no history entry to be added for this operation. Thisisnotrecommendedforusewithumoci-raw-add-layer(1),sinceitresultsinthehistorynotincludingalloftheimagelayers--andthuswillcauseconfusionwithtoolsthatlookatimagehistory.--history.comment=comment
         Comment for the history entry corresponding to this modification of the image
         If unspecified, umoci(1) will generate an implementation-dependent value.

       --history.created_by=created_by
         CreatedBy entry for the history entry corresponding to this modification of
         the image. If unspecified, umoci(1) will generate an
         implementation-dependent value.

       --history.author=author
         Author value for the history entry corresponding to this modification of the
         image. If unspecified, this value will be the image's author value after
         any modifications were made by this call of umoci-config(1).

       --history-created=date
         Creation date for the history entry corresponding to this modifications of
         the image. This must be an ISO8601 formatted timestamp (see date(1)). If
         unspecified, the current time is used.

See Also

umoci(1), umoci-repack(1)

raw                                                   umoci                            umoci-raw-add-layer(1)(#)

Synopsis

umocirawadd-layer--image=image    [--tag=tag]    [--no-history]   [--history.comment=comment]
       [--history.created_by=created_by] [--history.author=author] [--history-created=date] new-layer.tar

See Also