OLM Integration Package Manifests Quickstart

This guide assumes you have followed the introduction and Setup section of the bundle quickstart.

Creating package manifests

We will now create a package manifests format by running generate packagemanifests in the root of the memcached-operator project:

  1. $ operator-sdk generate packagemanifests --version 0.0.1

A versioned manifests directory deploy/olm-catalog/memcached-operator/0.0.1 containing a CSV and all CRDs in deploy/crds and a package manifest YAML file deploy/olm-catalog/memcached-operator/memcached-operator.package.yaml have been created in the Operator project.

Deploying an Operator with OLM

At this point in development we’ve generated all files necessary to build a memcached-operator registry. Now we’re ready to test the Operator with OLM.

Testing package manifests

operator-sdk run packagemanifests will create an Operator registry from manifests and metadata in the memcached-operator project, and inform OLM that memcached-operator v0.0.1 is ready to be deployed. This process effectively replicates production deployment in a constrained manner to make sure OLM can deploy our Operator successfully before attempting real production deployment.

run packagemanifests performs some optionally configurable setup under the hood, but for most use cases the following invocation is all we need:

  1. $ operator-sdk run packagemanifests --operator-version 0.0.1
  2. INFO[0000] Running operator from directory deploy/olm-catalog/memcached-operator
  3. INFO[0000] Creating memcached-operator registry         
  4. INFO[0000]   Creating ConfigMap "olm/memcached-operator-registry-manifests-package"
  5. INFO[0000]   Creating ConfigMap "olm/memcached-operator-registry-manifests-0-0-1"
  6. INFO[0000]   Creating Deployment "olm/memcached-operator-registry-server"
  7. INFO[0000]   Creating Service "olm/memcached-operator-registry-server"
  8. INFO[0000] Waiting for Deployment "olm/memcached-operator-registry-server" rollout to complete
  9. INFO[0000]   Waiting for Deployment "olm/memcached-operator-registry-server" to rollout: 0 of 1 updated replicas are available
  10. INFO[0066]   Deployment "olm/memcached-operator-registry-server" successfully rolled out
  11. INFO[0066] Creating resources                           
  12. INFO[0066]   Creating CatalogSource "default/memcached-operator-ocs"
  13. INFO[0066]   Creating Subscription "default/memcached-operator-v0-0-1-sub"
  14. INFO[0066]   Creating OperatorGroup "default/operator-sdk-og"
  15. INFO[0066] Waiting for ClusterServiceVersion "default/memcached-operator.v0.0.1" to reach 'Succeeded' phase
  16. INFO[0066]   Waiting for ClusterServiceVersion "default/memcached-operator.v0.0.1" to appear
  17. INFO[0073]   Found ClusterServiceVersion "default/memcached-operator.v0.0.1" phase: Pending
  18. INFO[0077]   Found ClusterServiceVersion "default/memcached-operator.v0.0.1" phase: InstallReady
  19. INFO[0078]   Found ClusterServiceVersion "default/memcached-operator.v0.0.1" phase: Installing
  20. INFO[0036]   Found ClusterServiceVersion "default/memcached-operator.v0.0.1" phase: Succeeded
  21. INFO[0037] Successfully installed "memcached-operator.v0.0.1" on OLM version "0.15.1"
  23. NAME                            NAMESPACE    KIND                        STATUS
  24. memcacheds.cache.example.com    default      CustomResourceDefinition    Installed
  25. memcached-operator.v0.0.1       default      ClusterServiceVersion       Installed

As long as both the ClusterServiceVersion and all CustomResourceDefinition‘s return an Installed status, the memcached-operator has been deployed successfully.

Now that we’re done testing the memcached-operator, we should probably clean up the Operator’s resources. operator-sdk cleanup packagemanifests will do this for you:

  1. $ operator-sdk cleanup packagemanifests --operator-version 0.0.1
  2. INFO[0000] Deleting resources
  3. INFO[0000]   Deleting CatalogSource "default/memcached-operator-ocs"
  4. INFO[0000]   Deleting Subscription "default/memcached-operator-v0-0-1-sub"
  5. INFO[0000]   Deleting OperatorGroup "default/operator-sdk-og"
  6. INFO[0000]   Deleting CustomResourceDefinition "default/memcacheds.example.com"
  7. INFO[0000]   Deleting ClusterServiceVersion "default/memcached-operator.v0.0.1"
  8. INFO[0000]   Waiting for deleted resources to disappear
  9. INFO[0001] Successfully uninstalled "memcached-operator.v0.0.1" on OLM version "0.15.1"

Last modified July 8, 2020: docs: OLM integration docs reference new commands (new and legacy CLI) (#3320) (ec03835e)