docs: Update Troubleshoot document #341
Open
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Purpose
This pull request expands the Azure deployment troubleshooting documentation by adding several new error scenarios and their resolutions. The additions cover quota errors, API version mismatches, VM and networking restrictions, authentication conflicts, and resource provisioning issues. These updates provide more comprehensive guidance for resolving common deployment blockers.
Quota and API Version Errors
ServiceQuotaExceedederror, detailing causes and resolutions when the free tier quota for Azure AI Search is exceeded, including how to delete existing services, upgrade SKUs, or request quota increases.NoRegisteredProviderFounderror, explaining how to resolve unsupported API version issues for Azure resources by updating templates and checking supported versions.Networking and VM Restrictions
VMSizeIsNotPermittedToEnableAcceleratedNetworkingerror, clarifying which VM sizes support accelerated networking and how to resolve configuration issues.NetworkSecurityGroupNotCompliantForAzureBastionSubnetandSecurityRuleParameterContainsUnsupportedValue, explaining NSG rule requirements for Azure Bastion and how to resolve port blocking issues.RouteTableCannotBeAttachedForAzureBastionSubneterror, describing Azure Bastion subnet restrictions and how to avoid attaching route tables.Authentication and Immutable Properties
Conflict - Local authentication is disablederror in Azure App Configuration, including how to switch to Managed Identity authentication or re-enable local auth.PropertyChangeNotAllowederror for immutable VM properties, detailing how to handle changes to properties likeosProfile.adminUsername.Resource Provisioning and Parent Account Issues
FailedIdentityOperationandManagedEnvironmentScheduledForDeleteerrors, explaining how to handle pending delete operations and resource conflicts in Azure Container Apps environments.BadRequest - Parent account does not provision correctly, clarifying how to address parent AI/Cognitive Services account provisioning failures and soft-delete scenarios.Does this introduce a breaking change?
Golden Path Validation
Deployment Validation
What to Check
Verify that the following are valid
Other Information