Felsöka den misslyckade distributionen av ett Kubernetes-programerbjudande

Artikel
11/20/2024

I den här artikeln beskrivs hur du felsöker en misslyckad distribution av ett Kubernetes-programerbjudande som godkändes på Microsoft Azure Marketplace. När du startar köpet av ett Kubernetes-erbjudande distribuerar Azure en Azure Resource Manager-mall (ARM-mall) som försöker installera de resurser som krävs för att uppfylla erbjudandet. Distributionen av ARM-mallen kan dock misslyckas av olika orsaker.

Checklista för felsökning

Granska loggarna för distributionsåtgärden

För att fastställa orsaken till distributionsfelet måste du undersöka distributionsåtgärdsloggarna. Om du fortfarande visar sidan Distributionen misslyckades i Azure Portal börjar du i steg 5 i följande procedur. Om du i stället har avslutat Azure Portal eller navigerat till en annan portalsida följer du alla dessa steg:

I Azure Portal söker du efter och väljer Resursgrupper.
I listan över resursgrupper väljer du namnet på den resursgrupp där du försökte distribuera Kubernetes-programmet.
På sidan Översikt i resursgruppen letar du upp avsnittet Essentials och väljer sedan den hyperlänkade text som visas bredvid fältet Distributioner . Den här texten visar framgångsgraden för resursgruppens resursdistributionshistorik (till exempel 4 misslyckades, 30 lyckades).
I listan över distributionsförsök för resursgruppen väljer du värdet Distributionsnamn för distributionen som misslyckades, baserat på följande motsvarande fält:
- Senast ändrad (en tidsstämpel)
- Varaktighet
- Status (visar Misslyckades i stället för Lyckades)
I listan Distributionsinformation på distributionssidan letar du reda på resursen som fältet Status har värdet Konflikt för. Välj länken Åtgärdsinformation för resursen.
I fönstret Åtgärdsinformation letar du upp egenskapen Status (visar värdet Konflikt) och undersöker rutan Statusmeddelande under egenskapen.

JSON-koden i statusmeddelandet visar egenskapen statusFailed. Den visar också en error egenskap som innehåller underordnade egenskaper code för (ett felkodsnamn, till exempel "ExtensionOperationFailed") och message (en beskrivning av felmeddelandet, till exempel "Tilläggsåtgärden misslyckades med följande fel: Det gick inte att matcha tilläggsversionen från de angivna värdena."). JSON-koden liknar följande 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."
    }
}
```

I följande avsnitt beskrivs orsaken och lösningen för några vanliga felscenarier.

Orsak 1: Programmet installerades inte på det valda AKS-klustret

Om Kubernetes-programmet inte installerades i det valda AKS-klustret (Azure Kubernetes Service) får du ett felmeddelande som liknar följande text:

Begäran kunde inte https://management.azure.com/subscriptions/<prenumerations-guid>/resourceGroups/resourceGroup/providers/Microsoft.ContainerService/managedclusters/aks-cluster/extensionaddons/default?api-version=2021-03-01. Felkod: Förbjudet. Orsak: Förbjudet.
{  
  "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ösning 1a: Registrera resursprovidern Microsoft.KubernetesConfiguration

Registrera resursprovidern Microsoft.KubernetesConfiguration. I det här fallet misslyckades installationen eftersom resursprovidern Microsoft.KubernetesConfiguration krävs för att du ska kunna distribuera Kubernetes-programmet. Registreringsinstruktioner finns i avsnittet "Registrera resursprovidrar" i artikeln Distribuera ett containererbjudande från Azure Marketplace .

Lösning 1b: Underhålla hälsotillståndet för AKS-klustret

I allmänhet bör du kontrollera hälsotillståndet för AKS-klustret för att förhindra att andra problem uppstår under installationsperioden. Lös problem som identifieras i klustret för att säkerställa att klustret är felfritt.

Lösning 1c: Granska aktivitetsloggen för Azure Monitor

Vad händer om klustret är felfritt, men installationen fortfarande misslyckas? I så fall undersöker du Azure Monitor-aktivitetsloggen i AKS-klustret för att hitta orsaken till felet i det skedet av installationen.

Orsak 2: Prenumerationen har resursbegränsningar

Eftersom din Azure-prenumeration har resursbegränsningar uppstår ett fel som genererar ett felmeddelande som liknar följande text:

De "okända" betalningsinstrumenten stöds inte för erbjudandet med OfferId: "<offer-name>", PlanId "<subscription-plan-name>".

Lösning 2: Kontrollera att din prenumeration uppfyller den nödvändiga faktureringskonfigurationen

Kontrollera prenumerationens faktureringskonfiguration för att se till att den uppfyller resurskraven för Kubernetes-programmet. Mer information finns i Verifieringskontroller för köp.

Orsak 3: Erbjudandet var inte tillgängligt i din region

Du får ett felmeddelande om att erbjudandet inte kan säljas i en viss geografisk region. Felmeddelandet kan likna följande text:

Erbjudandet: "<offer-name>" kan inte köpas per prenumeration: "<subscription-guid>" eftersom det inte ska säljas på marknaden: "<two-letter-region-code".

Lösning 3: Kontrollera om och var erbjudandet fortfarande är tillgängligt

Kontrollera att erbjudandet fortfarande är tillgängligt och dubbelkolla de regioner som erbjudandet gäller för.

Orsak 4: Ett internt serverfel uppstod

Kubernetes-programmet installerades inte eftersom en tilläggsresurs inte installerades. Det här felet genererar följande felmeddelande:

Tillägget kunde inte distribueras med internt serverfel

Lösning 4: Ta bort och installera om tillägget

Ta först bort tilläggsresursen som ingår i erbjudandeköpet. Installera sedan om tillägget.

Orsak 5: Helm-diagrammet installerades inte

Fel i Helm-diagrammet genererar följande felmeddelande:

Det gick inte att installera diagrammet från sökvägen [] för lansering

Lösning 5: Kontrollera de poster som du gjorde i ARM-mallen igen

Kontrollera att de värden och val som du angav i Azure Portal för ARM-malldistributionen är godtagbara i Kubernetes-programmet.

Orsak 6: Du har inte accepterat de juridiska villkoren för prenumerationen för den här planen

Innan prenumerationen kan användas måste du godkänna de juridiska villkoren för avbildningen. Annars får du följande felmeddelande:

Du har inte accepterat de juridiska villkoren för den här prenumerationen: "<subscription-guid>" för den här planen. Innan prenumerationen kan användas måste du godkänna de juridiska villkoren för avbildningen.

Lösning 6: Acceptera de juridiska villkoren

Du kan distribuera via Azure Portal. Azure Portal tillhandahåller en användargränssnittsupplevelse för att läsa och acceptera de juridiska villkoren.

Nästa steg

Felsöka fel vid distribution av AKS-klustertillägg

Ansvarsfriskrivning för information från tredje part

De produkter från andra tillverkare som diskuteras i denna artikel tillverkas oberoende av Microsoft. Produkternas funktion eller tillförlitlighet kan därför inte garanteras.

Kontakta oss för att få hjälp

Om du har frågor eller behöver hjälp skapar du en supportförfrågan eller frågar Azure community support. Du kan också skicka produktfeedback till Azure-feedbackcommunityn.

Dela via