openshift.md

Run on Red Hat OpenShift

This document shows how to deploy the server using Red Hat OpenShift.

Prerequisites

You will need a running OpenShift cluster, or OKD cluster. You can provision OpenShift on the IBM Cloud.

Steps

1. Create Watson services on IBM Cloud
2. Create an OpenShift project
3. Create the config map
4. Get a secure endpoint
5. Run the web app

1. Create Watson services on IBM Cloud

Use the following links to create the Watson services on IBM Cloud. Copy/paste the API Key and URL or keep the browser tabs open. You'll need these later.

• Watson Assistant
• Watson Speech to Text
• Watson Text to Speech

2. Create an OpenShift project

• Using the OpenShift web console, select the Application Console view.

  

• Use the +Create Project button to create a new project, then click on your project to open it.

• In the Overview tab, click on Browse Catalog.

  

• Choose the Python app container and click Next.

  

• Give your app a name and add https://github.com/IBM/watson-voice-bot for the github repo, then click Create.

  

3. Create the config map

• Click on the Resources tab and choose Config Maps and then click the Create Config Map button.

  • Provide a Name for the config map.
  • Add a key named PORT and paste in the 8080 under Enter a value....
  • Click Add Item and add a key named ASSISTANT_APIKEY and paste in the API Key from step 1 under Enter a value.....
  • Click Add Item and add a key named ASSISTANT_URL and paste in the URL from step 1 under Enter a value.....
  • Click Add Item and add a key named SPEECH_TO_TEXT_APIKEY and paste in the API Key from step 1 under Enter a value.....
  • Click Add Item and add a key named SPEECH_TO_TEXT_URL and paste in the URL from step 1 under Enter a value.....
  • Click Add Item and add a key named TEXT_TO_SPEECH_APIKEY and paste in the API Key from step 1 under Enter a value.....
  • Click Add Item and add a key named TEXT_TO_SPEECH_URL and paste in the URL from step 1 under Enter a value.....
  • Hit the Create button.
  • Click on your new Config Map's name.
  • Click the Add to Application button.
  • Select your application from the pulldown.
  • Click Save.

  

• Go to the Applications tab, choose Deployments to view the status of your application.

4. Get a secure endpoint

• From the OpenShift or OKD UI, under Applications ▷ Routes you will see your app.
  • Click on the application Name.
  • Under TLS Settings, click on Edit.
  • Under Security, check the box for Secure route.
  • Hit Save.

5. Run the web app

• Go back to Applications ▷ Routes. You will see your app.
• Click your app's Hostname. This will open the Watson Voice Bot web app in your browser.
• Go back to the README to see an example using the default insurance bot dialog.