Deploy IBM Cloud starter kits on Red Hat OpenShift
Add IBM Cloud starter kits to your OpenShift Developer Catalog
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, 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:
- Log in to IBM Cloud and connect to your OpenShift cluster.
- Make sure that your cluster has the IBM Cloud Operator installed.
- Download and run this bash script. Be sure to make the
chmod +x install.shscript executable.
- When the script completes, wait a few minutes and then reload the Developer Catalog in your cluster console. Filter on the
IBMpublisher to find the installed starter kits.
- The new template appears in the Developer Catalog for the
defaultproject for your cluster. You can add the starter kits to other projects by modifying the installation script to include the
-nflag. For example,
oc apply -f templates/go-gin-app.json -n test_projectinstalls the starter in the project named
oc apply -f templates/go-gin-app.json -n openshiftinstalls the starter kit into the cluster Service Catalog.
- If you want to uninstall one starter kit, you can run the
oc deletecommand 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.
Starter Kits are also available for deployment onto IBM Cloud Kubernetes Service and on Cloud Foundry. See What are starter kits? to learn more.