Risolvere i problemi relativi alla distribuzione non riuscita di un'offerta di applicazione Kubernetes

Articolo
04/12/2024

Questo articolo illustra come risolvere i problemi relativi a una distribuzione non riuscita di un'offerta di applicazione Kubernetes accettata in Microsoft Azure Marketplace. Quando si avvia l'acquisto di un'offerta Kubernetes, Azure distribuisce un modello di Azure Resource Manager (modello arm) che tenta di installare le risorse necessarie per soddisfare l'offerta. Tuttavia, la distribuzione del modello di Resource Manager potrebbe non riuscire per vari motivi.

Elenco di controllo per la risoluzione dei problemi

Esaminare i log delle operazioni di distribuzione

Per determinare la causa dell'errore di distribuzione, è necessario esaminare i log delle operazioni di distribuzione. Se si sta ancora visualizzando la pagina Distribuzione non riuscita nel portale di Azure, iniziare al passaggio 5 della procedura seguente. Se invece si è chiuso il portale di Azure o si è passati a un'altra pagina del portale, seguire tutti i passaggi seguenti:

Nel portale di Azure cercare e selezionare Gruppi di risorse.
Nell'elenco dei gruppi di risorse selezionare il nome del gruppo di risorse in cui si è tentato di distribuire l'applicazione Kubernetes.
Nella pagina Panoramica del gruppo di risorse individuare la sezione Essentials e quindi selezionare il testo con collegamento ipertestuale visualizzato accanto al campo Distribuzioni. Questo testo visualizza la frequenza di riuscita della cronologia di distribuzione delle risorse del gruppo di risorse (ad esempio, 4 non riuscito, 30 riuscito).
Nell'elenco delle distribuzioni tentate per il gruppo di risorse selezionare il valore nome distribuzione della distribuzione non riuscita, in base ai campi corrispondenti seguenti:
- Ultima modifica (timestamp)
- Durata
- Stato (mostra Failed anziché Succeeded)
Nell'elenco Dettagli distribuzione nella pagina di distribuzione individuare la risorsa per cui il campo Stato ha il valore Conflitto. Selezionare il collegamento Dettagli operazione per la risorsa.
Nel riquadro Dettagli operazione individuare la proprietà Status (mostra il valore Conflict) ed esaminare la finestra di messaggio Status sotto la proprietà .

Il codice JSON all'interno del messaggio di stato mostra una status proprietà di Failed. Viene inoltre visualizzata una error proprietà che contiene le proprietà figlio di (un nome di codice di code errore, ad esempio "ExtensionOperationFailed") e message (una descrizione del messaggio di errore, ad esempio "L'operazione di estensione non è riuscita con l'errore seguente: Impossibile risolvere la versione dell'estensione dai valori specificati". Il codice JSON è simile al testo seguente:
```
{
    "status": "Failed",
    "error": {
        "code": "ExtensionOperationFailed",
        "message": "The extension operation failed with the following error: Failed to resolve the extension version from the given values."
    }
}
```

Le sezioni seguenti illustrano la causa e la soluzione per alcuni scenari di errore comuni.

Causa 1: l'applicazione non è stata installata nel cluster del servizio Azure Kubernetes selezionato

Se l'applicazione Kubernetes non è stata installata nel cluster servizio Azure Kubernetes selezionato, viene visualizzato un messaggio di errore simile al testo seguente:

La richiesta non è riuscita a https://management.azure.com/subscriptions/<subscription-guid>/resourceGroups/resourceGroup/providers/Microsoft.ContainerService/managedclusters/aks-cluster/extensionaddons/default?api-version=2021-03-01. Codice di errore: Non consentito. Motivo: Non consentito.
{  
  "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."  
  }  
} 

Soluzione 1a: registrare il provider di risorse Microsoft.KubernetesConfiguration

Registrare il provider di risorse Microsoft.KubernetesConfiguration. In questo caso, l'installazione non è riuscita perché il provider di risorse Microsoft.KubernetesConfiguration è necessario per distribuire l'applicazione Kubernetes. Per istruzioni sulla registrazione, vedere la sezione "Registrare i provider di risorse" nell'articolo Distribuire un'offerta contenitore da Azure Marketplace.

Soluzione 1b: mantenere l'integrità del cluster del servizio Azure Kubernetes

In generale, è necessario controllare l'integrità del cluster del servizio Azure Kubernetes per evitare che si verifichino altri problemi durante il periodo di installazione. Per assicurarsi che il cluster sia integro, risolvere i problemi identificati nel cluster.

Soluzione 1c: esaminare il log attività di Monitoraggio di Azure

Cosa accade se il cluster è integro, ma l'installazione continua a non riuscire? In tal caso, esaminare il log attività di Monitoraggio di Azure all'interno del cluster del servizio Azure Kubernetes per individuare la causa dell'errore in quella fase dell'installazione.

Causa 2: La sottoscrizione ha vincoli di risorse

Poiché la sottoscrizione di Azure presenta vincoli di risorse, si verifica un errore che genera un messaggio di errore simile al testo seguente:

Gli strumenti di pagamento "sconosciuti" non sono supportati per l'offerta con OfferId: '<offer-name>', PlanId '<subscription-plan-name>'.

Soluzione 2: assicurarsi che la sottoscrizione soddisfi la configurazione di fatturazione necessaria

Verificare la configurazione di fatturazione della sottoscrizione per assicurarsi che soddisfi i requisiti delle risorse dell'applicazione Kubernetes. Per altre informazioni, vedere Controlli di convalida degli acquisti.

Causa 3: L'offerta non era disponibile nell'area

Viene visualizzato un messaggio di errore che indica che l'offerta non può essere venduta in una determinata area geografica. Il messaggio di errore potrebbe essere simile al testo seguente:

L'offerta: '<offer-name>' non può essere acquistata dalla sottoscrizione: '<subscription-guid>' in quanto non deve essere venduta sul mercato: '<two-letter-region-code'.

Soluzione 3: verificare nuovamente se e dove l'offerta è ancora disponibile

Verificare che l'offerta sia ancora disponibile e controllare le aree a cui si applica l'offerta.

Causa 4: Si è verificato un errore interno del server

L'applicazione Kubernetes non è stata installata perché non è stata installata una risorsa di estensione. Questo errore genera il messaggio di errore seguente:

Impossibile distribuire l'estensione con errore interno del server

Soluzione 4: Eliminare e reinstallare l'estensione

Prima di tutto, eliminare la risorsa di estensione che fa parte dell'acquisto dell'offerta. Reinstallare quindi l'estensione.

Causa 5: il grafico Helm non è stato installato

Gli errori nel grafico Helm generano il messaggio di errore seguente:

Impossibile installare il grafico dal percorso [] per la versione

Soluzione 5: ricontrollare le voci create nel modello di Resource Manager

Assicurarsi che i valori e le selezioni immessi nel portale di Azure per la distribuzione del modello di Arm siano accettabili nell'applicazione Kubernetes.

Causa 6: non sono state accettate le condizioni legali per la sottoscrizione per questo piano

Prima di poter usare la sottoscrizione, è necessario accettare le condizioni legali dell'immagine. In caso contrario, viene visualizzato il messaggio di errore seguente:

Non sono state accettate le condizioni legali per questa sottoscrizione: "<subscription-guid>" per questo piano. Prima di poter usare la sottoscrizione, è necessario accettare le condizioni legali dell'immagine.

Soluzione 6: Accettare le condizioni legali

È possibile eseguire la distribuzione tramite il portale di Azure. Il portale di Azure offre un'esperienza di interfaccia utente per la lettura e l'accettazione delle condizioni legali.

Passaggi successivi

Risolvere gli errori durante la distribuzione delle estensioni del cluster del servizio Azure Kubernetes

Dichiarazione di non responsabilità sulle informazioni di terze parti

I prodotti di terzi citati in questo articolo sono prodotti da società indipendenti da Microsoft. Microsoft non rilascia alcuna garanzia implicita o esplicita relativa alle prestazioni o all'affidabilità di tali prodotti

Contattaci per ricevere assistenza

In caso di domande o bisogno di assistenza, creare una richiesta di supporto tecnico oppure formula una domanda nel Supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.

Condividi tramite