Skip to content

Commit b78bcbd

Browse files
prerequities updated
1 parent 804e084 commit b78bcbd

File tree

2 files changed

+18
-30
lines changed

2 files changed

+18
-30
lines changed

README.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -105,6 +105,24 @@ Use the [Azure pricing calculator](https://azure.microsoft.com/en-us/pricing/cal
105105

106106
<br/>
107107

108+
Prerequisite — enable the Microsoft.Compute/EncryptionAtHost feature for every subscription (and region, if applicable) where you plan to deploy VMs or scale sets with encryptionAtHost: true. Repeat the steps below for each target subscription.
109+
110+
Steps to enable the feature:
111+
1. Set the target subscription:
112+
Run: <code>az account set --subscription "&lt;YourSubscriptionId&gt;"</code>
113+
2. Register the feature (one time per subscription):
114+
Run: <code>az feature register --name EncryptionAtHost --namespace Microsoft.Compute</code>
115+
3. Wait until registration completes and shows "Registered":
116+
Run: <code>az feature show --name EncryptionAtHost --namespace Microsoft.Compute --query properties.state -o tsv</code>
117+
4. Refresh the provider (if required):
118+
Run: <code>az provider register --namespace Microsoft.Compute</code>
119+
5. Re-run the deployment after registration is complete.
120+
121+
Note: Feature registration can take several minutes. Ensure the feature is registered before attempting deployments that require encryptionAtHost.
122+
123+
Reference: Azure Host Encryption — https://learn.microsoft.com/azure/virtual-machines/disks-enable-host-based-encryption-portal?tabs=azure-cli
124+
125+
108126
>⚠️ **Important:** To avoid unnecessary costs, remember to take down your app if it's no longer in use,
109127
either by deleting the resource group in the Portal or running `azd down`.
110128

docs/TroubleShootingSteps.md

Lines changed: 0 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -297,35 +297,5 @@ The subscription 'xxxx-xxxx' cannot have more than 1 Container App Environments
297297

298298
</details>
299299

300-
<details>
301-
<summary><b>EncryptionAtHostFeatureNotEnabled</b></summary>
302-
303-
This error appears when a resource (typically a Virtual Machine or scale set) sets the property <code>encryptionAtHost: true</code> but the subscription isn't enabled for the feature <code>Microsoft.Compute/EncryptionAtHost</code> in that region.
304-
305-
Example error snippet:
306-
307-
<pre>
308-
{"code":"InvalidTemplateDeployment","message":"The template deployment failed with error: 'The feature Microsoft.Compute/EncryptionAtHost is not enabled for subscription <sub-id> in location <region>.'"}
309-
</pre>
310-
311-
Why it happens:
312-
- The host-level encryption capability is a gated feature. Subscriptions must register the feature (and sometimes wait for registration to complete) before provisioning VMs with it enabled.
313-
- Attempting to force it on before registration completes blocks deployment.
314-
315-
How to fix:
316-
1. Set the subscription
317-
- Run: <code>az account set --subscription "yourSubIDHere"</code>
318-
2. Register the feature (one time per subscription):
319-
- Run: <code>az feature register --name EncryptionAtHost --namespace Microsoft.Compute</code>
320-
3. Check status until it shows "Registered":
321-
- <code>az feature show --name EncryptionAtHost --namespace Microsoft.Compute</code>
322-
4. Re-run the deployment.
323-
324-
Reference docs:
325-
- Azure Host Encryption: https://learn.microsoft.com/en-us/azure/virtual-machines/disks-enable-host-based-encryption-portal?tabs=azure-cli
326-
327-
</details>
328-
<br/>
329-
<br/>
330300
💡 Note: If you encounter any other issues, you can refer to the [Common Deployment Errors](https://learn.microsoft.com/en-us/azure/azure-resource-manager/troubleshooting/common-deployment-errors) documentation.
331301
If the problem persists, you can also raise an bug in our [MACAE Github Issues](https://github.com/microsoft/Multi-Agent-Custom-Automation-Engine-Solution-Accelerator/issues) for further support.

0 commit comments

Comments
 (0)