Integrating your Kogito Serverless Workflow project with OpenShift using Serverless Logic Web Tools

You can integrate your Kogito Serverless Workflow project with Red Hat OpenShift. OpenShift is an enterprise-ready Kubernetes container platform, enabling your Kogito Serverless Workflow projects to be deployed and tested online.

Setting KIE Sandbox Extended Services

The KIE Sandbox Extended Services tool is required to proxy requests to an OpenShift instance. Therefore, setting the KIE Sandbox Extended Services enables you to deploy and monitor your Kogito Serverless Workflow projects.

Procedure

  1. In the Serverless Logic Web Tools web application, click on the Cog wheel (⚙️) on the top-right corner and go to the KIE Sandbox Extended Services tab.

  2. In case you are not connected to KIE Sandbox Extended Services, you see You are not connected to KIE Sandbox Extended Services. Click to setup mesaage along with Host and Port fields, containing the values as http://localhost and 21345 respectively.

  3. Click on the link in the message.

    A window appears containing your current operating system as selected and a link to download to the latest version of KIE Sandbox Extended Services.

  4. Download the KIE Sandbox Extended Services and execute it.

    You might need to grant permissions to run the file depending on your operating system and settings.

    If you are using macOS, you might encounter the "KIE Sandbox Extended Services" is damaged and can’t be opened. You should move it to Bin while running the application "KIE Sandbox Extended Services". This is due to the overeager approach towards security by macOS and you can fix it by moving the "KIE Sandbox Extended Services" application out of quarantine. You can execute the xattr -d com.apple.quarantine /Applications/KIE\ Sandbox\ Extended\ Services.app command to achieve this.

    After executing the KIE Sandbox Extended Services the content in the KIE Sandbox Extended Services is updated and displays that you are connected to the KIE Sandbox Extended Services.

Connecting to OpenShift instance using Serverless Logic Web Tools

After setting the KIE Sandbox Extended Services, you can connect to your OpenShift instance to deploy your Kogito Serverless Workflow projects with Serverless Logic Web Tools.

Prerequisites

  • KIE Sandbox Extended Services tool installed and running.

  • OpenShift instance is active.

    You can create a free developer sandbox. For more information, see OpenShift Developer Sandbox.

Procedure

  1. Log in to your OpenShift instance console interface.

  2. In the OpenShift instance console interface, you need your OpenShift project name (also known as namespace), API server, and an access token.

    • For the OpenShift project name, go to the Topology tab and in the top-left corner you see your project name.

      serverless logic web tools openshift project
      Figure 1. OpenShift project name in OpenShift instance console

    • To obtain the API server and access token, click on your username and Copy login command.

      A new page opens containing your new API token along with oc cli login command. From the oc cli command, copy the value of --server=.

      serverless logic web tools openshift info
      Figure 2. OpenShift access token and API server

  3. Go to the Serverless Logic Web Tools web application, click on the Cog wheel (⚙️) on the top-right corner and go to the OpenShift tab.

  4. Enter your OpenShift project name in the Namespace (project) field.

  5. Enter the value copied value of --server flag in the Host field.

  6. Enter the value of API token in the Token field.

  7. Click Connect.

    If the entered values are correct, then the tab updates and displays You’re connected to OpenShift message.

After connecting to OpenShift, you are ready to deploy your Kogito Serverless Workflow projects using Serverless Logic Web Tools. For more information about deploying your projects, see Deploying your Kogito Serverless Workflow projects using Serverless Logic Web Tools.

If your OpenShift instance uses self-signed certificates, then you might need to enable InsecureSkipVerify on KIE Sandbox Extended Services.

Found an issue?

If you find an issue or any misleading information, please feel free to report it here. We really appreciate it!