Skip to content

Commit fe52713

Browse files
committed
updates3
1 parent 6c9c0bd commit fe52713

File tree

10 files changed

+23
-23
lines changed

10 files changed

+23
-23
lines changed

learn-pr/azure/build-first-azd-template/includes/4-create-infrastructure.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
The Azure Developer CLI (`azd`) can provision resources in Azure using infrastructure as code (IaC) files written in either Bicep or Terraform. Infrastructure as code allows you to define infrastructure resources and configurations in declarative definition files that reliably generate the same environments every time they're deployed. `azd` executes these files to create the Azure resources required to host your app. You can learn more about infrastructure as code in the [What is infrastructure as code?](/devops/deliver/what-is-infrastructure-as-code) documentation.
22

3-
In this unit, you'll add Bicep code to your template to provision the necessary resources for your app. Previous knowledge of Bicep isn't required to complete this module. However, if you plan to work with `azd` templates extensively, it's a good idea to become familiar with at least the basics of Bicep or Terraform. Learn more about Bicep on the [Fundamentals of Bicep](/training/paths/fundamentals-bicep/) training path.
3+
In this unit, you'll add Bicep code to your template to provision the necessary resources for your app. Previous knowledge of Bicep isn't required to complete this module. However, if you plan to work with `azd` templates extensively, it's a good idea to become familiar with at least the basics of Bicep or Terraform. Learn more about Bicep in the [Fundamentals of Bicep](/training/paths/fundamentals-bicep/) training path.
44

55
The Bicep or Terraform files for your template live in the `infra` folder. The `infra` folder of the Bicep starter template you selected contains the following components as a starting point:
66

@@ -9,7 +9,7 @@ The Bicep or Terraform files for your template live in the `infra` folder. The `
99
* `main.parameters.json` - A JSON file that defines default values for important template parameters, such as the default Azure location or the environment name.
1010
* `core` - A subfolder that includes a variety of reusable Bicep files you can use to generate common Azure resources by simply passing in configuration parameters.
1111

12-
You can define and provision the required Azure resources for your app by updating the `main.bicep` file and creating custom Bicep files, or leveraging the templates in the `core` folder. `Main.bicep` generally orchestrates the execution of other Bicep modules by passing parameters between them. For this example, you'll create an additional minimal Bicep module to define the Azure App Service that will host your application.
12+
You can define and provision the required Azure resources for your app by updating the `main.bicep` file and creating custom Bicep files or bys leveraging the templates in the `core` folder. `Main.bicep` generally orchestrates the execution of other Bicep modules by passing parameters between them. For this example, you'll create an additional minimal Bicep module to define the Azure App Service that will host your application.
1313

1414
1. Inside of the `infra` folder of your template, create a new file called `app.bicep`.
1515

learn-pr/azure/build-flexible-bicep-templates-conditions-loops/includes/1-introduction.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ In this module, you'll extend a Bicep file by using conditions and loops. You'll
2020

2121
## What is the main goal?
2222

23-
By the end of this module, you'll be able to create Bicep files by using conditions and loops, and write Bicep code that configures how loops are executed. You'll also be able to create variable loops and output loops to make your templates even more flexible.
23+
By the end of this module, you'll be able to create Bicep files by using conditions and loops, and write Bicep code that configures how loops are executed. You'll also be able to create variable loops and output loops to make your files even more flexible.
2424

2525
## Prerequisites
2626

learn-pr/azure/build-flexible-bicep-templates-conditions-loops/includes/10-summary.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
Your toy company wants to launch a new teddy bear toy in multiple countries/regions. For compliance reasons, the infrastructure must be spread across all the Azure regions where the toy will be launched.
22

3-
You needed to deploy the same resources in multiple locations and a variety of environments. You wanted to create flexible Bicep files that you can reuse, and to control resource deployments by changing the deployment parameters.
3+
You needed to deploy the same resources in multiple locations and a variety of environments. You wanted to create flexible Bicep files that you can reuse and to control resource deployments by changing the deployment parameters.
44

5-
To deploy some resources only to certain environments, you added conditions to your template. You then used copy loops to deploy resources into various Azure regions. You used variable loops to define the properties of the resources to be deployed. Finally, you used output loops to retrieve the properties of those deployed resources.
5+
To deploy some resources only to certain environments, you added conditions to your Bicep file. You then used copy loops to deploy resources into various Azure regions. You used variable loops to define the properties of the resources to be deployed. Finally, you used output loops to retrieve the properties of those deployed resources.
66

7-
Without the conditions and copy loops features, you'd have to maintain and use multiple versions of Bicep files. You'd have to apply every change in your environment in multiple templates. Maintaining all these templates would entail a great deal of effort and overhead. By using conditions and loops, you were able to create a single template that works for all your regions and environments and ensure that all your resources are configured identically.
7+
Without the conditions and copy loops features, you'd have to maintain and use multiple versions of Bicep files. You'd have to apply every change in your environment to multiple files. Maintaining all these files would entail a great deal of effort and overhead. By using conditions and loops, you were able to create a single file that works for all your regions and environments, ensuring that all your resources are configured identically.
88

99
## Learn more
1010

learn-pr/azure/build-flexible-bicep-templates-conditions-loops/includes/2-use-conditions-deploy-resources.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
You can use conditions in your Bicep code to deploy resources only when specific constraints are in place.
22

3-
For example, at your toy company, you need to deploy resources to various environments. When you deploy them to a production environment, you need to ensure that auditing is enabled for your Azure SQL logical servers. But when you deploy resources to development environments, you don't want to enable auditing. You want to use a single template to deploy resources to all your environments.
3+
For example, at your toy company, you need to deploy resources to various environments. When you deploy them to a production environment, you need to ensure that auditing is enabled for your Azure SQL logical servers. But when you deploy resources to development environments, you don't want to enable auditing. You want to use a single Bicep file to deploy resources to all your environments.
44

55
In this unit, you'll learn how to deploy resources conditionally.
66

@@ -22,7 +22,7 @@ In Bicep, conditions can also include expressions. In the following example, the
2222

2323
::: code language="bicep" source="code/2-conditional-expression.bicep" highlight="7" :::
2424

25-
It's usually a good idea to create a variable for the expression that you're using as a condition. That way, your template is easier to understand and read. Here's an example:
25+
It's usually a good idea to create a variable for the expression that you're using as a condition. That way, your Bicep file is easier to understand and read. Here's an example:
2626

2727
::: code language="bicep" source="code/2-conditional-expression-variable.bicep" range="1-5, 8-9, 20-24, 28-29" highlight="7, 9" :::
2828

learn-pr/azure/build-flexible-bicep-templates-conditions-loops/includes/3-exercise-conditions.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -68,15 +68,15 @@ After you've completed all of the preceding changes, your Bicep file should look
6868

6969
::: code language="bicep" source="code/3-template.bicep" :::
7070

71-
If it doesn't, either copy the example or adjust your template to match the example.
71+
If it doesn't, either copy the example or adjust your Bicep file to match the example.
7272

7373
## Deploy the Bicep file to Azure
7474

7575
::: zone pivot="cli"
7676

7777
[!INCLUDE [Bootstrapping instructions for first Bicep exercise - CLI](../../includes/azure-template-bicep-exercise-sandbox-deploy-cli.md)]
7878

79-
### Deploy the template to Azure by using the Azure CLI
79+
### Deploy the Bicep file to Azure by using the Azure CLI
8080

8181
In the Visual Studio Code terminal, deploy the Bicep file to Azure by running the following code. Notice that you're explicitly setting the `location` parameter to `westus3`.
8282

@@ -90,9 +90,9 @@ az deployment group create --name main --template-file main.bicep --parameters l
9090

9191
[!INCLUDE [Bootstrapping instructions for first Bicep exercise - PowerShell](../../includes/azure-template-bicep-exercise-sandbox-deploy-powershell.md)]
9292

93-
### Deploy the template to Azure by using Azure PowerShell
93+
### Deploy the Bicep file to Azure by using Azure PowerShell
9494

95-
In the Visual Studio Code terminal, deploy the template to Azure by running the following Azure PowerShell command. This process can take a couple of minutes to complete, and then you'll have a successful deployment.
95+
In the Visual Studio Code terminal, deploy the Bicep file to Azure by running the following Azure PowerShell command. This process can take a couple of minutes to complete, and then you'll have a successful deployment.
9696

9797
```azurepowershell
9898
New-AzResourceGroupDeployment -Name main -TemplateFile main.bicep -location westus3
@@ -154,7 +154,7 @@ In the previous deployment, the default value for the `environmentName` paramete
154154

155155
Now you'll explicitly set the parameter value to `Production`. You expect that, by making this change, the storage account for auditing purposes will be deployed, and auditing will be enabled on the logical server.
156156

157-
### Deploy the template for the production environment
157+
### Deploy the Bicep file for the production environment
158158

159159
::: zone pivot="cli"
160160

@@ -168,7 +168,7 @@ az deployment group create --name main --template-file main.bicep --parameters e
168168

169169
::: zone pivot="powershell"
170170

171-
In the Visual Studio Code terminal, deploy the template to Azure by running the following Azure PowerShell command:
171+
In the Visual Studio Code terminal, deploy the Bicep file to Azure by running the following Azure PowerShell command:
172172

173173
```azurepowershell
174174
New-AzResourceGroupDeployment -Name main -TemplateFile main.bicep -environmentName Production -location westus3

learn-pr/azure/build-flexible-bicep-templates-conditions-loops/includes/5-exercise-loops.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Your *database.bicep* file should look like this example:
4444

4545
::: code language="bicep" source="code/3-template.bicep" :::
4646

47-
If it doesn't, either copy the example or adjust your template to match the example.
47+
If it doesn't, either copy the example or adjust your Bicep file to match the example.
4848

4949
## Deploy the Bicep file to Azure
5050

@@ -87,9 +87,9 @@ After the deployment is finished, you want to verify that the new logical server
8787

8888
1. Leave the page open in your browser. You'll check on deployments again later.
8989

90-
## Update and redeploy the template to Azure with an additional location for a logical server
90+
## Update and redeploy the Bicep file to Azure with an additional location for a logical server
9191

92-
The teddy bear toy team is about to launch again, this time into Asia. The team is asking you to deploy a new server and database in the East Asia region. To do so, you need to update your Bicep parameter and redeploy your template.
92+
The teddy bear toy team is about to launch again, this time into Asia. The team is asking you to deploy a new server and database in the East Asia region. To do so, you need to update your Bicep parameter and redeploy your Bicep file.
9393

9494
::: zone pivot="cli"
9595

learn-pr/azure/build-flexible-bicep-templates-conditions-loops/includes/6-use-loops-advanced.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
By using the powerful copy loops feature, you can create dynamic and flexible templates. It's important to understand how to control the way that loops execute when they create resources and how to use loops to set resource properties and nest loops.
1+
By using the powerful copy loops feature, you can create dynamic and flexible Bicep files. It's important to understand how to control the way that loops execute when they create resources and how to use loops to set resource properties and nest loops.
22

33
In this unit, you'll learn how to control the execution of copy loops and how to use resource property loops and nested loops in Bicep.
44

@@ -24,7 +24,7 @@ Now let's apply the `@batchSize` decorator with a value of `2`:
2424

2525
::: code language="bicep" source="code/6-loop-batchSize.bicep" range="2-6" highlight="1" :::
2626

27-
When you deploy the template, Bicep will deploy in batches of two:
27+
When you deploy the file, Bicep will deploy in batches of two:
2828

2929
:::image type="content" source="../media/6-batch-size-2.png" alt-text="Diagram showing time on the horizontal axis, with app1 and app2 stacked to run as one batch, and app3 to run as a second batch." border="false":::
3030

@@ -35,7 +35,7 @@ You can also tell Bicep to run the loop sequentially by setting the `@batchSize`
3535

3636
::: code language="bicep" source="code/6-loop-batchSize.bicep" range="1, 3-6" highlight="1" :::
3737

38-
When you deploy the template, Bicep waits for each resource deployment to finish before it starts the next one:
38+
When you deploy the file, Bicep waits for each resource deployment to finish before it starts the next one:
3939

4040
:::image type="content" source="../media/6-batch-size-1.png" alt-text="Diagram showing time on the horizontal axis, with app1, app2, and app3 being deployed sequentially." border="false":::
4141

@@ -63,7 +63,7 @@ You can use a nested loop to deploy the subnets within each virtual network:
6363

6464
The nested loop uses the `range()` function to create two subnets.
6565

66-
When you deploy the template, you get the following virtual networks and subnets:
66+
When you deploy the Bicep file, you get the following virtual networks and subnets:
6767

6868
| Virtual network name | Location | Address prefix | Subnets |
6969
| --- | --- | --- | --- |

learn-pr/azure/build-flexible-bicep-templates-conditions-loops/includes/7-use-loops-with-variables-and-outputs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ As you do with other loops, use the `for` keyword to specify an output loop:
3232

3333
::: code language="bicep" source="code/7-loop-output-simple.bicep" highlight="9" :::
3434

35-
You'll ordinarily use output loops in conjunction with other loops within your template. For example, let's look at a Bicep file that deploys a set of storage accounts to Azure regions that are specified by the `locations` parameter:
35+
You'll ordinarily use output loops in conjunction with other loops within your Bicep file. For example, let's look at a Bicep file that deploys a set of storage accounts to Azure regions that are specified by the `locations` parameter:
3636

3737
::: code language="bicep" source="code/7-loop-output-complex.bicep" range="1-14" :::
3838

learn-pr/azure/build-flexible-bicep-templates-conditions-loops/includes/8-exercise-loops-variables-outputs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ Your *database.bicep* file should look like this example:
7171

7272
::: code language="bicep" source="code/8-database.bicep" highlight="68-70" :::
7373

74-
If they don't, either copy the examples or adjust your templates to match the examples.
74+
If they don't, either copy the examples or adjust your Bicep files to match the examples.
7575

7676
## Deploy the Bicep file to Azure
7777

0 commit comments

Comments
 (0)