Problemen met de mislukte implementatie van een Kubernetes-toepassingsaanbieding oplossen

Artikel
11/20/2024

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

Controlelijst voor probleemoplossing

De implementatiebewerkingslogboeken bekijken

Als u de oorzaak van de implementatiefout wilt bepalen, moet u de logboeken van de implementatiebewerking controleren. Als u de pagina Uw implementatie mislukt nog steeds bekijkt in 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, voert u deze stappen uit:

Zoek en selecteer Resourcegroepen in Azure Portal.
Selecteer in de lijst met resourcegroepen de naam van de resourcegroep waarin u de Kubernetes-toepassing wilde implementeren.
Zoek op de pagina Overzicht van uw resourcegroep de sectie Essentials en selecteer vervolgens de hyperlinktekst die naast het veld Implementaties wordt weergegeven. In deze tekst wordt het slagingspercentage van de resourcegroepsgeschiedenis van de resourcegroep weergegeven (bijvoorbeeld 4 mislukt, 30 geslaagd).
Selecteer in de lijst met geprobeerde implementaties voor uw resourcegroep de waarde voor de 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 Met 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 Details van bewerking de eigenschap Status (geeft een waarde conflict weer) 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 met de onderliggende eigenschappen 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 niet oplossen op basis van de opgegeven waarden.' 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."
    }
}
```

De volgende secties bespreken de oorzaak en oplossing voor enkele veelvoorkomende foutscenario's.

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:

Aanvraag is mislukt voor https://management.azure.com/subscriptions/<subscription-guid>/resourceGroups/resourceGroups/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 vanuit Azure Marketplace voor registratie-instructies.

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

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 onderzoeken

Wat gebeurt er als het cluster in orde is, maar de installatie nog steeds mislukt? In dat geval bekijkt u 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 produceert dat vergelijkbaar is met de volgende tekst:

De 'onbekende' betaalmiddel(en) worden niet ondersteund voor aanbiedingen met OfferId: '<offer-name>', PlanId '<subscription-plan-name>'.

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

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

Oorzaak 3: De aanbieding is niet beschikbaar in uw regio

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

De aanbieding: '<aanbiedingsnaam>' kan niet worden aangeschaft door abonnement: '<subscription-guid>' omdat deze niet op de markt moet worden verkocht: '<tweeletterige regiocode'.

Oplossing 3: Controleer opnieuw of en waar de aanbieding nog steeds 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. Met deze fout wordt het volgende foutbericht gegenereerd:

De extensie kan niet worden geïmplementeerd met een interne serverfout

Oplossing 4: de extensie verwijderen en opnieuw installeren

Verwijder eerst de extensieresource die deel uitmaakt van de aanbiedingsaankoop. 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: Controleer de vermeldingen die u hebt gemaakt in de ARM-sjabloon opnieuw

Zorg ervoor dat de waarden en selecties die u hebt ingevoerd in Azure Portal voor de implementatie van arm-sjablonen acceptabel zijn in de Kubernetes-toepassing.

Oorzaak 6: U hebt de wettelijke 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 niet geaccepteerd: '<subscription-guid>' voor dit abonnement. 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 Azure Portal. Azure Portal biedt een gebruikersinterface-ervaring voor het lezen en accepteren van de juridische voorwaarden.

Volgende stappen

Fouten bij het implementeren van AKS-clusterextensies oplossen

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 Azure-feedbackcommunity.

Delen via