Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update FAQ to include common failures reasons with links #252

Merged
merged 9 commits into from
Jul 20, 2023
14 changes: 12 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -121,6 +121,16 @@ Once in the web app:

### Troubleshooting

If you see this error while running `azd deploy`: `read /tmp/azd1992237260/backend_env/lib64: is a directory`, then delete the `./app/backend/backend_env folder` and re-run the `azd deploy` command. This issue is being tracked here: https://github.com/Azure/azure-dev/issues/1237
The most common reasons this sample fails are:

If the web app fails to deploy and you receive a '404 Not Found' message in your browser, run 'azd deploy'.
1. The subscription (`AZURE_SUBSCRIPTION_ID`) doesn't have access to the Azure OpenAI service. Please ensure the `AZURE_SUBSCRIPTION_ID` used in the access request process, is the one you're coding with aka.ms/oai/access.

1. You're attempting to create resources in regions not enabled for Azure OpenAI (e.g. East US 2, instead of East US), or where the model you're trying to use isn't enabled. See this matrix for what models are available in what regions [https://aka.ms/oai/models](https://aka.ms/oai/models).

1. You've exceeded a quota, most often number of resources per region. See this link for quotas and limits [https://aka.ms/oai/quotas](https://aka.ms/oai/quotas).

1. You've run the sample multiple times, and deleted the resources you've been creating each time, but are forgetting to purge them (Azure keeps resources for 48 hours unless you purge from soft delete). So you're getting same resource name not allowed conflicts. See this article: [https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal](https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal#purge-a-deleted-resource).

1. If you see this error while running `azd deploy`: `read /tmp/azd1992237260/backend_env/lib64: is a directory`, then delete the `./app/backend/backend_env folder` and re-run the `azd deploy` command. This issue is being tracked here: [#1237](https://github.com/Azure/azure-dev/issues/1237).

1. If the web app fails to deploy and you receive a '404 Not Found' message in your browser, run 'azd deploy'.