Skip to content

Commit 3531c99

Browse files
committed
[ACA] Update install instructions. Ensure latest version of ACA extension, enable preview features.
1 parent 929da9e commit 3531c99

File tree

2 files changed

+42
-0
lines changed

2 files changed

+42
-0
lines changed

articles/container-apps/troubleshooting.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,8 @@ The following table lists issues you might encounter while using Azure Container
2727
| Requests to endpoints fail | The container app endpoint doesn't respond to requests. | [Review ingress configuration](#review-ingress-configuration) |
2828
| Requests return status 403 | The container app endpoint responds to requests with HTTP error 403 (access denied). | [Verify networking configuration is correct](#verify-networking-configuration) |
2929
| Responses not as expected | The container app endpoint responds to requests, but the responses aren't as expected. | [Verify traffic is routed to the correct revision](#verify-traffic-is-routed-to-the-correct-revision)<br><br>[Verify you're using unique tags when deploying images to the container registry](/azure/container-registry/container-registry-image-tag-version) |
30+
| Missing parameters error when running Azure CLI/Azure PowerShell commands | [Verify latest version of Azure Container Apps extension is installed](#verify-latest-version-of-azure-container-apps-extension-is-installed) |
31+
| Preview features not available when running `az containerapp` commands | [Verify Azure Container Apps extension allows preview features](#verify-azure-container-apps-extension-allows-preview-features) |
3032

3133
## View logs
3234

@@ -178,6 +180,38 @@ If **Revision Mode** is set to `Multiple`, verify you're not routing traffic to
178180

179181
For more information about configuring traffic splitting, see [Traffic splitting in Azure Container Apps](./traffic-splitting.md).
180182

183+
## Verify latest version of Azure Container Apps extension is installed
184+
185+
If, when you run `az containerapp` commands in Azure CLI, or `Az.App` commands in Azure PowerShell, you receive errors about missing parameters, be sure you have the latest version of the Azure Container Apps extension installed.
186+
187+
# [Bash](#tab/bash)
188+
189+
```azurecli
190+
az extension add --name containerapp --upgrade
191+
```
192+
193+
# [Azure PowerShell](#tab/azure-powershell)
194+
195+
```azurepowershell
196+
Install-Module -Name Az.App
197+
```
198+
199+
If you have an older version of the Az.App module installed, update it.
200+
201+
```azurepowershell
202+
Update-Module -Name Az.App
203+
```
204+
205+
---
206+
207+
## Verify Azure Container Apps extension allows preview features
208+
209+
If, when you run `az containerapp` commands in the Azure CLI, [preview features](./whats-new.md) are not available, be sure you have enabled preview features on the Azure Container Apps extension.
210+
211+
```azurecli
212+
az extension add --name containerapp --upgrade --allow-preview true
213+
```
214+
181215
## Next steps
182216

183217
> [!div class="nextstepaction"]

includes/container-apps-create-cli-steps.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,12 +44,20 @@ Ignore any warnings about modules currently in use.
4444

4545
Next, install or update the Azure Container Apps extension for the CLI.
4646

47+
If, when you run `az containerapp` commands in Azure CLI, or `Az.App` commands in Azure PowerShell, you receive errors about missing parameters, be sure you have the latest version of the Azure Container Apps extension installed.
48+
4749
# [Bash](#tab/bash)
4850

4951
```azurecli
5052
az extension add --name containerapp --upgrade
5153
```
5254

55+
> [!NOTE]
56+
> Starting in May 2024, Azure CLI extensions no longer enable preview features by default. To access Container Apps [preview features](./whats-new.md) are not available, install the Container Apps extension with `--allow-preview true`.
57+
> ```azurecli
58+
> az extension add --name containerapp --upgrade --allow-preview true
59+
> ```
60+
5361
# [Azure PowerShell](#tab/azure-powershell)
5462
5563
```azurepowershell

0 commit comments

Comments
 (0)