Skip to content

Commit 51aeb3e

Browse files
committed
edits
1 parent 10827ab commit 51aeb3e

File tree

1 file changed

+15
-1
lines changed

1 file changed

+15
-1
lines changed

articles/static-web-apps/publish-bicep.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,18 @@ To deploy your static web app, you need to:
2121
* [Static Web Apps CLI](https://github.com/Azure/static-web-apps-cli)
2222
* [GitHub Actions](https://docs.github.com/actions)
2323

24+
## Types of resource creation
25+
26+
Bicep is one of several types of resource creation. These types include:
27+
28+
* [Azure Resource Management](/azure/azure-resource-manager/) (ARM): implement infrastructure as code for your Azure solutions, use Azure Resource Manager templates (ARM templates). The template is a JavaScript Object Notation (JSON) file that defines the infrastructure and configuration for your project. This older style is still in use but generally updated to Bicep or Azure Verified Modules.
29+
* [Bicep](/azure/azure-resource-manager/Bicep/): Bicep is a domain-specific language (DSL) that uses declarative syntax to deploy Azure resources. In a Bicep file, you define the infrastructure you want to deploy to Azure, and then use that file throughout the development lifecycle to repeatedly deploy your infrastructure. Your resources are deployed in a consistent manner.
30+
* [Azure verified modules (AVM)](https://azure.github.io/Azure-Verified-Modules): These modules represent the only standard from Microsoft for Bicep modules in the [Bicep Public Registry](https://github.com/Azure/bicep-registry-modules/tree/main/avm). Use AVM when possible because it consolidates and set the standards for what a good Infrastructure-as-Code module looks like.
31+
* [Azure CLI](/cli/azure/)/[PowerShell](/powershell): These command line apps allow you to create resources. They have generally been superceded by Bicep and AVM but are still used for minor or quick fixes while the larger Bicep update may be more time-consuming.
32+
* [Azure portal](https://portal.azure.com/): Azure portal is a web-based visual interface for resource creation and configuration.
33+
34+
Creation and configuration can be done across all the tools listed above.
35+
2436
## Bicep by example
2537

2638
The Bicep examples in this article use [Azure Verified Modules (AVM)](https://azure.github.io/Azure-Verified-Modules/) when possible and [Bicep](/azure/azure-resource-manager/Bicep/) when AVM isn't available. You'll be able to recognize AVM because the referenced module includes `avm/res` such as `br/public:avm/res/web/static-site:0.3.0`.
@@ -40,6 +52,8 @@ module swa 'br/public:avm/res/web/static-site:0.3.0' = {
4052

4153
AVM allows you to adopt Bicep code, which has been built and is maintained by professional engineers fluent in Bicep. These modules aren't only supported and maintained, they're opinionated about what proper Bicep files look like.
4254

55+
Due to the work involved in owning and maintaining the AVM files, it takes time to specify the module, determine best practices, and find the appropriate owner/maintainer. For this reason, the module you need may not be available at this time.
56+
4357
## Prerequisites
4458

4559
- [Bicep](../azure-resource-manager/Bicep/install.md)
@@ -153,4 +167,4 @@ To learn more from a full end-to-end application that includes resource creation
153167
## Related content
154168

155169
* [Awesome AZD](https://azure.github.io/awesome-azd/?tags=swa)
156-
170+
* [Public Bicep Registry](https://github.com/Azure/bicep-registry-modules)

0 commit comments

Comments
 (0)