Skip to content

Add troubleshooting guide for AKS upgrade failures due to conflicting PDBs#2034

Open
skuchipudi295 wants to merge 2 commits intoMicrosoftDocs:mainfrom
skuchipudi295:fix/aks-eviction-autoscaler-tsg-format
Open

Add troubleshooting guide for AKS upgrade failures due to conflicting PDBs#2034
skuchipudi295 wants to merge 2 commits intoMicrosoftDocs:mainfrom
skuchipudi295:fix/aks-eviction-autoscaler-tsg-format

Conversation

@skuchipudi295
Copy link
Contributor

This pull request adds a new troubleshooting guide for Azure Kubernetes Service (AKS) users experiencing upgrade failures due to conflicting PodDisruptionBudgets (PDBs). The guide explains how to identify, resolve, and prevent issues where pods are covered by multiple PDBs, which can block node drains and cause upgrade failures.

New documentation for troubleshooting AKS upgrade failures:

  • Adds a comprehensive troubleshooting article (aks-eviction-autoscaler-troubleshooting.md) that covers:
    • How to recognize upgrade failures caused by pods matching multiple PDBs, including error message patterns and confirmation steps.
    • Step-by-step instructions for identifying and resolving conflicting PDBs, including commands to list, describe, and delete PDBs, and to verify pod health.
    • Multiple methods to retry or reconcile the upgrade after resolving the conflict, including CLI commands and backend reconciliation options.
    • Best practices to prevent future issues, such as ensuring each pod matches only one PDB and recommendations on PDB configuration.

Pull request guidance

Thank you for submitting your contribution to our support content! Our team works closely with subject matter experts in CSS and PMs in the product group to review all content requests to ensure technical accuracy and the best customer experience. This process can sometimes take one or more days, so we greatly appreciate your patience.

We also need your help in order to process your request as soon as possible:

  • We won't act on your pull request (PR) until you type "#sign-off" in a new comment in your pull request (PR) to indicate that your changes are complete.

  • After you sign off in your PR, the article will be tech reviewed by the PM or SME if it has more than minor changes. Once the article is approved, it will undergo a final editing pass before being merged.

@prmerger-automator
Copy link

@skuchipudi295 : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit e716a77:

💡 Validation status: suggestions

File Status Preview URL Details
support/azure/azure-kubernetes/extensions/aks-eviction-autoscaler-troubleshooting.md 💡Suggestion Details

support/azure/azure-kubernetes/extensions/aks-eviction-autoscaler-troubleshooting.md

  • Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@prmerger-automator
Copy link

PRMerger Results

Issue Description
Added File(s) This PR contains added files. New files require human review.
File Change Percent This PR contains file(s) with more than 30% file change.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 7f51f4d:

💡 Validation status: suggestions

File Status Preview URL Details
support/azure/azure-kubernetes/extensions/aks-eviction-autoscaler-troubleshooting.md 💡Suggestion Details

support/azure/azure-kubernetes/extensions/aks-eviction-autoscaler-troubleshooting.md

  • Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@prmerger-automator
Copy link

PRMerger Results

Issue Description
Added File(s) This PR contains added files. New files require human review.
File Change Percent This PR contains file(s) with more than 30% file change.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants