Chapter 2. Installing the Operator The Red Hat Service Interconnect Operator creates and manages sites in OpenShift. Note The Red Hat Service Interconnect Operator is supported only on OpenShift version 4 as distinct from OpenShift version 3. Installing an Operator requires administrator-level privileges for your cluster. 2.1. Installing the Operator for all namespaces using the CLI The steps in this section show how to use the kubectl command to install and deploy the latest version of the Red Hat Service Interconnect Operator in a given Kubernetes cluster. Installing the operator for all namespaces allows you create a site in any namespace. Prerequisites Access to a cluster using a cluster-admin account. Operator Lifecycle Manager is installed. This is installed by default on OpenShift clusters. See QuickStart for more information about installation. Procedure Log in as a cluster administrator. Complete the steps described in Red Hat Container Registry Authentication . Create a file named subscription-all.yaml with the following: apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: skupper-operator namespace: openshift-operators spec: channel: stable-1 installPlanApproval: Automatic name: skupper-operator source: redhat-operators sourceNamespace: openshift-marketplace startingCSV: skupper-operator.v1.8.1-rh-3 Note If you want to keep updates confined to 1.8.x releases, set the value of channel to stable-1.8 . If you do not specify startingCSV , the subscription defaults to the latest operator version. If you specify installPlanApproval as Manual , sites are not automatically upgraded to the latest version of Service Interconnect. See Chapter 4, Upgrading the Red Hat Service Interconnect Operator and sites for information on manually upgrading sites. Apply the subscription YAML: USD kubectl apply -f subscription-all.yaml Additional information See Using Skupper for instructions about using YAML to create sites. 2.2. Installing the Operator for a single namespace using the CLI The steps in this section show how to use the kubectl command to install and deploy the latest version of the Red Hat Service Interconnect Operator in a given Kubernetes cluster. Installing the operator for a single namespaces allows you create a site in the specified namespace. Prerequisites Access to a cluster using a cluster-admin account. Operator Lifecycle Manager is installed. This is installed by default on OpenShift clusters. See QuickStart for more information about installation. Procedure Log in as a cluster administrator. Complete the steps described in Red Hat Container Registry Authentication . Create an Operator group in the namespace where you want to create a site: Create a file named operator-group.yaml with the following: kind: OperatorGroup apiVersion: operators.coreos.com/v1 metadata: name: skupper-operator namespace: my-namespace spec: targetNamespaces: - my-namespace where my-namespace is the name of the namespace you want to create the site. Apply the Operator group YAML: USD kubectl apply -f operator-group.yaml Create a file named subscription-myns.yaml with the following: apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: skupper-operator namespace: my-namespace spec: channel: stable-1 installPlanApproval: Automatic name: skupper-operator source: redhat-operators sourceNamespace: openshift-marketplace startingCSV: skupper-operator.v1.8.1-rh-3 where my-namespace is the name of the namespace you want to create the site. Note If you want to keep updates confined to 1.8.x releases, set the value of channel to stable-1.8 . If you do not specify startingCSV , the subscription defaults to the latest operator version. If you specify installPlanApproval as Manual , sites are not automatically upgraded to the latest version of Service Interconnect. See Chapter 4, Upgrading the Red Hat Service Interconnect Operator and sites for information on manually upgrading sites. Apply the subscription YAML: USD kubectl apply -f subscription-myns.yaml Additional information See Using Skupper for instructions about using YAML to create sites. 2.3. Installing the Operator using the OpenShift console The procedures in this section show how to use the OperatorHub from the OpenShift console to install and deploy the latest version of the Red Hat Service Interconnect Operator in a given OpenShift namespace. Prerequisites Access to an OpenShift cluster using a cluster-admin account. See Release Notes for supported OpenShift versions. Procedure In the OpenShift web console, navigate to Operators OperatorHub . Choose Red Hat Service Interconnect Operator from the list of available Operators, and then click Install . On the Operator Installation page, two Installation mode options are available: All namespaces on the cluster A specific namespace on the cluster For this example, choose A specific namespace on the cluster . Choose an Update approval option. By default, Automatic approval is selected, and sites will upgrade to the latest version of Service Interconnect. If you choose Manual approval, sites will not be automatically upgraded to the latest version of Service Interconnect. See Chapter 4, Upgrading the Red Hat Service Interconnect Operator and sites for information on manually upgrading sites. Select the namespace into which you want to install the Operator, and then click Install . The Installed Operators page appears displaying the status of the Operator installation. Verify that the Red Hat Service Interconnect Operator is displayed and wait until the Status changes to Succeeded . If the installation is not successful, troubleshoot the error: Click Red Hat Service Interconnect Operator on the Installed Operators page. Select the Subscription tab and view any failures or errors. For more information about installing Operators, see the OpenShift Documentation Additional information See Using Skupper for instructions about using YAML to create sites.

Commands:
apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: skupper-operator namespace: openshift-operators spec: channel: stable-1 installPlanApproval: Automatic name: skupper-operator source: redhat-operators sourceNamespace: openshift-marketplace startingCSV: skupper-operator.v1.8.1-rh-3
kubectl apply -f subscription-all.yaml
kind: OperatorGroup apiVersion: operators.coreos.com/v1 metadata: name: skupper-operator namespace: my-namespace spec: targetNamespaces: - my-namespace
kubectl apply -f operator-group.yaml
apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: skupper-operator namespace: my-namespace spec: channel: stable-1 installPlanApproval: Automatic name: skupper-operator source: redhat-operators sourceNamespace: openshift-marketplace startingCSV: skupper-operator.v1.8.1-rh-3
kubectl apply -f subscription-myns.yaml