Skip to content

Commit eae9edc

Browse files
Multiple updates
1 parent a92245d commit eae9edc

18 files changed

Lines changed: 66 additions & 122 deletions

support/azure/azure-container-instances/configuration-setup/container-group-deployment-waiting-state.md

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,15 +4,15 @@ description: Learn how to resolve an issue in which a container group deployment
44
ms.date: 04/17/2025
55
author: kennethgp
66
ms.author: kegonzal
7-
editor: v-ryanberg
8-
ms.reviewer: v-ryanberg
7+
editor: v-jsitser
8+
ms.reviewer: edneto, v-leedennis
99
ms.service: azure-container-instances
1010
ms.custom: sap:Configuration and Setup
1111
#Customer intent: As an Azure administrator, I want to learn how to resolve a container group deployment that's stuck in the "Waiting" state so that I can successfully deploy an image onto a container instance.
1212
---
1313
# Container group deployment remains in Waiting state
1414

15-
This article discusses possible causes and how to resolve an unresponsive deployment, which doesn't exit the Waiting state.
15+
This article discusses possible causes and how to resolve an unresponsive deployment which doesn't exit the Waiting state.
1616

1717
## Symptoms
1818

@@ -32,7 +32,7 @@ The Waiting state indicates there's a condition preventing deployment setup or c
3232

3333
Possible solutions include:
3434

35-
- Check that the container runs fine locally. A local machine with Docker can be used to do validate the container runs correctly.
35+
- Check that the container runs fine locally. A local machine with Docker can be used to validate the container runs correctly.
3636
- Inspect possible errors on the **Container Events** tab starting with the main container process.
3737
- Make sure no reserved ports are being used in the container definition. For more information, see [Does the ACI service reserve ports for service functionality?](/azure/container-instances/container-instances-faq#does-the-aci-service-reserve-ports-for-service-functionality-).
3838
- Check that there's connectivity to the Azure file share and that the key is correct or valid. If deployment is on BYOVNET, check that domain name system (DNS) resolution is working for the Azure file share fully qualified domain name (FQDN).
@@ -46,9 +46,6 @@ Possible solutions include:
4646
## Resources
4747

4848
- [Tutorial: Deploy a multi-container group using a Resource Manager template](/azure/container-instances/container-instances-multi-container-group)
49-
5049
- [Azure Container Instances states](/azure/container-instances/container-state)
5150

52-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
53-
5451
[!INCLUDE [Third-party contact disclaimer](~/includes/third-party-contact-disclaimer.md)]

support/azure/azure-container-instances/configuration-setup/container-group-transitioning-state.md

Lines changed: 11 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ ms.date: 01/15/2025
55
author: kennethgp
66
ms.author: kegonzal
77
editor: v-jsitser
8-
ms.reviewer: kegonzal
98
ms.service: azure-container-instances
109
ms.topic: troubleshooting-problem-resolution
1110
ms.custom: sap:Configuration and Setup
@@ -17,43 +16,38 @@ This article discusses how to resolve an operational failure that occurs when a
1716

1817
## Symptoms
1918

20-
When you issue start/stop operation on a container group, this error is thrown:
19+
When you issue a start/stop operation on a container group, you receive the following error message:
2120

22-
> **InternalErrorCode**: "ContainerGroupTransitioning"
23-
> **StatusCode**: "409"
24-
> **Message**: "The container group '\<container-group-name>' is still transitioning, please retry later."
21+
**InternalErrorCode**: "ContainerGroupTransitioning"
22+
**StatusCode**: "409"
23+
**Message**: "The container group '\<container-group-name>' is still transitioning, please retry later."
2524

2625
## Cause
2726

2827
### Cause 1: After stop operation
2928

30-
During a continuous stop operation of the container group, system sidecar containers the container group aren't terminated in time.
29+
During a continuous stop operation of the container group, system sidecar containers in the container group aren't terminated in time.
3130

3231
### Cause 2: After start operation
3332

3433
The stopped state for previous operation wasn't propagated yet or didn't propagate correctly (known platform issue).
3534

36-
## Solution
35+
## Solution 1
3736

3837
- Wait until the container group is fully stopped to allow the system sidecars to fully terminate (allow at least 10 seconds between operations).
39-
- If the [container is deployed by using an Azure Logic App](/azure/connectors/connectors-create-api-container-instances?toc=%2Fazure%2Fcontainer-instances%2Ftoc.json&bc=%2Fazure%2Fcontainer-instances%2Fbreadcrumb%2Ftoc.json), check the state of the container, make sure the status is **Stopped** before issuing start operation.
40-
- For Job container groups (process runs once and exits, restart policy is **Never**) in **Terminated** state, issue a stop operation before start operation to make sure the correct status is propagated first. Another alternative is to issue a restart operation instead. A restart operation avoids a new container group deployment and instead restarts the application process inside the container.
38+
- If the [container is deployed by using an Azure Logic App](/azure/connectors/connectors-create-api-container-instances?toc=%2Fazure%2Fcontainer-instances%2Ftoc.json&bc=%2Fazure%2Fcontainer-instances%2Fbreadcrumb%2Ftoc.json), check the state of the container and then make sure the status is **Stopped** before issuing a start operation.
39+
- For job container groups (process runs once and exits, restart policy is **Never**) in **Terminated** state, issue a stop operation before a start operation to make sure the correct status is propagated first. You can also issue a restart operation. A restart operation avoids a new container group deployment and instead restarts the application process inside the container.
4140

4241
> [!NOTE]
4342
> As a best practice, we recommend that you always issue a stop operation before a start operation to ensure the correct status is propagated. If you start a container group that already has a running container, you might cause the transitioning state problem.
4443
45-
## Solution 3: Open a support ticket
44+
## Solution 2: Open a support ticket
4645

47-
If the previous solutions don't fix the problem, and you still encounter the error message, open a support ticket.
46+
If the previous solutions don't fix the problem and you still encounter the error message, open a support ticket.
4847

49-
## More information
48+
## Resources
5049

5150
- [Tutorial: Deploy a multi-container group using a Resource Manager template](/azure/container-instances/container-instances-multi-container-group)
52-
5351
- [Azure Container Instances states](/azure/container-instances/container-state)
54-
5552
- [Manually stop or start containers in Azure Container Instances](/azure/container-instances/container-instances-stop-start)
56-
5753
- [Update containers in Azure Container Instances](/azure/container-instances/container-instances-update)
58-
59-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

support/azure/azure-container-instances/configuration-setup/docker-hub-rate-limit-registryerrorresponse.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ You might also see the following error messages:
3232
3333
## Cause
3434

35-
This issue might occur due to the rate limits on image pulls from Docker Hub. An agreement between Microsoft and Docker to allow Azure IP addresses to make unlimited anonymous image pulls from Docker Hub ended on June 30, 2024. If you're deploying to a Virtual Network (BYOVNET), note the image pull occurs via random platform public IP.
35+
This issue might occur due to the rate limits on image pulls from Docker Hub. An agreement between Microsoft and Docker to allow Azure IP addresses to make unlimited anonymous image pulls from Docker Hub ended on June 30, 2024. If you're deploying to a Virtual Network (BYOVNET), the image pull occurs through a random platform public IP.
3636

3737
## Solution
3838

@@ -41,12 +41,10 @@ Create a Docker account and use the Docker account credentials to authenticate t
4141
> [!NOTE]
4242
> Docker offers a free subscription that allows customers to get 200 pulls every six hours. If 200 pulls aren't enough for you, we recommend purchasing a paid Docker subscription. A paid Docker subscription gives you 5,000 pulls every 24 hours, which can be increased by contacting Docker directly.
4343
44-
## References
44+
## Resources
4545

4646
- [Docker Hub usage and rate limits](https://docs.docker.com/docker-hub/download-rate-limit/)
4747
- [Configure Artifact Cache to consume public content](/azure/container-registry/buffer-gate-public-content#configure-artifact-cache-to-consume-public-content)
4848
- [Artifact cache in Azure Container Registry](/azure/container-registry/container-registry-artifact-cache)
4949

5050
[!INCLUDE [Third-party disclaimer](../../../includes/third-party-disclaimer.md)]
51-
52-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

support/azure/azure-container-instances/configuration-setup/error-codes-spot-container-creation.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,10 +21,7 @@ This article provides solutions to common errors that occur when you try to crea
2121
| `SpotPriorityContainerGroupWithGPUResourcesNotSupported` | `Spot Priority Container Groups that include containers requesting GPU resources are not supported.` | GPUs aren't supported for Spot containers. Remove the GPU from the request, and try again. |
2222
| `PriorityNotSpecified` | `The 'Priority' must be one of 'Regular,Spot' for container group '{xyz}'.` | If the priority is mentioned in the request body, specify a value of `Regular` or `Spot`. |
2323

24-
## More information
24+
## Resources
2525

2626
- [Azure Container Instances Spot containers (preview)](/azure/container-instances/container-instances-spot-containers-overview)
27-
2827
- [FAQ - Spot containers on Azure Container Instances (Preview)](/azure/container-instances/container-instances-faq#spot-containers-on-azure-container-instances--preview)
29-
30-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

support/azure/azure-container-instances/configuration-setup/inaccessible-image.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -46,14 +46,10 @@ When you try to deploy a container instance, the deployment fails, and you recei
4646
You must use a managed identity to allow the Container Instances trusted service to access the container registry. For more information, see [Allow trusted services to securely access a network-restricted container registry](/azure/container-registry/allow-access-trusted-services#about-trusted-services). You can also learn more at [Deploy to Azure Container Instances from Azure Container Registry using a managed identity](/azure/container-instances/using-azure-container-registry-mi).
4747

4848
> [!NOTE]
49-
> Image pull phase happens before container is created. If you're deploying to a Virtual Network (BYOVNET), image pull occurs via random platform public IP. Because of this reason, private registries other than Azure Container Registry aren't supported even if there's private connectivity from target subnet.
49+
> Image pull phase happens before container is created. If you're deploying to a Virtual Network (BYOVNET), image pull occurs through a random platform public IP. Because of this, private registries other than Azure Container Registry aren't supported even if there's private connectivity from the target subnet.
5050
51-
## References
51+
## Resources
5252

5353
- [Managed identities in Azure Container Apps](/azure/container-apps/managed-identity)
54-
5554
- [Azure Container Apps image pull with managed identity](/azure/container-apps/managed-identity-image-pull)
56-
5755
- [Tutorial: Deploy a multi-container group using a Resource Manager template](/azure/container-instances/container-instances-multi-container-group)
58-
59-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

support/azure/azure-container-instances/configuration-setup/long-image-pulls.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ ms.date: 04/14/2025
55
ms.service: azure-container-instances
66
author: tysonfms
77
ms.author: tysonfreeman
8-
editor: kennethgp
9-
ms.reviewer: edneto, v-leedennis
8+
editor: v-jsitser
9+
ms.reviewer: edneto, v-leedennis, kennethgp
1010
ms.custom: sap:Configuration and Setup
1111
#Customer intent: As a user of Azure Container Instances, I want to learn why an image pull takes a long time to complete so that I can create and use container groups successfully.
1212
---
@@ -20,7 +20,7 @@ This article discusses possible causes for an image pull taking long time to com
2020

2121
## Symptoms
2222

23-
- Container groups are stuck in a "Creating" status for a significant amount of time.
23+
- Container groups are stuck in a **Creating** status for a significant amount of time.
2424
- The image size is large.
2525

2626
## Cause
@@ -37,7 +37,7 @@ To view the timeline of the container events, run the following [az container sh
3737
az container show --resource-group <resource-group-name> --name <container-group-name>
3838
```
3939

40-
The time span between the **Pulling** and **Pulled** events allows you to determine whether the image pull time is expected or abnormal. Sample command output:
40+
The time span between the `Pulling` and `Pulled` events allows you to determine whether the image pull time is expected or abnormal. The following is a sample command output:
4141

4242
```json
4343
{
@@ -149,8 +149,6 @@ The time span between the **Pulling** and **Pulled** events allows you to determ
149149
}
150150
```
151151

152-
## More information
152+
## Resources
153153

154154
- [Azure Container Apps image pull with managed identity](/azure/container-apps/managed-identity-image-pull)
155-
156-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

support/azure/azure-container-instances/configuration-setup/service-unavailable-container-group-quota-exceeded.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ description: Learn how to resolve a (ServiceUnavailable - container group quota
44
ms.date: 02/23/2024
55
author: tysonfms
66
ms.author: tysonfreeman
7-
editor: kennethgp
8-
ms.reviewer: v-leedennis
7+
editor: v-jsitser
8+
ms.reviewer: v-leedennis, kennethgp
99
ms.service: azure-container-instances
1010
ms.custom: sap:Configuration and Setup
1111
#Customer intent: As an Azure administrator, I want to learn how to resolve a "ServiceUnavailable" error ("Resource type 'Microsoft.ContainerInstance/containerGroups' container group quota 'ContainerGroups' exceeded in region") so that I can successfully deploy container groups onto Azure Container Instances.
@@ -29,10 +29,8 @@ However, you confirm there's enough quota settings for this deployment.
2929

3030
## Cause
3131

32-
You try to simultaneously deploy multiple container groups in different regions that use the same name. This action triggers the fraud detection logic in Container Instances. Automation scripts that are run in the cloud might be trying to do this multi-deployment operation. You can identify this scenario by the '0' limit and usage fields in error message.
32+
You try to simultaneously deploy multiple container groups in different regions that use the same name. This action triggers the fraud detection logic in Container Instances. Automation scripts that are run in the cloud might be trying to do this multi-deployment operation. You can identify this scenario by the `0` limit and usage fields in the error message.
3333

3434
## Solution
3535

36-
To avoid this error, issue requests for container group deployments one at a time.
37-
38-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
36+
To avoid this error, issue requests for container group deployments one at a time.

support/azure/azure-container-instances/configuration-setup/service-unavailable-gpu-enabled-aci-deployment-failures.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,9 @@
22
title: Azure Container Instances fails to run GPU-enabled containers
33
description: Provides solutions to GPU-enabled Azure container instance deployment failures.
44
ms.date: 05/27/2024
5-
ms.reviewer: v-rekhanain, momajed, v-weizhu
5+
ms.reviewer: v-rekhanain, momajed, v-weizhu, kennethgp
66
ms.service: azure-container-instances
77
ms.custom: sap:Configuration and Setup
8-
editor: kennethgp
98
---
109
# GPU-enabled container deployment fails with "service unavailable" error
1110

@@ -68,5 +67,3 @@ Your container image doesn't have NVIDIA drivers or libraries installed. GPU-ena
6867
### Solution 4: Use the NVIDIA GPU Cloud (NGC) repository
6968

7069
Check your container image and make sure that it has the NVIDIA drivers and libraries installed. You can use the NVIDIA GPU Cloud (NGC) repository to find and pull prebuilt GPU-accelerated images for various frameworks and applications.
71-
72-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

support/azure/azure-container-instances/configuration-setup/service-unavailable-requested-resource-is-not-available.md

Lines changed: 7 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ description: Provides a solution to the service unavailable error
44
ms.date: 02/23/2024
55
author: tysonfms
66
ms.author: tysonfreeman
7-
editor: kennethgp
8-
ms.reviewer: tomcassidy, v-leedennis
7+
editor: v-jsitser
8+
ms.reviewer: tomcassidy, v-leedennis, kennethgp
99
ms.topic: troubleshooting-problem-resolution
1010
ms.service: azure-container-instances
1111
ms.custom: sap:Configuration and Setup
@@ -25,16 +25,11 @@ You receive an error message that resembles the following text:
2525

2626
This issue might occur if a feature isn't available in certain regions or if there's a lack of capacity. This issue is typically intermittent.
2727

28-
If container group deployment requests more than 4 CPU or 16 GB memory the deployment is marked as Big Container Group. Big Container Group region capacity is enabled on demand, if there's no infrastructure available for the deployment the error is thrown.
28+
If container group deployment requests are larger than four (4) CPU or 16 GB memory the deployment is marked as **Big Container Group**. Big Container Group region capacity is enabled on demand and if there's no infrastructure available for the deployment the error is encountered.
2929

3030
## Solution
3131

32-
1. To determine whether you can deploy to an available region, see [Resource availability & quota limits for Azure Container Instances](/azure/container-instances/container-instances-resource-and-quota-limits).
33-
34-
1. To determine which features are available in your region, use the [Location - List Capabilities](/rest/api/container-instances/location/list-capabilities) REST API. You can also verify available features per region by selecting the "Try it" button in that article.
35-
36-
1. If you're deploying in an available region, and there's no feature limitation, retry the deployment.
37-
38-
1. If you're deploying a Big Container Group, open a support ticket to validate region capacity.
39-
40-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
32+
- To determine whether you can deploy to an available region, see [Resource availability & quota limits for Azure Container Instances](/azure/container-instances/container-instances-resource-and-quota-limits).
33+
- To determine which features are available in your region, use the [Location - List Capabilities](/rest/api/container-instances/location/list-capabilities) REST API. You can also verify available features per region by selecting the "Try it" button in that article.
34+
- If you're deploying in an available region, and there's no feature limitation, retry the deployment.
35+
- If you're deploying a Big Container Group, open a support ticket to validate region capacity.

support/azure/azure-container-instances/configuration-setup/spot-container-group-quota-reached-error.md

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,7 @@
22
title: ContainerGroupQuotaReached error when deploying Spot containers
33
description: Provides solutions to the ContainerGroupQuotaReached error that occurs when you deploy a Spot container to Azure Container Instances.
44
ms.date: 10/28/2024
5-
ms.reviewer: chiragpa, v-weizhu
6-
editor: kennethgp
5+
ms.reviewer: chiragpa, v-weizhu, kennethgp
76
ms.service: azure-container-instances
87
ms.custom: sap:Configuration and Setup
98
---
@@ -45,6 +44,4 @@ To resolve this issue, increase the StandardSpotCores limit. To do so, use one o
4544
- File support request to increase capacity for Spot containers. For more information, see [How do I file quota requests for ACI Spot containers?](/azure/container-instances/container-instances-faq#spot-containers-on-azure-container-instances--preview)
4645

4746
> [!NOTE]
48-
> Spot containers with Azure Container Instances is in preview and is not recommended for production scenarios.
49-
50-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
47+
> Spot containers with Azure Container Instances is currently in preview and not recommended for production scenarios.

0 commit comments

Comments
 (0)