github.com/opencontainers/umoci@v0.4.8-0.20240508124516-656e4836fb0d/doc/man/umoci-init.1.md (about)

     1  % umoci-init(1) # umoci init - Create a new OCI image layout
     2  % Aleksa Sarai
     3  % DECEMBER 2016
     4  # NAME
     5  umoci init - Create a new OCI image layout
     6  
     7  # SYNOPSIS
     8  **umoci init**
     9  **--layout**=*image*
    10  
    11  # DESCRIPTION
    12  Creates a new OCI image layout. The new OCI image does not contain any new
    13  references or blobs, but those can be created through the use of
    14  **umoci-new**(1), **umoci-tag**(1), **umoci-repack**(1) and other similar
    15  commands.
    16  
    17  # OPTIONS
    18  The global options are defined in **umoci**(1).
    19  
    20  **--layout**=*image*
    21    The path where the OCI image layout will be created. The path must not exist
    22    already or **umoci-init**(1) will return an error.
    23  
    24  # EXAMPLE
    25  
    26  The following creates a brand new OCI image layout and then creates a blank tag
    27  for further manipulation with **umoci-repack**(1) and **umoci-config**(1).
    28  
    29  ```
    30  % umoci init --layout image
    31  % umoci new --image image:tag
    32  ```
    33  
    34  # SEE ALSO
    35  **umoci**(1), **umoci-new**(1)