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

Articolo
11/20/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 diversi 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 nella portale di Azure, iniziare al passaggio 5 della procedura seguente. Se invece è stata chiusa la portale di Azure o si è passati a un'altra pagina del portale, seguire questa procedura:

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 Informazioni di base e quindi selezionare il testo con collegamento ipertestuale visualizzato accanto al campo Distribuzioni . Questo testo visualizza la percentuale di esito positivo della cronologia della 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 invece di Succeeded)
Nell'elenco Dettagli distribuzione della pagina di distribuzione individuare la risorsa per cui il campo Stato ha il valore Conflict (Conflitto). Selezionare il collegamento Dettagli operazione per tale risorsa.
Nel riquadro Dettagli operazione individuare la proprietà Status (mostra il valore Conflict) ed esaminare la finestra di messaggio Stato sotto la proprietà .

Il codice JSON all'interno del messaggio di stato mostra una status proprietà di Failed. Mostra anche 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: Non è stato possibile 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 di servizio Azure Kubernetes (AKS) 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 errore: Accesso negato. Motivo: Accesso negato.
{  
  "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 provider di risorse" nell'articolo Distribuire un'offerta di 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 non riesce? 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 risorsa

Poiché la sottoscrizione di Azure ha 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 geografica

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:

Offerta: '<offer-name>' cannot be purchase by subscription: '<subscription-guid>' as it is not be sold in market: '<two-letter-region-code'.

Soluzione 3: Controllare di nuovo se e dove l'offerta è ancora disponibile

Verificare che l'offerta sia ancora disponibile e verificare 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: Controllare nuovamente le voci apportate nel modello di Resource Manager

Assicurarsi che i valori e le selezioni immessi nel portale di Azure per la distribuzione del modello 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:

Le condizioni legali per questa sottoscrizione non sono state accettate: '<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