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

     1  % umoci-new(1) # umoci new - Create a blank tag in an OCI image
     2  % Aleksa Sarai
     3  % DECEMBER 2016
     4  # NAME
     5  umoci new - Create a blank tag in an OCI image
     6  
     7  # SYNOPSIS
     8  **umoci new**
     9  **--image**=*image*[:*tag*]
    10  
    11  # DESCRIPTION
    12  Create a blank tag in an OCI image. The created image's configuration and
    13  manifest are all set to **umoci**-defined default values, with no filesystem
    14  layer blobs added to the image.
    15  
    16  Once a new image is created with **umoci-new**(1) you can directly use the
    17  image with **umoci-unpack**(1), **umoci-repack**(1), and **umoci-config**(1) to
    18  modify the new tagged image as you see fit. This allows you to create entirely
    19  new images from scratch, without needing a base image to start with.
    20  
    21  # OPTIONS
    22  The global options are defined in **umoci**(1).
    23  
    24  **--image**=*image*[:*tag*]
    25    The destination of the blank tag in the OCI image. *image* must be a path to
    26    a valid OCI image, and *tag* must be a valid tag name. If a tag already
    27    exists with the name *tag* it will be overwritten. If *tag* is not provided
    28    it defaults to "latest".
    29  
    30  # EXAMPLE
    31  The following creates a brand new OCI image layout and then creates a blank tag
    32  for further manipulation with **umoci-repack**(1) and **umoci-config**(1).
    33  
    34  ```
    35  % umoci init --layout image
    36  % umoci new --image image:tag
    37  ```
    38  
    39  # SEE ALSO
    40  **umoci**(1), **umoci-unpack**(1), **umoci-repack**(1), **umoci-config**(1)
    41