This post is organized into the pre-requisites, a sample bicep file for deploying a Resource Group, the harness, and how to put the two together. I’ll wrap it up with a summary which includes information on where to go from here.<\/p>\n\n\n\n
Pre-Requisites<\/strong><\/p>\n\n\n\n The Bicep File<\/strong><\/p>\n\n\n\n Type the following into a file and save it with a The first line sets the scope. Because we’re building a resource group, this is an item that must be targeted at the subscription scope. With the VS Code extension for bicep, as you start typing that first line you can see the various options available to you (this context sensitive help is quite useful when working with bicep).<\/p>\n\n\n\n The next block of code defines the type of resource we want to build and the various parameters. If you don’t know the exact formatting for a resource type, the context sensitive help can again be useful here. Below you can see that I start typing “resourcegroup” and the context sensitive help provides the full value (you can press “tab” to select \/ complete the line).<\/p>\n\n\n\n The same context help will pop up when selecting the version of the resource to use. I tend to always pick the latest.<\/p>\n\n\n\n Then as you begin to finalize the first row you have the option for VS Code to prepopulate the resource with the minimum required properties for the resource in question:<\/p>\n\n\n\n This can be helpful, especially when you begin browsing Microsoft’s documentation on the various resource types, some of which get pretty complex.<\/p>\n\n\n\n The Harness<\/strong><\/p>\n\n\n\n I use a separate PowerShell file as the harness for bicep work. In this case, the harness file contains a single line (change With the harness file saved in the same location as the bicep file above (and make sure your terminal window shows you in that same folder), running it will deploy your new resource group.<\/p>\n\n\n\n This shows a successful deployment, and it can be verified by looking at the Azure Portal for the resource group.<\/p>\n\n\n\n <\/p>\n\n\n\n Where To Go From Here<\/strong><\/p>\n\n\n\n The above is great for deploying a single resource group, but if you want to build virtual networks, VMs, load balancers, app services, etc. you’re going to need more information.<\/p>\n\n\n\n First place to go get more information is this overview from Microsoft<\/a> on deploying resources in bicep. Pay careful attention to the “Deployment Scope” section. In the above, we targeted the subscription for the scope. If you target a resource group (which is a bit more common), your harness file should have the command Second is deciding what <\/em>you want to build. Microsoft has a massive reference library<\/a> for all of Azure’s resource types. You simply go down this list to find the resource you want to build and can then read through the required and optional parameters. Here’s just a sample from the Virtual Network resource:<\/p>\n\n\n\n The code samples tend to display every possible parameter, which is why it’s important to look at the required parameters (or let VS Code give them to you).<\/p>\n\n\n\n\n
.bicep<\/code> extension.<\/p>\n\n\n\ntargetScope = 'subscription'\r\n\r\nresource NewResourcGroup 'Microsoft.Resources\/resourceGroups@2023-07-01' = {\r\n name: 'rg-myapplication'\r\n location: 'westus'\r\n}<\/code><\/pre>\n\n\n\n![\"\"](\"https:\/\/www.dumpsterfirecomputing.com\/wp-content\/uploads\/2023\/10\/image.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dumpsterfirecomputing.com\/wp-content\/uploads\/2023\/10\/image-1.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dumpsterfirecomputing.com\/wp-content\/uploads\/2023\/10\/image-2.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dumpsterfirecomputing.com\/wp-content\/uploads\/2023\/10\/image-3.png\")
<\/figure>\n\n\n\n01-ResourceGroup.bicep<\/code> to whatever you named your bicep file):<\/p>\n\n\n\nNew-AzSubscriptionDeployment -Location 'westus' -TemplateFile '.\\01-ResourceGroup.bicep'<\/code><\/pre>\n\n\n\n![\"\"](\"https:\/\/www.dumpsterfirecomputing.com\/wp-content\/uploads\/2023\/10\/image-4.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dumpsterfirecomputing.com\/wp-content\/uploads\/2023\/10\/image-5.png\")
<\/figure>\n\n\n\nNew-AzResourceGroupDeployment<\/code> instead of the New-AzSubscriptionDeployment<\/code> used above.<\/p>\n\n\n\n![\"\"](\"https:\/\/www.dumpsterfirecomputing.com\/wp-content\/uploads\/2023\/10\/image-6.png\")
<\/figure>\n\n\n\n