CatalogSource

A CatalogSource represents a store of metadata that OLM can query to discover and install operators and their dependencies.

There are three primary types of CatalogSource(spec.sourceType):

  • grpc with an image reference: OLM will pull the image and run a pod that has an api endpoint that can be queried for the metadata in the store
  • grpc with an address field: OLM will attempt to contact the grpc api at the given address. This should not be used in most cases.
  • internal or configmap: OLM will parse the configmap’s data and spin up a pod that can serve the grpc api over it.

Example - OperatorHub.io

apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
  name: operatorhubio-catalog
  namespace: olm
spec:
  sourceType: grpc
  image: quay.io/operatorhubio/catalog:latest
  displayName: Community Operators
  publisher: OperatorHub.io

This defines a CatalogSource for OperatorHub.io’s content. The name of the CatalogSource is used as input to a Subscription, which tells OLM where to look to find a requested operator:

apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: my-operator
  namespace: olm
spec:
  channel: stable
  name: my-operator
  source: operatorhubio-catalog