You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/azure-resource-manager/bicep/deploy-preflight.md
+9-6Lines changed: 9 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,7 +16,7 @@ To understand preflight, it helps to see where it fits compared to other checks:
16
16
3.[**What-If**](./deploy-what-if.md): Predicts exactly which resources are created, modified, or deleted.
17
17
4.[**Deployment**](./deploy-cli.md): The actual execution where Azure builds the resources.
18
18
19
-
When you trigger a preflight check, Azure doesn't just look at the code. It looks at the live environment and the resource provider (the service responsible for the specific resource, like Microsoft.Compute). It verifies:
19
+
When you trigger a preflight check, Azure Resource Manager doesn't just look at the code. It looks at the live environment and the resource provider (the service responsible for the specific resource, like Microsoft.Compute). It verifies:
- Resource name conflicts (for example, globally unique names already taken)
@@ -28,12 +28,14 @@ If any of these checks fail, the deployment never starts.
28
28
29
29
## Limitations
30
30
31
+
Preflight has these limitations:
32
+
31
33
- Runtime errors: Preflight can't catch everything. For example, if a custom script extension fails during execution because of a typo inside a bash script, preflight won't see that error.
32
34
- Dependent values: If Resource B depends on a property generated by Resource A (like a dynamic IP address), preflight might only perform a partial check because that value doesn't exist yet.
33
35
34
36
## Run preflight
35
37
36
-
Preflight validation runs automatically when you use deployment validate or what-if style commands. For example, preflight validation runs during these operations:
38
+
Preflight validation runs automatically when you use deployment validate or what-if style commands. For example, these operations run preflight validation:
37
39
38
40
- ARM JSON or Bicep validation in Azure CLI or PowerShell
39
41
@@ -55,15 +57,16 @@ Preflight validation runs automatically when you use deployment validate or what
55
57
56
58
For more information, see [Deploy Bicep files with the Azure CLI](./deploy-cli.md) and [Deploy Bicep files with the Azure PowerShell](./deploy-powershell.md).
57
59
58
-
- what-if
60
+
- What-if
61
+
59
62
What-if includes preflight checks before calculating changes unless you configure it to skip the preflight. For more information, see [Running the what-if operation](./deploy-what-if.md#running-the-what-if-operation).
60
63
61
-
- Azure portal "Review + create" step
64
+
- Azure portal **Review + create** step
62
65
63
66
Currently, the Azure portal only supports deploying ARM JSON templates. For more information, see [Deploy ARM templates with the Azure portal](../templates/deploy-portal.md).
64
67
65
-
Preflight errors appear in the Activity Log but not in deployment history, because the deployment never began.
68
+
Preflight errors appear in the activity log but not in deployment history, because the deployment never began.
66
69
67
70
## Next steps
68
71
69
-
- To use the what-if operation, see [Bicep What-If: Preview Changes Before Deployment](./deploy-what-if.md)
72
+
- To use the what-if operation, see [Bicep What-If: Preview Changes Before Deployment](./deploy-what-if.md).
0 commit comments