Inventory Hub App using Java on Azure

The purpose of this sample application is to illustrate building responsive systems with serverless, event-driven Java on Azure; the result of this project will be to create a real-time inventory hub.

Requirements

In order to create and deploy this sample application, you need to have the following:

An Azure subscription; if you don't already have an Azure subscription, you can activate your MSDN subscriber benefits or sign up for a free Azure account.

In addition, you will need all of the following components before you go through the steps in this README:

| Azure CLI | Java 8 | Maven 3 | Git |

NOTE: There are additional requirements in the ~/deployment/README.md file which are required in order to setup your development environment; other required components will be installed automatically by the provisioning scripts.

Overview

In the following sections, you will create a development sandbox environment on Azure which uses the following components:

The following diagram illustrates the full topology for this sample application environment:

Create and Deploy the Inventory Hub

Create the initial build

  1. Open a command prompt and navigate to the ~/deployment/ folder of your local repo.
   cd deployment
  1. Login to your Azure account and specify which subscription to use:

    az login
    az account set --subscription "<your-azure-subscription>"

    NOTE: You can use either a subscription name or id when specifying which subscription to use; to obtain a list of your subscriptions, type az account list.

  2. Set a unique prefix for creating an initial layout on Azure.

    export INVENTORY_HUB_APP_NAME="<your-unique-prefix>"
  3. Follow the deployment README instructions to create Azure resources.

Deploy Inventory Processor

  1. Deploy Update Product Inventory function app as described in the README
  2. Deploy Append Transactions function app as described in the README

Deploy Inventory Dashboard Web App

  1. Deploy Inventory Dashboard Web app as described in README

Deploy POI and POS Terminals as Azure Function Apps

  1. Deploy Point of Inventory terminal as function app as described in README. Deploy one per terminal. If you were to imagine 4 terminals then you would deploy 4 similar function apps
  2. Deploy Point of Sale terminal as function app as described in README. Deploy one per terminal. If you were to imagine 4 terminals then you would deploy 4 similar function apps

Open the Inventory Hub Web App

Open the Inventory Hub Web app ...

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.