IBM Developer Blog

Follow the latest happenings with IBM Developer and stay in the know.

Add IBM Cloud starter kits to your OpenShift Developer Catalog. Cloud-ready code samples provide a quick path to getting up and running on the cloud.…


IBM Cloud recently introduced the IBM Starter Kit Collection for OpenShift. Install this open source collection to add the most popular IBM Cloud starter kits to your OpenShift Developer Catalog. It is a bridge between Red Hat® OpenShift® and the public IBM Cloud™, helping you connect apps to IBM Cloud managed services from inside the OpenShift console.

Get new apps up and running in minutes

IBM Cloud starter kits are cloud-ready code samples that provide a quick path to getting up and running on the cloud. After you install the starter kit collection, any developers with access to your OpenShift cluster can get an app running in their language of choice with just a couple of clicks.

Easily connect to the public IBM Cloud from OpenShift

Many of the starter kits in the collection include bindings to services on IBM Cloud managed services. The collection currently includes starter kits that connect to Watson Natural Language Understanding, Watson Speech to Text, Watson Text to Speech, Watson Visual Recognition, and Cloudant databases. The starter kits use the IBM Cloud Operator to connect to these services, and they can connect from any OpenShift cluster with access to the public IBM Cloud.

Install the IBM Cloud Starter Kit Collection for OpenShift

The open source collection is available on GitHub at github.com/IBM/starter-kit-collection. To install, just complete the following steps:

  1. Log in to IBM Cloud and connect to your OpenShift cluster.
  2. Make sure that your cluster has the IBM Cloud Operator installed.
  3. Download and run this bash script. Be sure to make the chmod +x install.sh script executable.
  4. When the script completes, wait a few minutes and then reload the Developer Catalog in your cluster console. Filter on the IBM publisher to find the installed starter kits.

Installation tips

  • The new template appears in the Developer Catalog for the default project for your cluster. You can add the starter kits to other projects by modifying the installation script to include the -n flag. For example, oc apply -f templates/go-gin-app.json -n test_project installs the starter in the project named test_project, and oc apply -f templates/go-gin-app.json -n openshift installs the starter kit into the cluster Service Catalog.
  • If you want to uninstall one starter kit, you can run the oc delete command from your terminal: oc delete -f templates/go-gin-app.json -n test_project.
  • If you want to uninstall all the starter kits in the collection, you can download and run the uninstall script.

Create starter apps

To create an app, just click one of the IBM Cloud starter kit tiles in your OpenShift Developer Catalog. Then follow the steps in the wizard to deploy your app.

Learn more

You can learn more information about Red Hat OpenShift on IBM Cloud on the product documentation page and check out tutorials, videos, and code patterns on the IBM Developer component page.

Starter Kits are also available for deployment onto IBM Cloud Kubernetes Service and on Cloud Foundry. See What are starter kits? to learn more.