Chapter 2. Preparing your OpenShift cluster

Procedure

1. In the OpenShift Container Platform web console, log in by using an account with cluster administrator privileges.

2. Create a new OpenShift project:

   1. In the left navigation menu, click Home > Project > Create Project.
   2. Enter a project name, for example, my-camel-k-project, and then click Create.
3. In the left navigation menu, click Operators > OperatorHub.
4. In the Filter by keyword text box, type Camel K and then click the Red Hat Integration - Camel K Operator card.
5. Read the information about the operator and then click Install. The Operator installation page opens.

6. Select the following subscription settings:

   • Update Channel > latest
   • Installation Mode > A specific namespace on the cluster > my-camel-k-project

   • Approval Strategy > Automatic

     Note

     The Installation mode > All namespaces on the cluster and Approval Strategy > Manual settings are also available if required by your environment.

7. Click Install, and then wait a few moments until the Camel K Operator is ready for use.

8. Download and install the Camel K CLI tool:

   1. From the Help menu (?) at the top of the OpenShift web console, select Command line tools.
   2. Scroll down to the kamel - Red Hat Integration - Camel K - Command Line Interface section.
   3. Click the link to download the binary for your local operating system (Linux, Mac, Windows).
   4. Unzip and install the CLI in your system path.

   5. To verify that you can access the Kamel K CLI, open a command window and then type the following:

      kamel --help

      This command shows information about Camel K CLI commands.

Procedure

1. In the OpenShift Container Platform web console, log in by using an account with cluster administrator privileges.
2. In the left navigation menu, click Operators > OperatorHub.
3. In the Filter by keyword text box, enter Serverless to find the OpenShift Serverless Operator.
4. Read the information about the Operator and then click Install to display the Operator subscription page.

5. Select the default subscription settings:

   • Update Channel > Select the channel that matches your OpenShift version, for example, 4.9
   • Installation Mode > All namespaces on the cluster

   • Approval Strategy > Automatic

     Note

     The Approval Strategy > Manual setting is also available if required by your environment.

6. Click Install, and wait a few moments until the Operator is ready for use.

7. Install the required Knative components using the steps in the OpenShift documentation:

   • Installing Knative Serving
   • Installing Knative Eventing

8. (Optional) Download and install the OpenShift Serverless CLI tool:

   1. From the Help menu (?) at the top of the OpenShift web console, select Command line tools.
   2. Scroll down to the kn - OpenShift Serverless - Command Line Interface section.
   3. Click the link to download the binary for your local operating system (Linux, Mac, Windows)
   4. Unzip and install the CLI in your system path.

   5. To verify that you can access the kn CLI, open a command window and then type the following:

      kn --help

      This command shows information about OpenShift Serverless CLI commands.

      For more details, see the OpenShift Serverless CLI documentation.

Procedure

1. To create a ConfigMap from a file, run the following command.

   oc create configmap maven-settings --from-file=settings.xml

   Created ConfigMap can be then referenced in the IntegrationPlatform resource, from the spec.build.maven.settings field.

   Example

   apiVersion: camel.apache.org/v1
   kind: IntegrationPlatform
   metadata:
     name: camel-k
   spec:
     build:
        maven:
           settings:
              configMapKeyRef:
                   key: settings.xml
                   name: maven-settings

   Or you can edit the IntegrationPlatform resource directly to reference the ConfigMap that contains the Maven settings using following command:

   oc edit ip camel-k

Procedure

1. Create a Secret from file using following command:

   oc create secret generic maven-ca-certs --from-file=ca.crt

2. Reference the created Secret in the IntegrationPlatform resource, from the spec.build.maven.caSecret field as shown below.

   apiVersion: camel.apache.org/v1
   kind: IntegrationPlatform
   metadata:
     name: camel-k
   spec:
     build:
         maven:
             caSecret:
                key: tls.crt
                name: tls-secret