Skip to content

Commit e6b8814

Browse files
Update DeploymentGuide.md
Updated content and maintained consistency.
1 parent 93a9323 commit e6b8814

1 file changed

Lines changed: 28 additions & 0 deletions

File tree

docs/DeploymentGuide.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,34 @@ Check the [Azure Products by Region](https://azure.microsoft.com/en-us/explore/g
3131

3232
## Deployment Options & Steps
3333

34+
### Sandbox or WAF Aligned Deployment Options
35+
36+
The [`infra`](../infra) folder contains the [`main.bicep`](../infra/main.bicep) Bicep script, which defines all Azure infrastructure components for this solution.
37+
38+
When running `azd up`, you’ll now be prompted to choose between a **WAF-aligned configuration** and a **sandbox configuration** using a simple selection:
39+
40+
- A **sandbox environment** — ideal for development and proof-of-concept scenarios, with minimal security and cost controls for rapid iteration.
41+
42+
- A **production deployments environment**, which applies a [Well-Architected Framework (WAF) aligned](https://learn.microsoft.com/en-us/azure/well-architected/) configuration. This option enables additional Azure best practices for reliability, security, cost optimization, operational excellence, and performance efficiency, such as:
43+
- Enhanced network security (e.g., Network protection with private endpoints)
44+
- Stricter access controls and managed identities
45+
- Logging, monitoring, and diagnostics enabled by default
46+
- Resource tagging and cost management recommendations
47+
48+
**How to choose your deployment configuration:**
49+
50+
When prompted during `azd up`:
51+
52+
![useWAFAlignedArchitecture](images/macae_waf_prompt.png)
53+
54+
- Select **`true`** to deploy a **WAF-aligned, production-ready environment**
55+
- Select **`false`** to deploy a **lightweight sandbox/dev environment**
56+
-
57+
> [!TIP]
58+
> Always review and adjust parameter values (such as region, capacity, security settings and log analytics workspace configuration) to match your organization’s requirements before deploying. For production, ensure you have sufficient quota and follow the principle of least privilege for all identities and role assignments.
59+
60+
### Deployment Steps
61+
3462
Pick from the options below to see step-by-step instructions for: GitHub Codespaces, VS Code Dev Containers, Local Environments, and Bicep deployments.
3563

3664
| [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/microsoft/Modernize-your-Code-Solution-Accelerator) | [![Open in Dev Containers](https://img.shields.io/static/v1?style=for-the-badge&label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/microsoft/Modernize-your-Code-Solution-Accelerator) |

0 commit comments

Comments
 (0)