Skip to content

Commit c9c7b47

Browse files
committed
simplified the content
1 parent 8f6cb8b commit c9c7b47

1 file changed

Lines changed: 4 additions & 15 deletions

File tree

infra/samples/network_subnet_design.md

Lines changed: 4 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,14 @@ This guide explains how to use the sample Bicep program `network-subnet-design.b
55
## Purpose and Approach
66

77
- **Sample File:** `infra/samples/network-subnet-design.bicep`
8-
- **Reusable Modules:** All code in `infra/modules/network` is designed to be composable and reusable. You should not need to modify code in the modules folder.
8+
- **Reusable Modules:** All code in `infra/modules/network` is designed to be reusable. You should not need to modify code in the modules folder.
99
- **Custom Network File:** For your own solution, create a `network.bicep` in `infra/modules/` that represents your specific network design, using the modules as building blocks.
1010

1111
## How to Use the Sample
1212

1313
- The sample demonstrates how to deploy a virtual network, subnets, NSGs, Azure Bastion Host, and Jumpbox VM using parameters and reusable modules.
14-
- You can deploy the sample independently to validate your network design before integrating it into your main solution, modify the infra/modules/network.bicep using the validated and tested design.
1514
- The sample is parameterized, so you can easily adjust subnet names, address spaces, NSG rules, and delegations.
15+
- You can design and validate your network design with `infra/samples/network-subnet-design.bicep`, then integrate the code by updating `infra/modules/network.bicep` with your tested design.
1616

1717
## Key Features in the Sample
1818

@@ -26,8 +26,6 @@ This guide explains how to use the sample Bicep program `network-subnet-design.b
2626
- Example: The `web` subnet allows HTTPS inbound from anywhere; the `app` subnet allows traffic from the `web` subnet, etc.
2727
- **Bastion and Jumpbox:**
2828
- Optional Azure Bastion Host and Jumpbox VM are included for secure management access.
29-
- **Composability:**
30-
- All modules in `infra/modules/network` are designed to be reused without modification.
3129

3230
## Example Workflow
3331

@@ -38,7 +36,7 @@ This guide explains how to use the sample Bicep program `network-subnet-design.b
3836
3. **Deploy the Sample:**
3937
- Use Azure Developer CLI (`azd`) or Azure CLI to deploy the sample and validate your design.
4038
4. **Integrate into Solution:**
41-
- Once validated, use the same approach to build your own `network.bicep` in `infra/modules/` for your production solution.
39+
- Once validated, use the same approach to build your own `network.bicep` in `infra/modules/` for your solution. Test your solution with i`nfra/main.bicep`.
4240

4341
## Example Directory Structure
4442

@@ -49,7 +47,7 @@ infra/
4947
... (reusable modules)
5048
network.bicep # <-- your custom network design
5149
samples/
52-
network-subnet-design.bicep # <-- sample for reference
50+
network-subnet-design.bicep # <-- reference
5351
```
5452

5553
## Best Practices
@@ -58,12 +56,3 @@ infra/
5856
- Reuse modules as much as possible to reduce duplication and improve maintainability.
5957
- Clearly document subnet address ranges, NSG rules, and any special configuration in comments.
6058
- Validate your design with Azure best practices for security, scalability, and manageability.
61-
62-
## Next Steps
63-
64-
- Use this document as a living reference. Update it as your solution and requirements evolve.
65-
- Refer to the sample and module documentation for advanced scenarios (e.g., private endpoints, delegations, Bastion, Jumpbox).
66-
67-
---
68-
69-
*This guide is based on the latest comments and structure in `network-subnet-design.bicep`. Update as your solution matures.*

0 commit comments

Comments
 (0)