Skip to content

Commit

Permalink
Split quick start and tidy
Browse files Browse the repository at this point in the history
  • Loading branch information
jaredfholgate committed Sep 15, 2023
1 parent cf7a010 commit 18e185e
Show file tree
Hide file tree
Showing 12 changed files with 286 additions and 797 deletions.
53 changes: 3 additions & 50 deletions docs/wiki/Frequently-Asked-Questions.md
Original file line number Diff line number Diff line change
@@ -1,55 +1,8 @@
<!-- markdownlint-disable first-line-h1 -->
## Azure landing zones Terraform module FAQ
## Azure landing zones Terraform accelerator FAQ

This article answers frequently asked questions relating to the Azure landing zones Terraform module.

- [Questions about the architecture](#questions-about-the-architecture)
- [Questions about the module](#questions-about-the-module)
- [How do I troubleshoot module errors?](#how-do-i-troubleshoot-module-errors)
- [How much does a typical deployment cost?](#how-much-does-a-typical-deployment-cost)
This article answers frequently asked questions relating to the Azure landing zones Terraform accelerator.

> If you have a question not listed here, please raise an [issue][github_issues] and we'll do our best to help.
### Questions about the architecture

Questions relating to the architecture can be found in the [Azure landing zone frequently asked questions (FAQ)](https://learn.microsoft.com/azure/cloud-adoption-framework/ready/enterprise-scale/faq) page on the Cloud Adoption Framework site.

### Questions about the module

#### How do I troubleshoot module errors?

There are various reasons why you might get an error when using this module.
To minimize errors caused by the module, we do our best to test the module before cutting a release.

If you observe an error, the first place to look is in our [Troubleshooting][wiki_troubleshooting] guide.

If the error you are seeing is not documented here, please check our existing issues before raising a new issue.

#### How much does a typical deployment cost?

The Azure landing zones Terraform module covers many different deployment scenarios, so costs can vary dramatically depending on what options are configured.

Some of these costs can come from resources deployed directly by the module.
Other costs may be incurred when Azure Policy performs remediation of non-compliant resources within scope of the deployment.

If you are looking to reduce costs as part of evaluating the module, we recommend assessing whether your evaluation needs to implement the following common resources which can incur the highest costs include:

- Microsoft Defender for Cloud
- Azure DDoS Network Protection
- Azure Firewall
- Azure Virtual Network Gateway (ExpressRoute/VPN)

Although our examples try to minimize the use of these resources and to use lower cost SKUs where applicable, please take care to ensure you understand which resources are being deployed and the associated costs these will incur.

In large environments, costs can also increase when large volumes of data are being stored in the Log Analytics workspace.

To see further guidance regarding costs for Azure landing zones, please refer to our [pricing guidance][alz_pricing] page.

[//]: # (************************)
[//]: # (INSERT LINK LABELS BELOW)
[//]: # (************************)

[github_issues]: https://github.com/Azure/terraform-azurerm-caf-enterprise-scale/issues "Azure landing zones Terraform module - Issues"
[alz_pricing]: https://github.com/Azure/Enterprise-Scale/wiki/What-is-Enterprise-Scale#pricing "Azure landing zones pricing guidance"

[wiki_troubleshooting]: Troubleshooting "Wiki - Troubleshooting"
This is a work in progress and will be completed over the next few months.
15 changes: 7 additions & 8 deletions docs/wiki/User-Guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,18 +5,17 @@ Please refer to the following to learn about the accelerator:

- [Getting Started][wiki_getting_started]
- [Quick Start][wiki_quick_start]
- [Module Permissions][wiki_module_permissions]
- [Module Variables][wiki_module_variables]
- [Module Releases][wiki_module_releases]
- [Provider Configuration][wiki_provider_configuration]
- [Quick Start Phase 1][wiki_quick_start_phase_1]
- [Quick Start Phase 2][wiki_quick_start_phase_2]
- [Quick Start Phase 3][wiki_quick_start_phase_3]


[//]: # (************************)
[//]: # (INSERT LINK LABELS BELOW)
[//]: # (************************)

[wiki_getting_started]: %5BUser-Guide%5D-Getting-Started "Wiki - Getting Started"
[wiki_quick_start]: %5BUser-Guide%5D-Quick-Start "Wiki - Quick Start"
[wiki_module_permissions]: %5BUser-Guide%5D-Module-Permissions "Wiki - Module Permissions"
[wiki_module_variables]: %5BUser-Guide%5D-Module-Variables "Wiki - Module Variables"
[wiki_module_releases]: %5BUser-Guide%5D-Module-Releases "Wiki - Module Releases"
[wiki_provider_configuration]: %5BUser-Guide%5D-Provider-Configuration "Wiki - Provider Configuration"
[wiki_quick_start_phase_1]: %5BUser-Guide%5D-Quick-Start-Phase-1 "Wiki - Quick Start - Phase 1"
[wiki_quick_start_phase_2]: %5BUser-Guide%5D-Quick-Start-Phase-2 "Wiki - Quick Start - Phase 2"
[wiki_quick_start_phase_3]: %5BUser-Guide%5D-Quick-Start-Phase-3 "Wiki - Quick Start - Phase 3"
73 changes: 0 additions & 73 deletions docs/wiki/[User-Guide]-Module-Permissions.md

This file was deleted.

63 changes: 0 additions & 63 deletions docs/wiki/[User-Guide]-Module-Releases.md

This file was deleted.

19 changes: 0 additions & 19 deletions docs/wiki/[User-Guide]-Module-Variables.md

This file was deleted.

Loading

0 comments on commit 18e185e

Please sign in to comment.