ibmjstart/bluemix-picturefinder

Use the IBM Bluemix Location services and Instagram to find pictures near an address. Written in Node.js

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:

1. Command-Line
2. IBM DevOps Services

Method: Command-Line

Prerequisites

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:

cf -v

Steps

In the terminal, go into the directory named app, and follow these steps.

1. Login to Bluemix.

   usage:	$ cf login [-a API_URL] [-o ORG] [-s SPACE]
   example:	$ cf login -a https://api.ng.bluemix.net

2. 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.

3. 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.

   usage:	$ cf push APP [--no-manifest] [--no-start] [-c COMMAND]
   example:	$ cf push picturefinder-<username> --no-manifest --no-start -c "node app.js"

4. Bind the Geocoding service instance you created previously to the new app

   usage:	$ cf bind-service APP SERVICE_INSTANCE
   example:	$ cf bind-service picturefinder-<username> Geocoding-demo

5. Start the app

   usage:	$ cf start APP
   example:	$ cf start picturefinder-<username>

Method: IBM DevOps Services

1. Browse to the DevOps Services project repository located here. Click on Edit Code for the project.

2. Click on "Fork". This will provide you with a personal copy of the code within your DevOps Services project space.

3. Located in the app directory of the project, rename manifest.yml.v5 to manifest.yml

4. 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.

5. 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.

License

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

 http://www.apache.org/licenses/LICENSE-2.0

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.