---

name: diagnose-maestro-deployment description: Diagnoses failed Maestro cluster deployments by analyzing Helm releases, pod status, and resource conflicts category: Troubleshooting tags: [azure, aks, maestro, troubleshooting, debugging, helm, kubernetes]

Diagnose Maestro Deployment

Automatically diagnoses failed Maestro cluster deployments by:

• Analyzing deployment output to identify resource groups and cluster names
• Checking Helm release status in both service and management clusters
• Inspecting pod states and error conditions
• Identifying resource conflicts and timing issues
• Generating a detailed analysis report with root cause and recommendations

Prerequisites:

• Azure CLI installed and logged in
• kubectl and kubelogin installed
• Access to the failed deployment output or cluster information

Usage:

Copy# Diagnose using deployment output file
diagnose-maestro-deployment /path/to/deployment.output

# Diagnose using cluster names directly
diagnose-maestro-deployment --svc-rg <resource-group> --svc-cluster <cluster-name> --mgmt-rg <resource-group> --mgmt-cluster <cluster-name>

Copy#!/bin/bash
# Execute the diagnostic script
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
exec "$SCRIPT_DIR/scripts/diagnose.sh" "$@"