Problemen met de mislukte implementatie van een Kubernetes-toepassingsaanbieding oplossen

Artikel
04/12/2024

In dit artikel wordt beschreven hoe u problemen kunt oplossen met een mislukte implementatie van een Kubernetes-toepassingsaanbieding die is geaccepteerd op de Microsoft Azure Marketplace. Wanneer u de aankoop van een Kubernetes-aanbieding start, implementeert Azure een Azure Resource Manager-sjabloon (ARM-sjabloon) waarmee wordt geprobeerd de vereiste resources te installeren om aan de aanbieding te voldoen. De implementatie van de ARM-sjabloon kan echter om verschillende redenen mislukken.

Controlelijst voor probleemoplossing

De implementatiebewerkingslogboeken onderzoeken

Om de oorzaak van de implementatiefout te bepalen, moet u de implementatiebewerkingslogboeken bekijken. Als u de pagina Uw implementatie mislukt nog steeds bekijkt in de Azure Portal, begint u bij stap 5 van de volgende procedure. Als u in plaats daarvan de Azure Portal hebt afgesloten of naar een andere portalpagina bent genavigeerd, volgt u al deze stappen:

Zoek en selecteer resourcegroepen in de Azure Portal.
Selecteer in de lijst met resourcegroepen de naam van de resourcegroep waarin u de Kubernetes-toepassing wilt implementeren.
Zoek op de pagina Overzicht van uw resourcegroep de sectie Essentials en selecteer vervolgens de hyperlinktekst die wordt weergegeven naast het veld Implementaties. In deze tekst wordt het slagingspercentage van de resource-implementatiegeschiedenis van uw resourcegroep weergegeven (bijvoorbeeld 4 mislukt, 30 geslaagd).
Selecteer in de lijst met implementatiepogingen voor uw resourcegroep de waarde implementatienaam van de implementatie die is mislukt, op basis van de volgende bijbehorende velden:
- Laatst gewijzigd (een tijdstempel)
- Duur
- Status (toont Mislukt in plaats van Geslaagd)
Zoek in de lijst Implementatiedetails op de implementatiepagina de Resource waarvoor het veld Status de waarde Conflict heeft. Selecteer de koppeling Bewerkingsgegevens voor die resource.
Zoek in het deelvenster Bewerkingsdetails de eigenschap Status (toont de waarde Conflict) en bekijk het berichtvak Status onder de eigenschap.

De JSON-code in het statusbericht toont een status eigenschap van Failed. Er wordt ook een error eigenschap weergegeven die de onderliggende eigenschappen bevat van code (een foutcodenaam, zoals 'ExtensionOperationFailed') en message (een beschrijving van een foutbericht, zoals 'De extensiebewerking is mislukt met de volgende fout: Kan de extensieversie van de opgegeven waarden niet oplossen.' De JSON-code lijkt op de volgende tekst:
```
{
    "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 de volgende secties worden de oorzaak en oplossing voor enkele veelvoorkomende foutscenario's besproken.

Oorzaak 1: De toepassing is niet geïnstalleerd op het geselecteerde AKS-cluster

Als de Kubernetes-toepassing niet is geïnstalleerd op het geselecteerde AKS-cluster (Azure Kubernetes Service), ontvangt u een foutbericht dat lijkt op de volgende tekst:

De aanvraag is mislukt voor https://management.azure.com/subscriptions/<subscription-guid>/resourceGroups/resourceGroup/providers/Microsoft.ContainerService/managedclusters/aks-cluster/extensionaddons/default?api-version=2021-03-01. Foutcode: Verboden. Reden: Verboden.
{  
  "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."  
  }  
} 

Oplossing 1a: De resourceprovider Microsoft.KubernetesConfiguration registreren

Registreer de resourceprovider Microsoft.KubernetesConfiguration. In dit geval is de installatie mislukt omdat de resourceprovider Microsoft.KubernetesConfiguration is vereist voor het implementeren van de Kubernetes-toepassing. Zie de sectie Resourceproviders registreren in het artikel Een containeraanbieding implementeren uit Azure Marketplace voor registratie-instructies.

Oplossing 1b: De status van het AKS-cluster onderhouden

Over het algemeen moet u de status van het AKS-cluster controleren om te voorkomen dat er andere problemen optreden tijdens de installatieperiode. Los problemen op die zijn geïdentificeerd in het cluster om ervoor te zorgen dat het cluster in orde is.

Oplossing 1c: Het Activiteitenlogboek van Azure Monitor bekijken

Wat gebeurt er als het cluster in orde is, maar de installatie nog steeds mislukt? Bekijk in dat geval het Activiteitenlogboek van Azure Monitor in het AKS-cluster om de oorzaak van de fout in die fase van de installatie te vinden.

Oorzaak 2: Het abonnement heeft resourcebeperkingen

Omdat uw Azure-abonnement resourcebeperkingen heeft, treedt er een fout op die een foutbericht genereert dat vergelijkbaar is met de volgende tekst:

De 'onbekende' betaalmiddelen worden niet ondersteund voor aanbieding met OfferId: '<offer-name>', PlanId '<subscription-plan-name>'.

Oplossing 2: Zorg ervoor dat uw abonnement voldoet aan de benodigde factureringsconfiguratie

Controleer de factureringsconfiguratie van het abonnement om ervoor te zorgen dat deze voldoet aan de resourcevereisten van de Kubernetes-toepassing. Zie Validatiecontroles aanschaffen voor meer informatie.

Oorzaak 3: de aanbieding was niet beschikbaar in uw regio

U ontvangt een foutbericht waarin wordt aangegeven dat de aanbieding niet kan worden verkocht in een bepaalde geografische regio. Het foutbericht lijkt mogelijk op de volgende tekst:

De Aanbieding: '<offer-name>' kan niet worden gekocht per abonnement: '<subscription-guid>' omdat deze niet op de markt mag worden verkocht: '<two-letter-region-code'.

Oplossing 3: controleer opnieuw of en waar de aanbieding nog beschikbaar is

Controleer of de aanbieding nog steeds beschikbaar is en controleer de regio's waarop de aanbieding van toepassing is.

Oorzaak 4: er is een interne serverfout opgetreden

De Kubernetes-toepassing is niet geïnstalleerd omdat een extensieresource niet is geïnstalleerd. Deze fout genereert het volgende foutbericht:

Extensie kan niet worden geïmplementeerd met interne serverfout

Oplossing 4: De extensie verwijderen en opnieuw installeren

Verwijder eerst de extensieresource die deel uitmaakt van de aankoop van de aanbieding. Installeer vervolgens de extensie opnieuw.

Oorzaak 5: De Helm-grafiek is niet geïnstalleerd

Fouten in de Helm-grafiek genereren het volgende foutbericht:

Kan grafiek niet installeren vanaf pad [] voor release

Oplossing 5: De vermeldingen die u hebt gemaakt in de ARM-sjabloon opnieuw controleren

Zorg ervoor dat de waarden en selecties die u hebt ingevoerd op de Azure Portal voor de implementatie van de ARM-sjabloon, acceptabel zijn in de Kubernetes-toepassing.

Oorzaak 6: U hebt de juridische voorwaarden voor het abonnement voor dit abonnement niet geaccepteerd

Voordat het abonnement kan worden gebruikt, moet u de juridische voorwaarden van de installatiekopieën accepteren. Anders krijgt u het volgende foutbericht:

U hebt de juridische voorwaarden voor dit abonnement: '<subscription-guid>' voor dit abonnement niet geaccepteerd. Voordat het abonnement kan worden gebruikt, moet u de juridische voorwaarden van de installatiekopieën accepteren.

Oplossing 6: Accepteer de juridische voorwaarden

U kunt implementeren via de Azure Portal. De Azure Portal biedt een gebruikersinterface voor het lezen en accepteren van de juridische voorwaarden.

Volgende stappen

Fouten oplossen bij het implementeren van AKS-clusterextensies

Disclaimerinformatie van derden

De producten van derden die in dit artikel worden vermeld, worden vervaardigd door bedrijven die onafhankelijk zijn van Microsoft. Microsoft verleent dan ook geen enkele garantie, impliciet noch anderszins, omtrent de prestaties of de betrouwbaarheid van deze producten.

Contacteer ons voor hulp

Als u vragen hebt of hulp nodig hebt, maak een ondersteuningsaanvraag of vraag de Azure-communityondersteuning. U kunt ook productfeedback verzenden naar de Feedback-community van Azure.

Delen via