How to Run and Deploy the Picture Finder App
Overview of the app
Use the IBM Bluemix Location services and Instagram to find pictures near an address. It's written in Node.js and uses the following Bluemix services:
- Pitney Bowes Geocoding service
Deploying the App and Binding the Geocoding Service
Multiple methods exist for interacting with the BlueMix platform. Outlined below are two of those methods:
Before we begin, we first need to install the cf command line tool that will be used to upload and manage your application. If you've previously installed an older version of the cf tool, make sure you are now using v6 of cf by passing it the -v flag:
In the terminal, go into the directory named app, and follow these steps.
Login to Bluemix.
$ cf login [-a API_URL] [-o ORG] [-s SPACE]
$ cf login -a https://api.ng.bluemix.net
Go to the Bluemix UI and create an instance of the Pitney Bowes Geocoding service. As part of the service creation you'll need to create a Pitney Bowes developer account and application.
From the directory that houses the app.js file (not from the root directory that contains this README.md file), push the app with the --no-start option so we can bind our required service before starting. Pass the -c flag to specify the start command that should be used by CloudFoundry to run your app. Be sure to give your app a unique app name to be used for its hostname; for instance the example below would result in http://picturefinder-jayallenmn.ng.bluemix.net.
$ cf push APP [--no-manifest] [--no-start] [-c COMMAND]
$ cf push picturefinder-<username> --no-manifest --no-start -c "node app.js"
Bind the Geocoding service instance you created previously to the new app
$ cf bind-service APP SERVICE_INSTANCE
$ cf bind-service picturefinder-<username> Geocoding-demo
Start the app
$ cf start APP
$ cf start picturefinder-<username>
Method: IBM DevOps Services
Browse to the DevOps Services project repository located here. Click on Edit Code for the project.
Click on "Fork". This will provide you with a personal copy of the code within your DevOps Services project space.
Located in the app directory of the project, rename manifest.yml.v5 to manifest.yml
Next, click on "Deploy". This will use information within the manifest.yml to deploy the sample application directly into the codename: BlueMix platform.
You may continue to deploy changes to your BlueMix application directly from DevOps Services using the "Deploy" and "Deploy As" buttons.
- Next, click on the Root Project Name and scroll to the Manual Deployment Information section.
You can check the status of the app using this section. If a green filled circle is visible, you may click the Application Name shown within the section and interact with the running application. However, if a red filled circle is displayed, you may click Manage and directly interact with the BlueMix User interface for further investigation and debugging.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.