Skip to content

Commit 7f7a216

Browse files
docs: single region config files (Azure#210)
# Pull Request ## Description Update the docs to reference the single region config files for the VBD. ## License By submitting this pull request, I confirm that my contribution is made under the terms of the projects associated license.
1 parent fcf7adc commit 7f7a216

File tree

5 files changed

+36
-334
lines changed

5 files changed

+36
-334
lines changed

docs/wiki/[User-Guide]-Starter-Module-Bicep-Complete.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,6 @@
11
<!-- markdownlint-disable first-line-h1 -->
22
The `complete` starter module is currently the only option available for Bicep.
33

4-
Example input files can be found here:
5-
6-
- [inputs-azure-devops-bicep-complete.yaml][example_powershell_inputs_azure_devops_bicep_complete]
7-
- [inputs-github-bicep-complete.yaml][example_powershell_inputs_github_bicep_complete]
8-
- [inputs-local-bicep-complete.yaml][example_powershell_inputs_local_bicep_complete]
9-
104
The following table describes the inputs required for the `complete` starter module.
115

126
| Input | Placeholder | Description |
@@ -17,6 +11,12 @@ The following table describes the inputs required for the `complete` starter mod
1711
| `networkType` | `hubNetworking` | The type of network configuration to deploy. Currently only `hubNetworking`, `hubNetworkingMultiRegion`, `vwanConnectivity,` `vwanConnectivityMultiRegion` or `none` are supported. |
1812
| `SecurityContact` | `<email-address>` | The email address of the security contact for the landing zone. |
1913

14+
Example input files can be found here:
15+
16+
- [inputs-azure-devops-bicep-complete.yaml][example_powershell_inputs_azure_devops_bicep_complete]
17+
- [inputs-github-bicep-complete.yaml][example_powershell_inputs_github_bicep_complete]
18+
- [inputs-local-bicep-complete.yaml][example_powershell_inputs_local_bicep_complete]
19+
2020
[//]: # (************************)
2121
[//]: # (INSERT LINK LABELS BELOW)
2222
[//]: # (************************)

docs/wiki/[User-Guide]-Starter-Module-Terraform-Complete-Multi-Region.md

+20-19
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,9 @@
11
<!-- markdownlint-disable first-line-h1 -->
2-
The `complete_multi_region` starter module provides full customization of the Azure Landing Zone using the `config.yaml` file. The `config.yaml` file provides the ability to enable and disable modules, configure module inputs and outputs, and configure module resources. It is multi-regional by default and can support 2 or more regions.
2+
The `complete_multi_region` starter module provides full customization of the Azure Landing Zone using a YAML or JSON configuration file. The configuration file provides the ability to enable and disable modules, configure module inputs and outputs, and configure module resources. It is multi-regional by default and can support 1 or more regions.
33

4-
A custom config file can be passed to the `configuration_file_path` argument of the ALZ PowerShell Module. This allows you to firstly design your Azure Landing Zone, and then deploy it. The config file can be in `yaml` or `json` format, our examples are all `yaml`.
4+
A custom config file can be passed to the `configuration_file_path` argument of the ALZ PowerShell Module. This allows you to firstly design your Azure Landing Zone, and then deploy it. The config file can be in YAML or JSON format, our examples are all YAML.
55

6-
If not specified, the default `config-hub-and-spoke-vnet.yaml` file will be used, which can be seen [here](https://github.com/Azure/alz-terraform-accelerator/blob/main/templates/complete_multi_region/config-hub-and-spoke-vnet.yaml).
7-
8-
Example input files can be found here:
9-
10-
- [inputs-azure-devops-terraform-complete-multi-region.yaml][example_powershell_inputs_azure_devops_terraform_complete_multi_region]
11-
- [inputs-github-terraform-complete-multi-region.yaml][example_powershell_inputs_github_terraform_complete_multi_region]
12-
- [inputs-local-terraform-complete-multi-region.yaml][example_powershell_inputs_local_terraform_complete_multi_region]
6+
If not specified, the default `config-hub-and-spoke-vnet-multi-region.yaml` file will be used, which can be seen [here][example_starter_module_complete_config_hub_spoke_multi_region].
137

148
The following table describes the inputs required for the `complete_multi_region` starter module.
159

@@ -18,18 +12,24 @@ The following table describes the inputs required for the `complete_multi_region
1812
| `configuration_file_path` | `<configuration-file-path>` | This is the absolute path to the configuration file. E.g. `c:\my-config\config.yaml` or `~/my-config/config.yaml`. For YAML on Windows you will need to escape the `\`, i.e. `c:\\my-config\\config.yaml`. |
1913
| `default_postfix` | `<postfix>` | This is the default postfix used for resource names. |
2014

21-
You can create a custom yaml config to tailor to your needs, for example an Azure Landing Zone with a three-region mesh. Get started with our two region samples:
15+
Example input files can be found here:
2216

23-
- Example config file for hub and spoke virtual network: [config-hub-and-spoke-vnet.yaml][example_starter_module_complete_config_hub_spoke_multi_region]
24-
- Example config file for virtual WAN: [config-virtual-wan.yaml][example_starter_module_complete_config_vwan_multi_region]
17+
- [inputs-azure-devops-terraform-complete-multi-region.yaml][example_powershell_inputs_azure_devops_terraform_complete_multi_region]
18+
- [inputs-github-terraform-complete-multi-region.yaml][example_powershell_inputs_github_terraform_complete_multi_region]
19+
- [inputs-local-terraform-complete-multi-region.yaml][example_powershell_inputs_local_terraform_complete_multi_region]
2520

26-
## Further details on the Complete Starter Module and config file
21+
You can create a custom yaml config to tailor to your needs, for example an Azure Landing Zone with a three-region mesh. Get started with our samples:
2722

28-
The example config files have helpful templated variables such as `starter_location_##` and `root_parent_management_group_id` which get prompted for during the ALZ PowerShell Module run. Alternatively, you can opt to not use the templated variables and hard-code the values in your config file.
23+
- Multi region hub and spoke virtual network: [config-hub-and-spoke-vnet.yaml][example_starter_module_complete_config_hub_spoke_multi_region]
24+
- Multi region virtual WAN: [config-virtual-wan.yaml][example_starter_module_complete_config_vwan_multi_region]
25+
- Single region hub and spoke virtual network: [config-hub-and-spoke-vnet-single-region.yaml][example_starter_module_complete_config_hub_spoke_single_region]
26+
- Single region virtual WAN: [config-virtual-wan-single-region.yaml][example_starter_module_complete_config_vwan_single_region]
27+
28+
## Further details on the Complete Multi Region Starter Module and config file
2929

30-
> **Note:** We recommend that you use the `caf-enterprise-scale` module for management groups and policies, and the `hubnetworking` module for connectivity resources. However, connectivity resources can be deployed using the `caf-enterprise-scale` module if you desire.
30+
The example config files have helpful templated variables such as `starter_location_##` and `root_parent_management_group_id` which get prompted for during the ALZ PowerShell Module run. Alternatively, you can opt to not use the templated variables and hard-code the values in your config file.
3131

32-
The schema for the `config.yaml` is documented here - [Configuration YAML Schema][wiki_yaml_schema_reference].
32+
> **Note:** We use the `caf-enterprise-scale` module for management groups and policies, and the Azure Verified Modules for connectivity resources.
3333
3434
### High Level Design
3535

@@ -64,9 +64,10 @@ The `avm-ptn-network-private-link-private-dns-zones` module is used to deploy Pr
6464
[//]: # (INSERT LINK LABELS BELOW)
6565
[//]: # (************************)
6666

67-
[wiki_yaml_schema_reference]: %5BUser-Guide%5D-YAML-Schema-Reference "Wiki - YAML Schema Reference"
68-
[example_starter_module_complete_config_hub_spoke_multi_region]: examples/starter-module-config/complete-multi-region/config-hub-and-spoke-vnet.yaml "Example - Starter Module Config - Complete - Hub and Spoke VNet Multi Region"
69-
[example_starter_module_complete_config_vwan_multi_region]: examples/starter-module-config/complete-multi-region/config-virtual-wan.yaml "Example - Starter Module Config - Complete - Virtual WAN Multi Region"
67+
[example_starter_module_complete_config_hub_spoke_single_region]: https://raw.githubusercontent.com/Azure/alz-terraform-accelerator/refs/heads/main/templates/complete_multi_region/config-hub-and-spoke-vnet-single-region.yaml "Example - Starter Module Config - Complete - Hub and Spoke VNet Single Region"
68+
[example_starter_module_complete_config_vwan_single_region]: https://raw.githubusercontent.com/Azure/alz-terraform-accelerator/refs/heads/main/templates/complete_multi_region/config-virtual-wan-single-region.yaml "Example - Starter Module Config - Complete - Virtual WAN Single Region"
69+
[example_starter_module_complete_config_hub_spoke_multi_region]: https://raw.githubusercontent.com/Azure/alz-terraform-accelerator/refs/heads/main/templates/complete_multi_region/config-hub-and-spoke-vnet-multi-region.yaml "Example - Starter Module Config - Complete - Hub and Spoke VNet Multi Region"
70+
[example_starter_module_complete_config_vwan_multi_region]: https://raw.githubusercontent.com/Azure/alz-terraform-accelerator/refs/heads/main/templates/complete_multi_region/config-virtual-wan-multi-region.yaml "Example - Starter Module Config - Complete - Virtual WAN Multi Region"
7071
[example_powershell_inputs_azure_devops_terraform_complete_multi_region]: examples/powershell-inputs/inputs-azure-devops-terraform-complete-multi-region.yaml "Example - PowerShell Inputs - Azure DevOps - Terraform - Complete Multi Region"
7172
[example_powershell_inputs_github_terraform_complete_multi_region]: examples/powershell-inputs/inputs-github-terraform-complete-multi-region.yaml "Example - PowerShell Inputs - GitHub - Terraform - Complete Multi Region"
7273
[example_powershell_inputs_local_terraform_complete_multi_region]: examples/powershell-inputs/inputs-local-terraform-complete-multi-region.yaml "Example - PowerShell Inputs - Local - Terraform - Complete Multi Region"

docs/wiki/_Sidebar.md

+10-5
Original file line numberDiff line numberDiff line change
@@ -16,15 +16,18 @@
1616
- [Phase 3 - Run][wiki_quick_start_phase_3]
1717
- [Starter Modules][wiki_starter_modules]
1818
- [Bicep - Complete][wiki_starter_module_bicep_complete]
19+
- [Terraform - Complete Multi Region][wiki_starter_module_terraform_complete_multi_region]
20+
- [Example Multi Region Hub and Spoke config][example_starter_module_complete_config_hub_spoke_multi_region]
21+
- [Example Multi Region Virtual WAN config][example_starter_module_complete_config_vwan_multi_region]
22+
- [Example Single Region Hub and Spoke config][example_starter_module_complete_config_hub_spoke_single_region]
23+
- [Example Single Region Virtual WAN config][example_starter_module_complete_config_vwan_single_region]
1924
- [Terraform - Basic][wiki_starter_module_terraform_basic]
2025
- [Terraform - Hub Networking][wiki_starter_module_terraform_hubnetworking]
2126
- [Terraform - Complete][wiki_starter_module_terraform_complete]
2227
- [Configuration YAML Schema][wiki_yaml_schema_reference]
2328
- [Example Hub and Spoke config][example_starter_module_complete_config_hub_spoke]
2429
- [Example Virtual WAN config][example_starter_module_complete_config_vwan]
25-
- [Terraform - Complete Multi Region][wiki_starter_module_terraform_complete_multi_region]
26-
- [Example Multi Region Hub and Spoke config][example_starter_module_complete_config_hub_spoke_multi_region]
27-
- [Example Multi Region Virtual WAN config][example_starter_module_complete_config_vwan_multi_region]
30+
2831
- Input Files
2932
- [Azure DevOps Bicep Complete][example_powershell_inputs_azure_devops_bicep_complete]
3033
- [Azure DevOps Terraform Basic][example_powershell_inputs_azure_devops_terraform_basic]
@@ -99,5 +102,7 @@
99102
[example_powershell_inputs_local_terraform_complete_multi_region]: examples/powershell-inputs/inputs-local-terraform-complete-multi-region.yaml "Example - PowerShell Inputs - Local - Terraform - Complete Multi Region"
100103
[example_starter_module_complete_config_hub_spoke]: examples/starter-module-config/complete/config-hub-spoke.yaml "Example - Starter Module Config - Complete - Hub and Spoke"
101104
[example_starter_module_complete_config_vwan]: examples/starter-module-config/complete/config-vwan.yaml "Example - Starter Module Config - Complete - Virtual WAN"
102-
[example_starter_module_complete_config_hub_spoke_multi_region]: examples/starter-module-config/complete-multi-region/config-hub-and-spoke-vnet.yaml "Example - Starter Module Config - Complete - Hub and Spoke VNet Multi Region"
103-
[example_starter_module_complete_config_vwan_multi_region]: examples/starter-module-config/complete-multi-region/config-virtual-wan.yaml "Example - Starter Module Config - Complete - Virtual WAN Multi Region"
105+
[example_starter_module_complete_config_hub_spoke_single_region]: https://raw.githubusercontent.com/Azure/alz-terraform-accelerator/refs/heads/main/templates/complete_multi_region/config-hub-and-spoke-vnet-single-region.yaml "Example - Starter Module Config - Complete - Hub and Spoke VNet Single Region"
106+
[example_starter_module_complete_config_vwan_single_region]: https://raw.githubusercontent.com/Azure/alz-terraform-accelerator/refs/heads/main/templates/complete_multi_region/config-virtual-wan-single-region.yaml "Example - Starter Module Config - Complete - Virtual WAN Single Region"
107+
[example_starter_module_complete_config_hub_spoke_multi_region]: https://raw.githubusercontent.com/Azure/alz-terraform-accelerator/refs/heads/main/templates/complete_multi_region/config-hub-and-spoke-vnet-multi-region.yaml "Example - Starter Module Config - Complete - Hub and Spoke VNet Multi Region"
108+
[example_starter_module_complete_config_vwan_multi_region]: https://raw.githubusercontent.com/Azure/alz-terraform-accelerator/refs/heads/main/templates/complete_multi_region/config-virtual-wan-multi-region.yaml "Example - Starter Module Config - Complete - Virtual WAN Multi Region"

0 commit comments

Comments
 (0)