Skip to content

IBM-Cloud/get-started-java

Repository files navigation

Liberty getting started application

The Getting Started tutorial for Liberty uses this sample application to provide you with a sample workflow for working with any Liberty app on IBM Cloud or in IBM Cloud Private; you set up a development environment, deploy an app locally and on the cloud, and then integrate an IBM Cloud database service in your app.

The Liberty app may use either the Cloudant Java Client or the MongoDB Java Client to add information to a database and then return information from a database to the UI.

Gif of the sample app contains a title that says, Welcome, a prompt asking the user to enter their name, and a list of the database contents which are the names Joe, Jane, and Bob. The user enters the name, Mary and the screen refreshes to display, Hello, Mary, I've added you to the database. The database contents listed are now Mary, Joe, Jane, and Bob.

Before you begin

You'll need a IBM Cloud account, Git, Cloud Foundry CLI, and Maven installed. If you use IBM Cloud Private, you need access to the IBM Cloud Private Cloud Foundry environment.

Instructions

IBM Cloud Cloud Foundry: Getting started tutorial for Liberty.

IBM Cloud Kubernetes Service: README_kubernetes.md

IBM Cloud Private: The starter application for IBM Cloud Private guides you through a similar process. However, instead of hosting both your service and application in the same cloud environment, you use a user-provided service. This guide shows you how to deploy your application to IBM Cloud Private and bind it to a Cloudant Database in IBM Cloud. For the complete procedure, see Working with user-provided services and the Liberty starter app.