From d7281c5294bae1c61446fb4d4244b92e851e79db Mon Sep 17 00:00:00 2001 From: Matt White <16320656+matt-FFFFFF@users.noreply.github.com> Date: Wed, 30 Oct 2024 14:33:33 +0000 Subject: [PATCH] wip: initial networking content --- .../customer-landing-zone-journey.png | Bin docs/content/_index.md | 2 +- docs/content/terraform/2_networking.md | 5 ---- docs/content/terraform/3_alzcore.md | 5 ++++ docs/content/terraform/networking/_index.md | 24 ++++++++++++++++++ .../terraform/networking/a_hubnetworking.md | 8 ++++++ .../terraform/networking/b_virtualwan.md | 5 ++++ .../terraform/networking/c_privatedns.md | 5 ++++ docs/content/terraform/networking/d_ddos.md | 5 ++++ docs/data/menu/extra.yaml | 4 +-- 10 files changed, 55 insertions(+), 8 deletions(-) rename docs/content/{img => _img}/customer-landing-zone-journey.png (100%) delete mode 100644 docs/content/terraform/2_networking.md create mode 100644 docs/content/terraform/3_alzcore.md create mode 100644 docs/content/terraform/networking/_index.md create mode 100644 docs/content/terraform/networking/a_hubnetworking.md create mode 100644 docs/content/terraform/networking/b_virtualwan.md create mode 100644 docs/content/terraform/networking/c_privatedns.md create mode 100644 docs/content/terraform/networking/d_ddos.md diff --git a/docs/content/img/customer-landing-zone-journey.png b/docs/content/_img/customer-landing-zone-journey.png similarity index 100% rename from docs/content/img/customer-landing-zone-journey.png rename to docs/content/_img/customer-landing-zone-journey.png diff --git a/docs/content/_index.md b/docs/content/_index.md index d7f2327..a24e1ff 100644 --- a/docs/content/_index.md +++ b/docs/content/_index.md @@ -2,7 +2,7 @@ title: Azure Landing Zones Documentation resources: - name: alz-journey - src: img/customer-landing-zone-journey.png + src: _img/customer-landing-zone-journey.png alt: Azure Landing Zones Journey title: Azure Landing Zones Journey --- diff --git a/docs/content/terraform/2_networking.md b/docs/content/terraform/2_networking.md deleted file mode 100644 index 62b8bb1..0000000 --- a/docs/content/terraform/2_networking.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -Title: 2. Networking ---- - -TBC... diff --git a/docs/content/terraform/3_alzcore.md b/docs/content/terraform/3_alzcore.md new file mode 100644 index 0000000..27b4fb9 --- /dev/null +++ b/docs/content/terraform/3_alzcore.md @@ -0,0 +1,5 @@ +--- +Title: 3. Azure Landing Zones Core +--- + +TBC... diff --git a/docs/content/terraform/networking/_index.md b/docs/content/terraform/networking/_index.md new file mode 100644 index 0000000..6bca8e9 --- /dev/null +++ b/docs/content/terraform/networking/_index.md @@ -0,0 +1,24 @@ +--- +Title: 2. Networking +--- + +The Azure Landing Zones platform provides two networking topologies: hub and spoke & Azure Virtual WAN. +FOr more information on defining the networking topology, see the [networking topology](https://learn.microsoft.comß/azure/cloud-adoption-framework/ready/azure-best-practices/define-an-azure-network-topology) section of the Cloud Adoption Framework documentation. + +Follow the links to select the network topology that best fits your requirements: + +- [Hub and spoke](a_hubnetworking) +- [Azure Virtual WAN](b_virtualwan) + +We recommend that you also deploy the private DNS zones required for private link services: + +- [Private DNS zones](c_privatedns) + +Finally, we recommend that you deploy a DDoS protection plan to protect your core network: + +- [DDoS protection plan](d_ddos) + +## Repository Structure + +Many customers have dedicated network teams that are responsible for the network infrastructure. +In this situation it often makes sense to host the networking code in a separate repository to that of Azure Landing Zones. diff --git a/docs/content/terraform/networking/a_hubnetworking.md b/docs/content/terraform/networking/a_hubnetworking.md new file mode 100644 index 0000000..774c217 --- /dev/null +++ b/docs/content/terraform/networking/a_hubnetworking.md @@ -0,0 +1,8 @@ +--- +Title: (a) Hub Networking +--- + +We provide an Azure Verified Module to help you deploy a hub networking topology in your Azure environment. +Please see the [module registry page](https://registry.terraform.io/modules/Azure/avm-ptn-hubnetworking/azurerm/latest) for more information. + +You should use your connectivity subscription for the hub networking deployment. diff --git a/docs/content/terraform/networking/b_virtualwan.md b/docs/content/terraform/networking/b_virtualwan.md new file mode 100644 index 0000000..b45e288 --- /dev/null +++ b/docs/content/terraform/networking/b_virtualwan.md @@ -0,0 +1,5 @@ +--- +Title: (b) Virtual WAN +--- + +TBC... diff --git a/docs/content/terraform/networking/c_privatedns.md b/docs/content/terraform/networking/c_privatedns.md new file mode 100644 index 0000000..ef52960 --- /dev/null +++ b/docs/content/terraform/networking/c_privatedns.md @@ -0,0 +1,5 @@ +--- +Title: (c) Private DNS Zones for Private Link Services +--- + +TBC... diff --git a/docs/content/terraform/networking/d_ddos.md b/docs/content/terraform/networking/d_ddos.md new file mode 100644 index 0000000..c359b04 --- /dev/null +++ b/docs/content/terraform/networking/d_ddos.md @@ -0,0 +1,5 @@ +--- +Title: (d) DDoS Protection Plan +--- + +TBC... diff --git a/docs/data/menu/extra.yaml b/docs/data/menu/extra.yaml index 56a696f..1a736dc 100644 --- a/docs/data/menu/extra.yaml +++ b/docs/data/menu/extra.yaml @@ -1,10 +1,10 @@ --- header: - name: GitHub - ref: https://github.com/Azure/AzureLandingZones + ref: https://github.com/Azure/Azure-Landing-Zones icon: gdoc_github external: true - name: Issue - ref: https://github.com/Azure/AzureLandingZones/issues/new + ref: https://github.com/Azure/Azure-Landing-Zones/issues/new icon: bug external: true