Chapter 1. Installing the Operator using the CLI

The steps in this section show how to use the kubectl command-line interface (CLI) to install and deploy the latest version of the Skupper Operator in a given OpenShift cluster.

Procedure

  1. Download the Skupper Operator example files, for example:

    $ curl -fL https://github.com/skupperproject/skupper-operator/archive/refs/heads/main.zip
  1. Specify the namespace in which you want to install the Operator. You can create a new namespace or switch to an existing one.

    1. Create a new namespace if necessary:

      $ kubectl create namespace  <namespace-name>
    2. Switch to the namespace in which you want to install the Operator:

      $ kubectl config set-context --current --namespace=<namespace-name>
  2. Create a CatalogSource in the openshift-marketplace namespace:

    $ kubectl apply -f examples/ocp/00-cs.yaml
  3. Make sure the skupper-operator catalog pod is running before continuing:

    $ kubectl -n openshift-marketplace get pods | grep skupper-operator
  4. Create an OperatorGroup in the my-namespace namespace:

    $ kubectl apply -f examples/ocp/10-og.yaml
  5. Create a Subscription in the my-namespace namespace:

    $ kubectl apply -f examples/ocp/20-sub.yaml
  6. Verify that the Operator is running:

    $ kubectl get pods -n my-namespace
    
    NAME                                     READY   STATUS    RESTARTS   AGE
    skupper-site-controller-d7b57964-gxms6   1/1     Running   0          1m

    If the output does not report the pod is running, use the following command to determine the issue that prevented it from running:

    $ kubectl describe pod -l name=skupper-operator