Problembehandlung bei der fehlgeschlagenen Bereitstellung eines Kubernetes-Anwendungsangebots

Artikel
11/20/2024

In diesem Artikel wird erläutert, wie Sie eine fehlerhafte Bereitstellung eines Kubernetes-Anwendungsangebots beheben, das auf dem Microsoft Azure Marketplace akzeptiert wurde. Wenn Sie den Kauf eines Kubernetes-Angebots initiieren, stellt Azure eine Azure Resource Manager-Vorlage (ARM-Vorlage) bereit, die versucht, die erforderlichen Ressourcen zu installieren, um das Angebot zu erfüllen. Die ARM-Vorlagenbereitstellung kann jedoch aus verschiedenen Gründen fehlschlagen.

Checkliste zur Problembehandlung

Überprüfen der Bereitstellungsvorgangsprotokolle

Um die Ursache des Bereitstellungsfehlers zu ermitteln, müssen Sie die Bereitstellungsvorgangsprotokolle untersuchen. Wenn Sie weiterhin die Seite "Ihre Bereitstellung fehlgeschlagen" in der Azure-Portal anzeigen, beginnen Sie mit Schritt 5 des folgenden Verfahrens. Wenn Sie stattdessen die Azure-Portal beendet oder zu einer anderen Portalseite navigiert haben, führen Sie alle folgenden Schritte aus:

Suchen Sie im Azure-Portal nach Ressourcengruppen, und wählen Sie die entsprechende Option aus.
Wählen Sie in der Liste der Ressourcengruppen den Namen der Ressourcengruppe aus, in der Sie versucht haben, die Kubernetes-Anwendung bereitzustellen.
Suchen Sie auf der Seite "Übersicht" Ihrer Ressourcengruppe den Abschnitt "Essentials ", und wählen Sie dann den linkierten Text aus, der neben dem Feld "Bereitstellungen " angezeigt wird. Dieser Text zeigt die Erfolgsquote des Ressourcengruppenbereitstellungsverlaufs an (z . B. 4 fehlgeschlagen, 30 erfolgreich).
Wählen Sie in der Liste der versuchten Bereitstellungen für Ihre Ressourcengruppe den Wert des Bereitstellungsnamens der Bereitstellung aus, die fehlgeschlagen ist, basierend auf den folgenden entsprechenden Feldern:
- Zuletzt geändert (ein Zeitstempel)
- Dauer
- Status (zeigt fehlgeschlagen anstelle von Erfolgreich)
Suchen Sie in der Liste "Bereitstellungsdetails " auf der Bereitstellungsseite nach der Ressource , für die das Feld "Status " den Wert " Konflikt" aufweist. Wählen Sie den Link "Vorgangsdetails " für diese Ressource aus.
Suchen Sie im Detailbereich "Vorgang " die Statuseigenschaft (zeigt den Wert " Konflikt" an), und überprüfen Sie das Meldungsfeld "Status" unterhalb der Eigenschaft.

Der JSON-Code in der Statusmeldung zeigt eine status Eigenschaft von Failed. Außerdem wird eine error Eigenschaft angezeigt, die die untergeordneten Eigenschaften code enthält (ein Fehlercodename, z. B. "ExtensionOperationFailed") und message (eine Fehlermeldung, z. B. "Fehler beim Erweiterungsvorgang mit dem folgenden Fehler: Fehler beim Beheben der Erweiterungsversion aus den angegebenen Werten.") Der JSON-Code ähnelt dem folgenden Text:
```
{
    "status": "Failed",
    "error": {
        "code": "ExtensionOperationFailed",
        "message": "The extension operation failed with the following error: Failed to resolve the extension version from the given values."
    }
}
```

In den folgenden Abschnitten wird die Ursache und Lösung für einige häufige Fehlerszenarien erläutert.

Ursache 1: Die Anwendung wurde nicht auf dem ausgewählten AKS-Cluster installiert.

Wenn die Kubernetes-Anwendung nicht auf dem ausgewählten Azure Kubernetes Service (AKS)-Cluster installiert wurde, erhalten Sie eine Fehlermeldung, die dem folgenden Text ähnelt:

Fehler bei der Anforderung an https://management.azure.com/subscriptions/<subscription-guid>/resourceGroups/resourceGroups/providers/Microsoft.ContainerService/managedclusters/aks-cluster/extensionaddons/default?api-version=2021-03-01. Fehlercode: Verboten. Grund: Verboten.
{  
  "error": {  
    "code": "AuthorizationFailed",  
    "message": "The client '<client-guid>' with object id '<client-guid>' does not have authorization to perform action 'Microsoft.ContainerService/managedclusters/extensionaddons/read' over scope '/subscriptions/<subscription-guid>/resourceGroups/resourceGroup/providers/Microsoft.ContainerService/managedclusters/aks-cluster/extensionaddons/default' or the scope is invalid. If access was recently granted, please refresh your credentials."  
  }  
} 

Lösung 1a: Registrieren des Microsoft.KubernetesConfiguration-Ressourcenanbieters

Registrieren Sie den Microsoft.KubernetesConfiguration-Ressourcenanbieter. In diesem Fall ist die Installation fehlgeschlagen, da der Microsoft.KubernetesConfiguration-Ressourcenanbieter erforderlich ist, damit Sie die Kubernetes-Anwendung bereitstellen können. Anweisungen zur Registrierung finden Sie im Abschnitt "Registrieren von Ressourcenanbietern" im Artikel "Bereitstellen eines Containerangebots aus Azure Marketplace ".

Lösung 1b: Verwalten der Integrität des AKS-Clusters

Im Allgemeinen sollten Sie die Integrität des AKS-Clusters überprüfen, um zu verhindern, dass während des Installationszeitraums andere Probleme auftreten. Um sicherzustellen, dass der Cluster fehlerfrei ist, beheben Sie Probleme, die im Cluster identifiziert werden.

Lösung 1c: Untersuchen des Azure Monitor-Aktivitätsprotokolls

Was geschieht, wenn der Cluster fehlerfrei ist, aber die Installation trotzdem fehlschlägt? Überprüfen Sie in diesem Fall das Azure Monitor-Aktivitätsprotokoll im AKS-Cluster, um die Ursache des Fehlers in dieser Phase der Installation zu ermitteln.

Ursache 2: Das Abonnement weist Ressourceneinschränkungen auf

Da Ihr Azure-Abonnement Ressourceneinschränkungen aufweist, tritt ein Fehler auf, der eine Fehlermeldung erzeugt, die dem folgenden Text ähnelt:

Das "unbekannte" Zahlungsmittel(n) wird für das Angebot mit OfferId nicht unterstützt: "<Offer-name>", PlanId "<subscription-plan-name>".

Lösung 2: Stellen Sie sicher, dass Ihr Abonnement die erforderliche Abrechnungskonfiguration erfüllt

Überprüfen Sie die Abrechnungskonfiguration des Abonnements, um sicherzustellen, dass sie die Ressourcenanforderungen der Kubernetes-Anwendung erfüllt. Weitere Informationen finden Sie unter Kaufüberprüfungen.

Ursache 3: Das Angebot war in Ihrer Region nicht verfügbar.

Sie erhalten eine Fehlermeldung, die besagt, dass das Angebot nicht in einer bestimmten geografischen Region verkauft werden kann. Die Fehlermeldung könnte dem folgenden Text ähneln:

Das Angebot: "<Angebotsname>" kann nicht im Abonnement erworben werden: "<subscription-guid>", da es nicht im Markt verkauft werden soll: "<Zwei-Buchstaben-Region-Code".

Lösung 3: Überprüfen Sie erneut, ob und wo das Angebot noch verfügbar ist

Überprüfen Sie, ob das Angebot noch verfügbar ist, und überprüfen Sie die Regionen, für die das Angebot gilt.

Ursache 4: Interner Serverfehler ist aufgetreten

Die Kubernetes-Anwendung wurde nicht installiert, da eine Erweiterungsressource nicht installiert wurde. Dieser Fehler generiert die folgende Fehlermeldung:

Fehler bei der Bereitstellung der Erweiterung beim Fehler "Interner Server"

Lösung 4: Löschen und erneutes Installieren der Erweiterung

Löschen Sie zunächst die Erweiterungsressource, die Teil des Angebotskaufs ist. Installieren Sie dann die Erweiterung erneut.

Ursache 5: Das Helm-Diagramm wurde nicht installiert.

Fehler im Helmdiagramm generieren die folgende Fehlermeldung:

Fehler beim Installieren des Diagramms aus dem Pfad [] für die Version

Lösung 5: Überprüfen Sie die Einträge, die Sie in der ARM-Vorlage erstellt haben

Stellen Sie sicher, dass die Werte und Auswahlen, die Sie in der Azure-Portal für die ARM-Vorlagenbereitstellung eingegeben haben, in der Kubernetes-Anwendung akzeptabel sind.

Ursache 6: Sie haben die rechtlichen Bedingungen für das Abonnement für diesen Plan nicht akzeptiert.

Bevor das Abonnement verwendet werden kann, müssen Sie die rechtlichen Bedingungen des Bilds akzeptieren. Andernfalls wird die folgende Fehlermeldung angezeigt:

Sie haben die rechtlichen Bedingungen für dieses Abonnement nicht akzeptiert: "<subscription-guid>" für diesen Plan. Bevor das Abonnement verwendet werden kann, müssen Sie die rechtlichen Bedingungen des Bilds akzeptieren.

Lösung 6: Akzeptieren Der rechtlichen Bestimmungen

Sie können über die Azure-Portal bereitstellen. Die Azure-Portal bietet eine Benutzeroberfläche zum Lesen und Akzeptieren der gesetzlichen Bestimmungen.

Nächste Schritte

Beheben von Fehlern bei der Bereitstellung von AKS-Clustererweiterungen

Informationen zum Haftungsausschluss von Drittanbietern

Die in diesem Artikel genannten Drittanbieterprodukte stammen von Herstellern, die von Microsoft unabhängig sind. Microsoft gewährt keine implizite oder sonstige Garantie in Bezug auf die Leistung oder Zuverlässigkeit dieser Produkte.

Kontaktieren Sie uns für Hilfe

Wenn Sie Fragen haben oder Hilfe mit Ihren Azure-Gutschriften benötigen, dann erstellen Sie beim Azure-Support eine Support-Anforderung oder fragen Sie den Azure Community-Support. Sie können auch Produktfeedback an die Azure Feedback Community senden.

Freigeben über