Troubleshooting Pending Pods on AKS: Storage Class Configuration

Last updated: December 11, 2024

If you're experiencing issues with pods getting stuck in a 'Pending' state when deploying applications or services on Azure Kubernetes Service (AKS) with Qovery, it may be due to an unconfigured storage class. This article will guide you through the problem and its solution.

Identifying the Issue

You may encounter an error message similar to this when trying to deploy:

reason: FailedScheduling
message: 0/3 nodes are available: pod has unbound immediate PersistentVolumeClaims.
preemption: 0/3 nodes are available: 3 Preemption is not helpful for scheduling.

This error typically occurs when the storage class is not properly configured in your AKS cluster.

Solution: Configuring the Storage Class

To resolve this issue, ensure that the storage class is correctly set up during the Qovery installation process. Here's what you need to do:

  1. Uninstall the current Qovery setup if it's not working properly.

  2. Reinstall Qovery, making sure to set the storage class name during the installation process.

  3. Verify that the storage class is correctly configured in your AKS cluster settings.

Verifying the Fix

After reinstalling Qovery with the correct storage class configuration:

  1. Try deploying a simple application (e.g., a container app) to test if the issue is resolved.

  2. If successful, proceed to deploy your desired services (Redis, MySQL, etc.).

  3. Monitor the pod status to ensure they are no longer stuck in the 'Pending' state.

Additional Troubleshooting

If you continue to experience issues after following these steps, consider the following:

  • Double-check your AKS cluster configuration, including node pool settings and cluster preset config.

  • Ensure you have the necessary permissions to create and manage persistent volumes in your AKS cluster.

  • Review the Qovery documentation for any AKS-specific requirements or recommendations.

If problems persist, don't hesitate to reach out to Qovery support for further assistance.