{"id":15291456,"url":"https://github.com/azure/bicep-lz-vending","last_synced_at":"2025-10-31T14:30:28.696Z","repository":{"id":48274243,"uuid":"513104866","full_name":"Azure/bicep-lz-vending","owner":"Azure","description":"Bicep module \u0026 pipelines to deploy landing zone subscriptions","archived":false,"fork":false,"pushed_at":"2024-08-21T14:56:39.000Z","size":474,"stargazers_count":118,"open_issues_count":12,"forks_count":41,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-02-16T22:11:33.182Z","etag":null,"topics":["azure","bicep","landing-zone","landing-zones","subscription","subscriptions","vending-machine"],"latest_commit_sha":null,"homepage":"","language":"Bicep","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Azure.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-12T10:53:16.000Z","updated_at":"2024-12-30T22:27:08.000Z","dependencies_parsed_at":"2023-12-17T10:22:04.547Z","dependency_job_id":"25fcc95b-699e-431e-86f9-031feec9ef04","html_url":"https://github.com/Azure/bicep-lz-vending","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fbicep-lz-vending","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fbicep-lz-vending/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fbicep-lz-vending/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fbicep-lz-vending/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Azure","download_url":"https://codeload.github.com/Azure/bicep-lz-vending/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239201673,"owners_count":19599079,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["azure","bicep","landing-zone","landing-zones","subscription","subscriptions","vending-machine"],"created_at":"2024-09-30T16:12:33.841Z","updated_at":"2025-10-31T14:30:28.630Z","avatar_url":"https://github.com/Azure.png","language":"Bicep","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bicep landing zone vending module for Azure\n\n[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/azure/bicep-lz-vending.svg)](http://isitmaintained.com/project/azure/bicep-lz-vending \"Average time to resolve an issue\")\n[![Percentage of issues still open](http://isitmaintained.com/badge/open/azure/bicep-lz-vending.svg)](http://isitmaintained.com/project/azure/bicep-lz-vending \"Percentage of issues still open\")\n[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/Azure/bicep-lz-vending/badge)](https://scorecard.dev/viewer/?uri=github.com/Azure/bicep-lz-vending)\n\n_____________________________________________________________________________________________________________________________________\n\n## ⚠️⚠️ Repository archival notice ⚠️⚠️\n\nWe would like to inform you that this repository has been **archived** and the Bicep landing zone vending module for Azure now has a new home in the [Bicep public registry](https://aka.ms/lz-vending/bicep) and is now a pattern module in the [Azure Verified Modules](https://aka.ms/avm) initiative.\n\n### What does this mean?\n\n- This repository is now in a **read-only** state.\n- No further issues, pull requests, or updates will be maintained on this repository.\n- All future releases, fixes and improvements will be managed in the new AVM pattern module hosted on the [Bicep public registry](https://aka.ms/lz-vending/bicep).\n- We will continue to leverage the [Wiki](https://github.com/azure/bicep-lz-vending/wiki) in this repository as the module's additional documentation and guidance location.\n\n### Why was this done?\n\nWe are converting this module to be an [Azure Verified pattern module](https://aka.ms/avm) to better align with the [Azure Verified Modules](https://azure.github.io/Azure-Verified-Modules/concepts/what-why-how/) initiative. This will help us align with the Well-architected framework guidance, have improved [module support](https://azure.github.io/Azure-Verified-Modules/help-support/module-support/) and provide you with a consistent experience consuming [AVM Bicep modules](https://azure.github.io/Azure-Verified-Modules/indexes/bicep/).\n\n📒 If you are not familiar with [Azure Verified Modules](https://aka.ms/avm), you can watch the following Youtube videos for a quick overview:\n\n- [An Introduction to Azure Verified Modules (AVM) by the Customer Architecture \u0026 Engineering team](https://youtu.be/JbIMrJKW5N0?si=4v69hlyBbINufHEO) 📽️🎬🎞️\n- [Azure Verified Modules Overview by John Savill](https://youtu.be/3FeIFHaJOtg?si=ZDXJ3EPwT9Xlzq2P) 📽️🎬🎞️\n\n### If I'm already using the Bicep Subscription vending module from the Bicep public registry, what do I need to change?\n\nWe tried as much as possible to have a smooth transition path with minimal breaking changes. To switch to the new module:\n\n- Review the documentation for the [new AVM module](https://aka.ms/lz-vending/bicep).\n- Change the module reference in your code to reference `br/public:avm/ptn/lz/sub-vending:x.x.x` instead of `br/public:lz/sub-vending:x.x.x`\n- If you have a preference on sharing deployment elemetry for this module, the parameter `disableTelemetry` has been changed to `enableTelemetry`. This change is due to AVM modules mandate the use of this parameter.\n\n\u003e **NOTE:** After the migration to Azure Verified Modules, version `1.5.2` of the Subscription Vending module is now `0.1.0` in the [Bicep public registry](https://aka.ms/lz-vending/bicep).\n\n### Feedback\n\nFor any issues, suggestions or feedback for this module, please open an issue on the [Bicep public registry](https://github.com/Azure/bicep-registry-modules/issues).\n\nThank you for your understanding and continued support.\n\n__________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________;\n\n## Overview\n\n\u003e ℹ️ This module requires the usage of Bicep version `v0.11.1` or later. For details on installing/upgrading Bicep see: [Install Bicep tools](https://learn.microsoft.com/azure/azure-resource-manager/bicep/install) ℹ️\n\u003e\n\u003e ℹ️ This module is also available on the Bicep Module Registry [here](https://github.com/Azure/bicep-registry-modules/tree/main/avm/ptn/lz/sub-vending). Examples also included in our [wiki examples](https://github.com/Azure/bicep-lz-vending/wiki/examples). ℹ️\n\nThe landing zone Bicep modules are designed to accelerate deployment of the individual landing zones (aka Subscriptions) within an Microsoft Entra Tenant.\n\n\u003e See the different types of landing zones in the Azure Landing Zones documentation here: [What is an Azure landing zone? - Platform vs. application landing zones](https://learn.microsoft.com/azure/cloud-adoption-framework/ready/landing-zone/#platform-vs-application-landing-zones)\n\nThe modules are designed to be instantiated many times, once for each desired landing zone.\n\nThis is currently split logically into the following capabilities:\n\n- Subscription creation and management group placement\n- Networking - deploy a Virtual Network with, optional:\n  - Hub \u0026 spoke connectivity (peering to a hub Virtual Network)\n  - Virtual WAN connectivity (peering to a Virtual Hub via a Virtual Hub Connection)\n    - Including support for connections to Virtual WAN Hubs with Routing Intent configured\n  - Link to existing DDoS Network Protection Plan\n  - Specify Custom DNS Servers\n- Role assignments\n- Tags\n- Resource providers and resource providers features registration\n\n\u003e When creating Virtual Network peerings, be aware of the [limit of peerings per Virtual Network.](https://learn.microsoft.com/azure/azure-resource-manager/management/azure-subscription-service-limits?toc=%2Fazure%2Fvirtual-network%2Ftoc.json#azure-resource-manager-virtual-networking-limits)\n\nWe would like feedback on what's missing in the module. Please raise an [issue](https://github.com/Azure/bicep-lz-vending/issues) if you have any suggestions.\n\n## Community Events/Recordings\n\n- [Bicep Community Call - November 2022](https://youtu.be/hu0PgCamxt0?t=1038) 📽️🎬🎞️\n\n## Change Log/Releases\n\nPlease see this repositories [GitHub releases](https://github.com/Azure/bicep-lz-vending/releases) for information on the latest changes and releases.\n\n## Wiki\n\nPlease see the content in the [wiki](https://github.com/Azure/bicep-lz-vending/wiki) for more detailed information about the module and various other pieces of documentation.\n\n## Known Issues\n\nPlease see the [Known Issues in the wiki](https://github.com/Azure/bicep-lz-vending/wiki/knownissues).\n\n## Parameters for module `main.bicep`\n\n**Parameters documented here: [`main.bicep.parameters.md`](main.bicep.parameters.md).**\n\nDetails on each of the parameters, including examples and an [example parameter file](main.bicep.parameters.md#parameter-file) (this is not a valid parameter file as all parameters contain values, so you must remove the un-required parameters or set them back to their default value, as documented), for the [`main.bicep`](main.bicep) module can be found [here: `main.bicep.parameters.md`](main.bicep.parameters.md).\n\n\u003e These docs are automatically generated using [PSDocs.Azure](https://azure.github.io/PSDocs.Azure) from the Bicep module file itself and [this GitHub Action](.github/workflows/update-bicep-module-docs.yml) as part of PRs that amend this Bicep module.\n\n## Consumer Guide\n\nWe have a [Consumer Guide](https://github.com/azure/bicep-lz-vending/wiki/consumerguide) available for guidance on how to consume this module.\n\n## Example\n\n\u003e For more examples please see the [wiki](https://github.com/Azure/bicep-lz-vending/wiki) and if you cannot find an example you are looking for please [raise an issue](https://github.com/Azure/bicep-lz-vending/issues/new/choose) on the repo 👍\n\nBelow is an example showing how to use this module.\n\nMost commonly this module will be deployed using [PowerShell](https://learn.microsoft.com/powershell/scripting/overview), with the [Azure Az Module](https://learn.microsoft.com/powershell/azure/what-is-azure-powershell), with a supporting `.json` parameters file, one per landing zone to create/vend. Or the same approach but using the [Azure CLI](https://learn.microsoft.com/cli/azure/what-is-azure-cli).\n\n\u003e **IMPORTANT:** The below example requires you have cloned/downloaded the entire repo and have it available at run-time on the machine running the below commands. It is also expected you are in the root of the cloned/extracted repository; otherwise paths will need to be changed in the below example.\n\n### PowerShell Example\n\n```powershell\n$inputObject = @{\n  DeploymentName        = 'lz-vend-{0}' -f (-join (Get-Date -Format 'yyyyMMddTHHMMssffffZ')[0..63])\n  ManagementGroupId     = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' # Set this to the Management Group ID you wish to target the deployment against. NOTE: This isn't the Management Group that the Subscription will be moved to, that is specified via the parameters.\n  Location              = 'uksouth' # Set this to the Azure Region you wish the deployment to be targeted against. NOTE: This isn't the Region that the Subscription's resources will be deployed to, that is specified via the parameters.\n  TemplateParameterFile = './landingZones/lz1.parameters.json' # This would be changed to the specific file per landing zone.\n  TemplateFile          = \"./main.bicep\" # Set this to the path where you have checked out this repo to.\n}\n\nNew-AzManagementGroupDeployment @inputObject\n```\n\n### Azure CLI Example\n\n```bash\ndateYMD=$(date +%Y%m%dT%H%M%S%NZ)\nDEPLOYMENTNAME=\"lz-vend-${dateYMD}\"\nMANAGEMENTGROUPID=\"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\" # Set this to the Management Group ID you wish to target the deployment against. NOTE: This isn't the Management Group that the Subscription will be moved to, that is specified via the parameters.\nLOCATION=\"uksouth\" # Set this to the Azure Region you wish the deployment to be targeted against. NOTE: This isn't the Region that the Subscription's resources will be deployed to, that is specified via the parameters.\nTEMPLATEPARAMETERFILE=\"@/landingZones/lz1.parameters.json\" # This would be changed to the specific file per landing zone.\nTEMPLATEFILE=\"/main.bicep\" # Set this to the path where you have checked out this repo to.\n\naz deployment mg create --name ${DEPLOYMENTNAME:0:63} --parameters $TEMPLATEPARAMETERFILE --location $LOCATION --management-group-id $MANAGEMENTGROUPID --template-file $TEMPLATEFILE\n```\n\n## Contributing\n\nThis project welcomes contributions and suggestions.\nMost contributions require you to agree to a Contributor License Agreement (CLA)\ndeclaring that you have the right to, and actually do, grant us the rights to use your contribution.\nFor details, visit [https://cla.opensource.microsoft.com](https://cla.opensource.microsoft.com).\n\nWhen you submit a pull request, a CLA bot will automatically determine whether you need to provide\na CLA and decorate the PR appropriately (e.g., status check, comment).\nSimply follow the instructions provided by the bot.\nYou will only need to do this once across all repos using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or\ncontact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n\u003e Details on contributing to this repo can be found [here in the wiki](https://github.com/azure/bicep-lz-vending/wiki/contributing) 👍\n\n## Telemetry\n\nWhen you deploy the Bicep landing zone vending module for Azure module, Microsoft can identify the installation of said module/s with the deployed Azure resources. Microsoft can correlate these resources used to support the software. Microsoft collects this information to provide the best experiences with their products and to operate their business. The telemetry is collected through customer usage attribution. The data is collected and governed by [Microsoft's privacy policies](https://www.microsoft.com/trustcenter).\n\nIf you don't wish to send usage data to Microsoft, details on how to turn it off can be found [here.](https://github.com/azure/bicep-lz-vending/wiki/telemetry).\n\n## Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services.\nAuthorized use of Microsoft trademarks or logos is subject to and must follow\n[Microsoft's Trademark \u0026 Brand Guidelines](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\nAny use of third-party trademarks or logos are subject to those third-party's policies.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazure%2Fbicep-lz-vending","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazure%2Fbicep-lz-vending","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazure%2Fbicep-lz-vending/lists"}