Deploying Your First Application
Wiki Home ▸ [Getting Started Guide](Getting Started Guide) ▸ Deploying your First Application
If you are new to deploying apps on the Trusted Analytics platform (TAP) or an instance of Cloud Foundry, these steps will guide you through the process.
Aside from having an IDE to code your application, the primary tool to deploy apps is the CLI (Command Line Interface) for Cloud Foundry. You can prepare your environment and install this tool by visiting this page or going to TAP Console >> Main navigation panel >> App Development.
A helpful Cloud Foundry application is "Spring Music", which you can clone from github here: https://github.com/cloudfoundry-samples/spring-music. This application requires little knowledge of the platform and also features hooks for MongoDB, a good service to be familiar with.
The TAP team has also built a sample application for working with this platform and pulling data from hdfs. While more advanced, this is also a good application example to clone and explore: https://github.com/trustedanalytics/dataset-reader-sample. We've created a full workflow around this application as it explains in more detail how to build applications around data ingested into TAP. You can view this workflow here: https://github.com/trustedanalytics/dataset-reader-sample/wiki/HDFS-Dataset-Reader-App-Exercise-for-Trusted-Analytics
In order to deploy Java applications to the Trusted Analytics platform, you must assemble them using a tool like Maven. You can download Maven here: https://maven.apache.org/download.cgi. If you are new to Maven, here are the steps to better understand the building/assembly process: https://maven.apache.org/guides/getting-started/.
Use Cloud Foundry CLI to push the application to your TAP instance.
$ cf login -a <Your TAP instance Endpoint>
API endpoint: <Your TAP instance Endpoint>
Username> your_username
Password> your_password
Org> your_org
your_space
$ cf push your_app
With the application successfully pushed, you can now view it on your instance of TAP. Go the TAP Console >> Applications to view the app's instance. Clicking the URL will load the app. Clicking "See details" will reveal the profile of the application with controls to start|stop|restage it.
The service brokerage of TAP, found in Console >> Marketplace, makes it easy to add popular services like MongoDB to your application. This highlight extensible aspect of TAP and Cloud Foundry allows you to easily integrate instances of data stores as well as 3rd party services to your app. You can also programmatically add services, including making your own server logs available as a service.
Continuing with the "Spring Music" application example above, you can easily create and bind an instance of the MongoDB service to your application. This is helpful since, up until now, the application has only been storing entries in its own memory. Should the application need to be restaged, it will lose all its data.
Go to Console >> Marketplace and browse to the "MongoDB" service. Click on it and in the service's profile, add a new instance with name "myMongo". Once available, the instance will list which space it is available in (see below).
Going back to Console >> Applications, view your "spring-music" profile by clicking the "See details" link. Click on the "Bindings" tab. You should see the "myMongo" instance listed in the "Available service instances" to the right. Click "Bind". You will now be prompted to click "Restage" so the application will be restaged and bound to the MongoDB instance you created. Once restaged, all data entered will be stored in the MongoDB instance, thus creating a persistent data store for the application.
