This repository has moved!

This repository has moved to https://github.com/AICoE/olm-testing-example

Any future updates will be made there.

Overview

Here is a short example of how to test an operator bundle with the OLM. It uses a fake operator which is really just a docker.io/busybox instance looping and echoing, but it's enough to illustrate the steps.

NOTE: do not delete application repos until the following bug is fixed

https://issues.redhat.com/browse/PROJQUAY-762
quay/quay#406
If you need to overwrite an application bundle with changes, pay attention to step 2 under How to iterate quickly and update the foo-operator below
If you do delete an application repo and your namespace no longer works for testing operators, you can create a new quay account or try deleting and recreating the existing one.

Helpful links

This guide gives you a quick howto, but you can delve deeper here

Adding a custom operator using foo-operator as an example

Create an account on quay.io if you do not already have one
Install operator-courier using pip (Python 3 required)
```
$ pip3 install operator-courier
```

Get the get-quay-token script (it's convenient)

$ wget https://raw.githubusercontent.com/operator-framework/operator-courier/master/scripts/get-quay-token
$ chmod +x get-quay-token

Generate your token for quay and save it in an environment variable (you could get fancy here and pipe the output to some bash command that parses the token out without ever displaying it, but we'll keep it simple for the guide)
```
$ ./get-quay-token 
Username: tmckayus
Password: 
{"token":"basic blahblahnotreallymytokendG1ja="} 

$ QUAY_TOKEN="basic blahblahnotreallymytokendG1ja="
```
Create a bundle from the foo-operator directory and push it to quay.io.

The arguments to push are sourcedir username repository bundleversion token.

Note for now that the bundle version is arbitrary.
```
$ operator-courier push foo-operator tmckayus foo-operator 0.1.3 "$QUAY_TOKEN"
```
When you first create a new repository in quay, it will be private. Log in to quay and make it public. You can do this from "Settings" for the repository.

The os.yaml file in this repo contains an OperatorSource manifest, edit it to replace the registryNamespace value with your quay.io username

apiVersion: operators.coreos.com/v1
kind: OperatorSource
metadata:
    name: my-operators
    namespace: openshift-marketplace
spec:
    type: appregistry
    endpoint: https://quay.io/cnr
    registryNamespace: "your quay username here"

Create the OperatorSource object in OpenShift
```
$ oc create -f os.yaml
```

You can verify that the operator source has been created with a corresponding deployment

$ oc get OperatorSource -n openshift-marketplace
...
my-operators          appregistry   https://quay.io/cnr   tmckayus   Succeeded   The object has been successfully reconciled   2m

$ oc log -f deployment/my-operators -n openshift-marketplace
time="2019-08-02T20:12:34Z" level=info msg="Using in-cluster kube client config" port=50051 type=appregistry
time="2019-08-02T20:12:34Z" level=info msg="operator source(s) specified are - [https://quay.io/cnr%7Ctmckayus]" port=50051 type=appregistry
time="2019-08-02T20:12:34Z" level=info msg="package(s) specified are - foo-operator," port=50051 type=appregistry
...

Go to the OperatorHub UI in OpenShift and you should see the foo-operator listed there under the "custom" category

How to iterate quickly and update the foo-operator

Make some modification to the cluster service version file in the foo-operator directory

Push the new bundle version to quay.io but increment the bundleversion value

$ operator-courier push foo-operator tmckayus foo-operator 0.1.4 "$QUAY_TOKEN"

Uninstall the current version of the operator if it's currently installed

Cause the pod associated with the OperatorSource to be recreated

$ oc scale deployment my-operators --replicas=0 -n openshift-marketplace
$ oc scale deployment my-operators --replicas=1 -n openshift-marketplace

You can convince yourself that the new version was picked up by looking at the log for the deployment and searching for the updated bundle version
```
$ oc log -f deployment/my-operators -n openshift-marketplace | grep 0.1.4
```
The new version of the operator bundle should now be visible in OperatorHub, go ahead and reinstall the operator.

tmckayus / olm-testing-example

This repository has moved!

Overview

Helpful links

Adding a custom operator using foo-operator as an example

How to iterate quickly and update the foo-operator

About