The reliable web app pattern is a set of objectives to help your web application converge on the cloud. This repo contains a reference implementation of a reliable web application for Java.
MIT License
📣 Got feedback? Fill out this survey to help us shape the future of Enterprise App Patterns and understand whether we're focusing on the business goals and features important to you. Microsoft Privacy Statement
The reference implementation provides a production-grade web application that uses best practices from our guidance and gives developers concrete examples to build their own Reliable Web Application in Azure. This repository specifically demonstrates a Customer Account Management System (CAMS) application for the fictional company Contoso Fiber, embodying the reliable web app pattern with a focus on Java technologies. It guides developers through a simulated migration from an on-premises web application to Azure, detailing the architectural changes and enhancements that capitalize on the cloud's strengths during the initial adoption phase.
This project has a companion article in the Azure Architecture Center and self-paced workshop that describes design patterns and best practices that details the reliable web app pattern for Java web app.
Here's an outline of the contents in this readme:
Contoso Fiber aligned to a hub and spoke network topology in the production deployment architecture to centralize common resources. This network topology provided cost savings, enhanced security, and facilitated network integration (platform and hybrid):
This diagram describes the production deployment which is described in the prod-deployment.md file. The following steps below are for a development deployment which is a simplified version.
This description details the workflow for Contoso Fiber's CAMs application. It highlights key components and functionality to help you emulate its design:
The following detailed deployment steps assume you are using a Dev Container inside Visual Studio Code.
For your convenience, we use Dev Containers with a fully-featured development environment. If you prefer to use another editor, we recommend installing the necessary dependencies and skip to the deployment instructions starting in Step 3.
For Windows users, we recommend using Windows Subsystem for Linux (WSL) to improve Dev Container performance.
wsl
Clone the repository and open the project using the Dev Container.
git clone https://github.com/Azure/reliable-web-app-pattern-java.git
cd reliable-web-app-pattern-java
If required, ensure Docker Desktop is started. Open the repository folder in Visual Studio Code. You can do this from the command prompt:
code .
Once Visual Studio Code is launched, you should see a popup allowing you to click on the button Reopen in Container.
If you don't see the popup, open the Visual Studio Code Command Palette to execute the command. There are three ways to open the command palette:
Once the command palette is open, search for Dev Containers: Rebuild and Reopen in Container
.
Before deploying, you must be authenticated to Azure and have the appropriate subscription selected. Run the following command to authenticate:
az login
If you have multiple tenants, you can use the following command to log into the tenant:
az login --tenant <tenant-id>
Set the subscription to the one you want to use (you can use az account list to list available subscriptions):
export AZURE_SUBSCRIPTION_ID="<your-subscription-id>"
az account set --subscription $AZURE_SUBSCRIPTION_ID
Use the next command to login with the Azure Dev CLI (AZD) tool:
azd auth login
If you have multiple tenants, you can use the following command to log into the tenant:
azd auth login --tenant-id <tenant-id>
Next we provide the AZD tool with variables that it uses to create the deployment. The first thing we initialize is the AZD environment with a name.
The environment name should be less than 18 characters and must be comprised of lower-case, numeric, and dash characters (for example, contosowebapp
). The environment name is used for resource group naming and specific resource naming.
By default, Azure resources are sized for a development deployment. If doing a production deployment, see the production deployment instructions for more detail.
azd env new <pick_a_name>
Select the subscription that will be used for the deployment:
azd env set AZURE_SUBSCRIPTION_ID $AZURE_SUBSCRIPTION_ID
Set the Azure region to be used:
azd env set AZURE_LOCATION <pick_a_region>
Optional: Set the App Registration Service Management Reference:
azd env set AZURE_SERVICE_MANAGEMENT_REFERENCE <service_management_reference>
Run the following command to create the Azure resources and deploy the code (about 15-minutes to complete):
azd up
Navigate to the Front Door URL in a browser to view the Contoso Fiber CAMS application. Use the Endpoint URL from the output of the deployment.
You will see an output similar to the following:
Deploying services (azd deploy)
(✓) Done: Deploying service application
- Endpoint: https://fd-contosocams-dev-frcfgefndcctbgdh.z02.azurefd.net
You can learn more about the web app by reading the Pattern Simulations documentation.
Run the following command to tear down the deployment:
azd down --purge --force
The RWA 1.0 Proseware implementation can be found in the proseware branch.
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.
The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkId=521839. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
Telemetry collection is on by default.
To opt out, run the following command azd env set ENABLE_TELEMETRY
to false
in your AZD environment.