Adding the online catalog sources to a cluster

Install IBM Cloud Pak® for Integration by adding the Common Services operator catalog and IBM operator catalog to your cluster. You must be a cluster administrator.

Note: This procedure applies only to clusters that are connected to the internet. For air-gapped installation, follow the guidance in Mirroring for a restricted (air-gapped) network environment.

You can add CatalogSource objects to your cluster by using the Red Hat OpenShift web console, or by using the oc command-line tool.

Adding CatalogSource objects by using the OpenShift web console

  • Add the IBM Common Services operators to the list of installable operators:
    1. Click the plus icon in the top screen banner to open the Import YAML dialog box.

    2. Paste this resource definition in the dialog box:
      apiVersion: operators.coreos.com/v1alpha1
      kind: CatalogSource
      metadata:
        name: opencloud-operators
        namespace: openshift-marketplace
      spec:
        displayName: IBMCS Operators
        publisher: IBM
        sourceType: grpc
        image: icr.io/cpopen/ibm-common-service-catalog:latest
        updateStrategy:
          registryPoll:
            interval: 45m
    3. Click Create

  • Add the IBM operators to the list of installable operators.
    1. Click the plus (+) icon to open the Import YAML dialog box.
    2. Paste the following resource definition in the dialog box:
      apiVersion: operators.coreos.com/v1alpha1
      kind: CatalogSource
      metadata:
        name: ibm-operator-catalog
        namespace: openshift-marketplace
      spec:
        displayName: IBM Operator Catalog
        image: 'icr.io/cpopen/ibm-operator-catalog:latest'
        publisher: IBM
        sourceType: grpc
        updateStrategy:
          registryPoll:
            interval: 45m
    3. Click Create

Adding CatalogSource objects by using the CLI

  1. Copy the two resource definitions below into local files on your computer (one file for each):
    • apiVersion: operators.coreos.com/v1alpha1
      kind: CatalogSource
      metadata:
        name: opencloud-operators
        namespace: openshift-marketplace
      spec:
        displayName: IBMCS Operators
        publisher: IBM
        sourceType: grpc
        image: quay.io/opencloudio/ibm-common-service-catalog:latest
        updateStrategy:
          registryPoll:
            interval: 45m
    • apiVersion: operators.coreos.com/v1alpha1
      kind: CatalogSource
      metadata:
        name: ibm-operator-catalog
        namespace: openshift-marketplace
      spec:
        displayName: IBM Operator Catalog
        image: 'icr.io/cpopen/ibm-operator-catalog:latest'
        publisher: IBM
        sourceType: grpc
        updateStrategy:
          registryPoll:
            interval: 45m
  2. For each resource definition in the previous step, run the following command. The value of filename is the name of the file containing that resource definition:
    oc apply -f filename