Red Hat SummitChapter 7. opm CLI
7.1. Installing the opm CLI
7.1.1. About the opm CLI
The
opmA catalog contains a database of pointers to Operator manifest content that can be queried through an included API that is served when the container image is run. On OpenShift Container Platform, Operator Lifecycle Manager (OLM) can reference the image in a catalog source, defined by a
CatalogSource7.1.2. Installing the opm CLI
You can install the
opmPrerequisites
For Linux, you must provide the following packages. RHEL 8 meets these requirements:
-
version 1.9.3+ (version 2.0+ recommended)
podman -
version 2.28+
glibc
-
Procedure
- Navigate to the OpenShift mirror site and download the latest version of the tarball that matches your operating system.
Unpack the archive.
For Linux or macOS:
$ tar xvf <file>- For Windows, unzip the archive with a ZIP program.
Place the file anywhere in your
.PATHFor Linux or macOS:
Check your
:PATH$ echo $PATHMove the file. For example:
$ sudo mv ./opm /usr/local/bin/
For Windows:
Check your
:PATHC:\> pathMove the file:
C:\> move opm.exe <directory>
Verification
After you install the
CLI, verify that it is available:opm$ opm version
7.2. opm CLI reference
The
opmopm CLI syntax
$ opm <command> [<subcommand>] [<argument>] [<flags>]| Flag | Description |
|---|---|
|
| Skip TLS certificate verification for container image registries while pulling bundles or indexes. |
|
| When you pull bundles, use plain HTTP for container image registries. |
The SQLite-based catalog format, including the related CLI commands, is a deprecated feature. Deprecated functionality is still included in OpenShift Container Platform and continues to be supported; however, it will be removed in a future release of this product and is not recommended for new deployments.
For the most recent list of major functionality that has been deprecated or removed within OpenShift Container Platform, refer to the Deprecated and removed features section of the OpenShift Container Platform release notes.
7.2.1. generate
Generate various artifacts for declarative config indexes.
Command syntax
$ opm generate <subcommand> [<flags>]| Subcommand | Description |
|---|---|
|
| Generate a Dockerfile for a declarative config index. |
| Flags | Description |
|---|---|
|
| Help for generate. |
7.2.1.1. dockerfile
Generate a Dockerfile for a declarative config index.
This command creates a Dockerfile in the same directory as the
<dcRootDir><dcDirName>.DockerfileWhen specifying extra labels, if duplicate keys exist, only the last value of each duplicate key gets added to the generated Dockerfile.
Command syntax
$ opm generate dockerfile <dcRootDir> [<flags>]| Flag | Description |
|---|---|
|
| Image in which to build catalog. The default value is |
|
| Extra labels to include in the generated Dockerfile. Labels have the form |
|
| Help for Dockerfile. |
To build with the official Red Hat image, use the
registry.redhat.io/openshift4/ose-operator-registry:v4.14-i7.2.2. index
Generate Operator index for SQLite database format container images from pre-existing Operator bundles.
As of OpenShift Container Platform 4.11, the default Red Hat-provided Operator catalog releases in the file-based catalog format. The default Red Hat-provided Operator catalogs for OpenShift Container Platform 4.6 through 4.10 released in the deprecated SQLite database format.
The
opmMany of the
opmopm index pruneFor more information about working with file-based catalogs, see "Additional resources".
Command syntax
$ opm index <subcommand> [<flags>]| Subcommand | Description |
|---|---|
|
| Add Operator bundles to an index. |
|
| Prune an index of all but specified packages. |
|
| Prune an index of stranded bundles, which are bundles that are not associated with a particular image. |
|
| Delete an entire Operator from an index. |
7.2.2.1. add
Add Operator bundles to an index.
Command syntax
$ opm index add [<flags>]| Flag | Description |
|---|---|
|
| Container image for on-image |
|
| Tool to build container images: |
|
| Comma-separated list of bundles to add. |
|
| Tool to interact with container images, such as for saving and building: |
|
| Previous index to add to. |
|
| If enabled, only creates the Dockerfile and saves it to local disk. |
|
| Graph update mode that defines how channel graphs are updated: |
|
| Optional: If generating the Dockerfile, specify a file name. |
|
| Allow registry load errors. |
|
| Tool to pull container images: |
|
| Custom tag for container image being built. |
7.2.2.2. prune
Prune an index of all but specified packages.
Command syntax
$ opm index prune [<flags>]| Flag | Description |
|---|---|
|
| Container image for on-image |
|
| Tool to interact with container images, such as for saving and building: |
|
| Index to prune. |
|
| If enabled, only creates the Dockerfile and saves it to local disk. |
|
| Optional: If generating the Dockerfile, specify a file name. |
|
| Comma-separated list of packages to keep. |
|
| Allow registry load errors. |
|
| Custom tag for container image being built. |
7.2.2.3. prune-stranded
Prune an index of stranded bundles, which are bundles that are not associated with a particular image.
Command syntax
$ opm index prune-stranded [<flags>]| Flag | Description |
|---|---|
|
| Container image for on-image |
|
| Tool to interact with container images, such as for saving and building: |
|
| Index to prune. |
|
| If enabled, only creates the Dockerfile and saves it to local disk. |
|
| Optional: If generating the Dockerfile, specify a file name. |
|
| Comma-separated list of packages to keep. |
|
| Allow registry load errors. |
|
| Custom tag for container image being built. |
7.2.2.4. rm
Delete an entire Operator from an index.
Command syntax
$ opm index rm [<flags>]| Flag | Description |
|---|---|
|
| Container image for on-image |
|
| Tool to build container images: |
|
| Tool to interact with container images, such as for saving and building: |
|
| Previous index to delete from. |
|
| If enabled, only creates the Dockerfile and saves it to local disk. |
|
| Comma-separated list of Operators to delete. |
|
| Optional: If generating the Dockerfile, specify a file name. |
|
| Comma-separated list of packages to keep. |
|
| Allow registry load errors. |
|
| Tool to pull container images: |
|
| Custom tag for container image being built. |
7.2.3. init
Generate an
olm.packageCommand syntax
$ opm init <package_name> [<flags>]| Flag | Description |
|---|---|
|
| The channel that subscriptions will default to if unspecified. |
|
| Path to the Operator’s |
|
| Path to package’s icon. |
|
| Output format: |
7.2.4. migrate
Migrate a SQLite database format index image or database file to a file-based catalog.
The SQLite-based catalog format, including the related CLI commands, is a deprecated feature. Deprecated functionality is still included in OpenShift Container Platform and continues to be supported; however, it will be removed in a future release of this product and is not recommended for new deployments.
For the most recent list of major functionality that has been deprecated or removed within OpenShift Container Platform, refer to the Deprecated and removed features section of the OpenShift Container Platform release notes.
Command syntax
$ opm migrate <index_ref> <output_dir> [<flags>]| Flag | Description |
|---|---|
|
| Output format: |
7.2.5. render
Generate a declarative config blob from the provided index images, bundle images, and SQLite database files.
Command syntax
$ opm render <index_image | bundle_image | sqlite_file> [<flags>]| Flag | Description |
|---|---|
|
| Output format: |
7.2.6. serve
Serve declarative configs via a GRPC server.
The declarative config directory is loaded by the
serveCommand syntax
$ opm serve <source_path> [<flags>]| Flag | Description |
|---|---|
|
| If this flag is set, it syncs and persists the server cache directory. |
|
| Exits with an error if the cache is not present or is invalidated. The default value is |
|
| Syncs the serve cache and exits without serving. |
|
| Enables debug logging. |
|
| Help for serve. |
|
| The port number for the service. The default value is |
|
| The address of the startup profiling endpoint. The format is |
|
| The path to a container termination log file. The default value is |
7.2.7. validate
Validate the declarative config JSON file(s) in a given directory.
Command syntax
$ opm validate <directory> [<flags>]
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}