Quickstart: Deploy a Java app to Azure Service Fabric on Linux

This quickstart shows how to deploy your first Java application to Azure Service Fabric using the Eclipse IDE on a Linux developer machine. When you're finished, you have a voting application with a Java web front end that saves voting results in a stateful back-end service in the cluster.

Azure Service Fabric is a distributed systems platform for deploying and managing microservices and containers.

Azure Service Fabric voting sample

In this quickstart, you learn how to:

  • Use Eclipse as a tool for your Service Fabric Java applications
  • Deploy the application to your local cluster
  • Scale-out the application across multiple nodes

Prerequisites

To complete this quickstart:

  1. Install Service Fabric SDK & Service Fabric Command Line Interface (CLI)
  2. Install Git
  3. Install Eclipse
  4. Set up Java Environment, making sure to follow the optional steps to install the Eclipse plug-in

Download the sample

In a command window, run the following command to clone the sample app repository to your local machine.

git clone https://github.com/Azure-Samples/service-fabric-java-quickstart.git

Run the application locally

  1. Start your local cluster by running the following command:

    sudo /opt/microsoft/sdk/servicefabric/common/clustersetup/devclustersetup.sh
    

    The startup of the local cluster takes some time. To confirm that the cluster is fully up, access the Service Fabric Explorer at http://localhost:19080. The five healthy nodes indicate the local cluster is up and running.

    Azure Service Fabric Explorer shows healthy nodes

  2. Open Eclipse.

  3. Select File > Import > Gradle > Existing Gradle Project and follow the wizard.

  4. Select Directory and choose the Voting directory from the service-fabric-java-quickstart folder you cloned from GitHub. Select Finish.

    Import Gradle project into Eclipse

  5. You now have the Voting project in the Package Explorer for Eclipse.

  6. Right-click on the project and select Publish Application under the Service Fabric dropdown. Choose PublishProfiles/Local.json as the Target Profile and select Publish.

    Azure Service Fabric publish local JSON

  7. Open your favorite web browser and access the application by accessing http://localhost:8080.

    Azure Service Fabric local host

You can now add a set of voting options, and start taking votes. The application runs and stores all data in your Service Fabric cluster, without the need for a separate database.

Scale applications and services in a cluster

Services can be scaled across a cluster to accommodate for a change in the load on the services. You scale a service by changing the number of instances running in the cluster. There are many ways of scaling your services; for example, you can use scripts or commands from Service Fabric CLI (sfctl). The following steps use Service Fabric Explorer.

Service Fabric Explorer runs in all Service Fabric clusters and can be accessed from a browser by browsing to the cluster's HTTP management port (19080); for example, http://localhost:19080.

To scale the web front-end service, do the following:

  1. Open Service Fabric Explorer in your cluster - for example, https://localhost:19080.

  2. Select the ellipsis (...) next to the fabric:/Voting/VotingWeb node in the treeview and select Scale Service.

    Scale a service in Azure Service Fabric

    You can now choose to scale the number of instances of the web front-end service.

  3. Change the number to 2 and select Scale Service.

  4. Select the fabric:/Voting/VotingWeb node in the tree-view and expand the partition node (represented by a GUID).

    Scaled service in Azure Service Fabric

    You can now see that the service has two instances, and in the tree view you see which nodes the instances run on.

Through this simple management task, you've doubled the resources available for the front-end service to process user load. It's important to understand that you don't need multiple instances of a service for it to run reliably. If a service fails, Service Fabric makes sure that a new service instance runs in the cluster.

Next steps

In this quickstart, you learned how to:

  • Use Eclipse as a tool for your Service Fabric Java applications
  • Deploy Java applications to your local cluster
  • Scale-out the application across multiple nodes

To learn more about working with Java apps in Service Fabric, continue to the tutorial for Java apps.