Skip to content

Conversation

@NirajC-Microsoft
Copy link
Contributor

Purpose

This pull request expands the docs/TroubleShootingSteps.md file with several new troubleshooting entries for common Azure deployment errors. The additions provide detailed explanations, example error messages, and step-by-step resolutions for issues related to service quotas, VM networking, Azure Bastion, API versions, authentication modes, and resource provisioning conflicts. These updates enhance the documentation's usefulness for unblocking deployments and diagnosing failures.

Azure Service Quota & API Version Troubleshooting:

  • Added entry for ServiceQuotaExceeded detailing causes and resolutions when the free tier quota for Azure AI Search is exceeded, including command-line steps and upgrade options.
  • Added entry for NoRegisteredProviderFound explaining unsupported API versions for resource types, with example error messages and guidance to update templates and check supported versions.

Networking & Azure Bastion Issues:

  • Added troubleshooting for VMSizeIsNotPermittedToEnableAcceleratedNetworking, describing when VM sizes do not support accelerated networking and how to select compatible sizes.
  • Added entries for NetworkSecurityGroupNotCompliantForAzureBastionSubnet and SecurityRuleParameterContainsUnsupportedValue, outlining requirements for NSG rules on Azure Bastion subnets and how to resolve port blocking issues.
  • Added entry for RouteTableCannotBeAttachedForAzureBastionSubnet, explaining the restriction on attaching route tables to Azure Bastion subnets and how to fix template configurations.

Authentication & Immutable Property Errors:

  • Added troubleshooting for Conflict - Local authentication is disabled, clarifying the need to use Managed Identity when local authentication is disabled in Azure App Configuration and providing code examples for remediation.
  • Added entry for PropertyChangeNotAllowed, describing immutable VM properties (like admin username) and how to redeploy with new credentials if changes are required.

Resource Provisioning & Parent Account Issues:

  • Added entry for FailedIdentityOperation / ManagedEnvironmentScheduledForDelete, detailing conflicts and pending delete operations for Azure Container Apps Managed Environments with steps to resolve and avoid naming conflicts.
  • Added entry for BadRequest - Parent account does not provision correctly, explaining issues with parent AI Services/Cognitive Services accounts and how to check status, delete, or restore resources as needed.

Does this introduce a breaking change?

  • Yes
  • No

Golden Path Validation

  • I have tested the primary workflows (the "golden path") to ensure they function correctly without errors.

Deployment Validation

  • I have validated the deployment process successfully and all services are running as expected with this change.

What to Check

Verify that the following are valid

  • ...

Other Information

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant