ocne catalog mirror

Clones the container images used by applications in an application catalog and pushes them to a private registry. When no other options are provided, it lists the applications available in the catalog.

ocne catalog mirror 
[{-a|--archive} path]
[{-c|--config} path]
{-d|--destination} URI
[{-o|--download}]                
{-N|--name} name
[{-p|--push}]
[{-s|--source} registry]
[{-q|--quiet}]

Where:

{-a|--archive} path

Specifies the path to the .tgz archive file to generate when used with the --download option.

{-c|--config} path

The path to an Oracle CNE configuration file. If a configuration file is provided, only the applications listed in that file are mirrored.

{-d|--destination} URI

The URI of the destination container registry. The images from the application catalog are tagged so they belong to this registry, and are optionally pushed to that registry with the --push option.

{-o|--download}

Downloads the requested images to $HOME/.ocne/downloaded-images.tgz, or to another location specified by the --archive option.

{-N|--name} name

The name of the catalog to mirror. The default is the Oracle Cloud Native Environment Application Catalog. If the Oracle catalog isn't running as a container, the embedded catalog, built into the CLI, is used.

{-p|--push}

Pushes the images to the destination container registry.

{-s|--source} registry

The source registry to use for container images without a registry. The default is container-registry.oracle.com. For example, olcne/ui is translated as container-registry.oracle.com/olcne/ui.

{-q|--quiet}

Output only the image names, and omit all other output.

Example 4-18 List applications in the Oracle catalog

To list all the applications in the Oracle catalog:

ocne catalog mirror

Example 4-19 Mirror the Oracle catalog

To mirror the Oracle catalog to a private container registry:

ocne catalog mirror --destination myregistry.example.io --push

Example 4-20 Mirror a catalog

To mirror the a catalog to a private container registry:

ocne catalog mirror --name mycatalog --destination myregistry.example.io --push

Example 4-21 Mirror the embedded Oracle catalog

To mirror the Oracle catalog embedded in the CLI to a private container registry:

ocne catalog mirror --name embedded --destination myregistry.example.io --push

Example 4-22 Mirror specific applications

To mirror only those images that are used by the applications listed in a cluster configuration file to a private container registry:

ocne catalog mirror --destination myregistry.example.io --config mycluster.yaml --push

Example 4-23 Download all images from a catalog to an archive file

To download all images to the default location ($HOME/.ocne/downloaded-images.tgz):

ocne catalog mirror --download

Example 4-24 Download specific applications to a named archive file

To download the images listed in a cluster configuration file to a specified local archive file:

ocne catalog mirror --config mycluster.yaml --download --archive $HOME/myimages.tgz