github.com/dctrud/umoci@v0.4.3-0.20191016193643-05a1d37de015/doc/man/umoci-raw-add-layer.1.md (about)

     1  % umoci-raw-add-layer(1) # umoci raw add-layer - add a layer archive verbatim to an image
     2  % Aleksa Sarai
     3  % SEPTEMBER 2018
     4  # NAME
     5  umoci raw add-layer - add a layer archive verbatim to an image
     6  
     7  # SYNOPSIS
     8  **umoci raw add-layer**
     9  **--image**=*image*
    10  [**--tag**=*tag*]
    11  [**--history.comment**=*comment*]
    12  [**--history.created_by**=*created_by*]
    13  [**--history.author**=*author*]
    14  [**--history-created**=*date*]
    15  *new-layer.tar*
    16  
    17  # DESCRIPTION
    18  Adds the uncompressed layer archive referenced by *new-layer.tar* verbatim to
    19  the image. Note that since this is done verbatim, no changes are made to the
    20  layer and thus any OCI-specific `tar` extensions (such as `.wh.` whiteout
    21  files) will be included unmodified. Use of this command is therefore only
    22  recommended for expert users, and more novice users should look at
    23  **umoci-repack**(1) to create their layers.
    24  
    25  At the moment, **umoci raw add-layer** only supports appending layers to the
    26  end of the image layer list.
    27  
    28  # OPTIONS
    29  The global options are defined in **umoci**(1).
    30  
    31  **--image**=*image*[:*tag*]
    32    The source tag to use as the base of the image containing the new layer.
    33    *image* must be a path to a valid OCI image and *tag* must be a valid tag in
    34    the image. If *tag* is not provided it defaults to "latest".
    35  
    36  **--tag**=*tag*
    37    The destination tag to use for the newly created image. *tag* must be a valid
    38    tag in the image. If *tag* is not provided it defaults to the *tag* specified
    39    in **--image** (overwriting it).
    40  
    41  **--history.comment**=*comment*
    42    Comment for the history entry corresponding to this modification of the image
    43    If unspecified, **umoci**(1) will generate an implementation-dependent value.
    44  
    45  **--history.created_by**=*created_by*
    46    CreatedBy entry for the history entry corresponding to this modification of
    47    the image. If unspecified, **umoci**(1) will generate an
    48    implementation-dependent value.
    49  
    50  **--history.author**=*author*
    51    Author value for the history entry corresponding to this modification of the
    52    image. If unspecified, this value will be the image's author value **after**
    53    any modifications were made by this call of **umoci-config**(1).
    54  
    55  **--history-created**=*date*
    56    Creation date for the history entry corresponding to this modifications of
    57    the image. This must be an ISO8601 formatted timestamp (see **date**(1)). If
    58    unspecified, the current time is used.
    59  
    60  # EXAMPLE
    61  
    62  The following takes an existing diff directory, creates a new archive from it
    63  and then inserts it into an existing image. Note that the new archive is *not*
    64  compressed (**umoci** will compress the archive for you).
    65  
    66  ```
    67  % tar cfC diff-layer.tar diff/ .
    68  % umoci raw add-layer --image oci:foo diff-layer.tar
    69  ```
    70  
    71  # SEE ALSO
    72  **umoci**(1), **umoci-repack**(1)