Deploy WSO2 API Cloud as an Add-on for Heroku¶
You can integrate WSO2 API Cloud with Heroku to provide API management capabilities for your Heroku applications and services.
Let's take a look at how you can expose and manage a Heroku backend using the WSO2 API Cloud add-on.
Tip
Before you begin,
- Create a WSO2 Cloud account and sign in.
- Go to https://www.heroku.com/ and create a Heroku account if you do not have one already.
- Download and Install the Heroku command line interface (CLI).
Let's get started.
Deploy a sample application on Heroku¶
You need to create a sample application on Heroku to understand how you can use WSO2 API Cloud to expose an application as an API.
Here we will use a simple node.js REST service application to create and deploy a sample application on Heroku. The sample application implements a simple echo service that takes a text parameter and returns the word Hello along with the specified parameter.
Follow the steps below to deploy a sample node.js
application on Heroku:
-
Execute the following command to clone the sample node.js REST service application:
git clone https://github.com/wso2/cloud-heroku-samples.git
-
Navigate to the directory where the sample application got cloned.
-
Execute the following command to create a new Heroku application:
heroku create
-
Execute the following command to deploy the sample code to the new Heroku application:
git push heroku master
-
Execute the following command to Ensure that you have at least one instance of the service running:
heroku ps:scale web=1
-
To verify that your web service is running, append
/hello?name=World
to the root URL of your Heroku application and navigate to it via your browser. For example, ifhttps://boiling-scrubland-10078.herokuapp.com/
is the root URL of your Heroku application, append/hello?name=World
to the URL (i.e.,https://boiling-scrubland-10078.herokuapp.com/hello?name=World
).
Associate your Heroku application with WSO2 API Cloud¶
Follow the steps below to provision the WSO2 API Cloud add-on to your Heroku application.
- Sign in to Heroku and go to the
Resources page of the new Heroku application you created.
- Under the Add-ons section, search for WSO2 API Cloud and select
it to provision the add-on.
- Select the appropriate Plan name and click Provision . This
lists WSO2 API Cloud under the Add-ons section.
- Click the WSO2 API Cloud add-on. You will be asked to provide your
WSO2 API Cloud password.
- Enter your WSO2 API Cloud password and click Submit . This takes you to a page where you need to select your WSO2 Cloud organization.
- Select the WSO2 Cloud organization that you want to associate with your Heroku account and click Go. This takes you to your WSO2 API Cloud dashboard.
Now that you have associated your Heroku application with the WSO2 API Cloud add-on, see the next section for information on how you can expose an API to your Heroku backend.
Define a managed API for your Heroku backend¶
Follow the steps below to expose an API to your Heroku backend.
-
On your WSO2 API Cloud dashboard, click ADD NEW API.
-
Select Design a New REST API and then click Start Creating.
-
Enter the following general details to design your API appropriately:
- Name :
Heroku
- Context :
heroku
- Version :
1.0
-
Visibility on Store :
Public
- Name :
-
In the API Definition section, enter
hello
as the URL Pattern, select GET, and then click Add.
-
Expand the new
/hello GET
method and add a new parameter as follows:
- Click Implement.
- Expand the Managed API section and provide your Heroku app’s root
URL as the Production endpoint.
- Click Manage.
- Under the Throttling Settings section, select Unlimited as
your API’s Subscription Tier.
- Set the API resource auth type to None :
- Click Save & Publish . This displays a message confirming that
you have successfully published your API.
- Click Go to API Store to open your API in the API store. API store is the developer portal of WSO2 API Cloud.
- In the API Store, click the API Console tab.
- Expand the
/hello
method of your API, provide a value for name (for example, World), and click Try it out!.
You will see that the API calls your backend service in Heroku and displays the execution results.
Now that you have successfully created an API for your Heroku application, you can try out the other API management capabilities that the WSO2 API Cloud add-on supports.
Top