Connessione a un'istanza dell'app per la risoluzione dei problemi

Nota

Azure Spring Apps è il nuovo nome del servizio Azure Spring Cloud. Anche se il servizio ha un nuovo nome, il nome precedente verrà visualizzato in alcune posizioni per un po' mentre si lavora per aggiornare gli asset, ad esempio screenshot, video e diagrammi.

Questo articolo si applica a: ✔️ Basic/Standard ✔️ Enterprise

Questo articolo descrive come accedere all'ambiente shell all'interno delle istanze dell'applicazione per la risoluzione dei problemi avanzata.

Anche se Azure Spring Apps offre diversi approcci per la risoluzione dei problemi gestiti, è consigliabile eseguire operazioni avanzate di risoluzione dei problemi usando l'ambiente della shell. Ad esempio, è possibile eseguire le attività di risoluzione dei problemi seguenti:

• Usare direttamente gli strumenti di Java Development Kit (JDK).
• Diagnosticare i servizi back-end di un'app per la latenza di connessione di rete e di chiamata API per le istanze di rete virtuale e non di rete virtuale.
• Diagnosticare i problemi di capacità di archiviazione, prestazioni e CPU/memoria.

Prerequisiti

• Interfaccia della riga di comando di Azure con l'estensione Azure Spring Apps. Usare il comando seguente per rimuovere le versioni precedenti e installare l'estensione più recente. Se l'estensione spring-cloud è stata installata in precedenza, disinstallarla per evitare la mancata corrispondenza della configurazione e della versione.

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

• Applicazione distribuita in Azure Spring Apps.

• Se è stato distribuito un contenitore personalizzato, un programma shell. Il valore predefinito è /bin/sh.

Assegnare un ruolo di Azure

Prima di connettersi a un'istanza dell'app, è necessario concedere il ruolo Azure Spring Apps Connessione Role. Connessione a un'istanza dell'app richiede l'autorizzazione Microsoft.AppPlatform/Spring/apps/deployments/connect/actionper l'azione dati .

È possibile assegnare un ruolo di Azure usando il portale di Azure o l'interfaccia della riga di comando di Azure.

Azure portal

Usare la procedura seguente per assegnare un ruolo di Azure usando il portale di Azure.

1. Apri il portale di Azure.

2. Aprire l'istanza del servizio Azure Spring Apps esistente.

3. Selezionare Controllo di accesso (IAM) dal menu a sinistra.

4. Selezionare Aggiungi nella barra dei comandi e quindi selezionare Aggiungi assegnazione di ruolo.

   

5. Cercare Azure Spring Apps Connessione Ruolo nell'elenco e quindi selezionare Avanti.

   

6. Selezionare Seleziona membri e quindi cercare il nome utente.

7. Seleziona Rivedi + assegna.

Interfaccia della riga di comando di Azure

Usare il comando seguente per assegnare il ruolo Ruolo di Azure Spring Apps Connessione usando l'interfaccia della riga di comando di Azure:

az role assignment create \
    --role 'Azure Spring Apps Connect Role' \
    --scope '<service-instance-resource-id>' \
    --assignee '<your-identity>'

Nota

L'assegnazione di ruolo può richiedere alcuni minuti.

Connessione a un'istanza dell'app

È possibile connettersi a un'istanza dell'app usando il portale di Azure o l'interfaccia della riga di comando di Azure.

Azure portal

Usare la procedura seguente per connettersi a un'istanza dell'app usando il portale di Azure.

1. Apri il portale di Azure.

2. Aprire l'istanza del servizio Azure Spring Apps esistente.

3. Selezionare App dal menu a sinistra e quindi selezionare una delle app.

4. Selezionare Console dal menu a sinistra.

5. Selezionare un'istanza dell'applicazione.

   

6. Selezionare o immettere una shell da eseguire nel contenitore.

   

7. Selezionare Connetti.

   

Interfaccia della riga di comando di Azure

Se l'app contiene una sola istanza, usare il comando seguente per connettersi all'istanza usando l'interfaccia della riga di comando di Azure:

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name> 

In caso contrario, usare il comando seguente per specificare l'istanza:

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name> \
    --instance <instance_name>

Usare il comando seguente per specificare un'altra distribuzione dell'app:

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name> \
    --deployment green

Per impostazione predefinita, Azure Spring Apps avvia l'istanza dell'app in /bin/sh bundle nell'immagine di base del contenitore. Usare il comando seguente per passare a un'altra shell in bundle, ad /bin/bashesempio :

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name> \
    --shell-cmd /bin/bash

Se l'app viene distribuita con un'immagine personalizzata e una shell, è anche possibile usare il parametro per specificare la --shell-cmd shell.

Risolvere i problemi relativi all'istanza dell'app

Dopo la connessione a un'istanza dell'app, è possibile controllare lo stato della memoria dell'heap.

Usare il comando seguente per trovare l'ID processo Java, in genere 1:

jps

L'output dovrebbe essere simile all'esempio seguente:

Usare quindi il comando seguente per eseguire lo strumento JDK per controllare il risultato:

jstat -gc 1

L'output dovrebbe essere simile all'esempio seguente:

Disconnettersi dall'istanza dell'app

Al termine della risoluzione dei problemi, usare il exit comando per disconnettersi dall'istanza dell'app o premere Ctrl+d.

Strumenti per la risoluzione dei problemi

L'elenco seguente descrive alcuni degli strumenti preinstallati che è possibile usare per la risoluzione dei problemi:

• lsof - Elenca i file aperti.
• top - Visualizza le informazioni di riepilogo del sistema e l'utilizzo corrente.
• ps - Ottiene uno snapshot del processo in esecuzione.
• netstat - Stampa le connessioni di rete e le statistiche dell'interfaccia.
• nslookup - Esegue query su server dei nomi Internet in modo interattivo.
• ping - Verifica se è possibile raggiungere un host di rete.
• nc - Legge e scrive nelle connessioni di rete tramite TCP o UDP.
• wget - Consente di scaricare i file e interagire con le API REST.
• df - Visualizza la quantità di spazio disponibile su disco.

È anche possibile usare strumenti in bundle JDK, ad jpsesempio , jcmde jstat.

L'elenco seguente mostra gli strumenti disponibili, che dipendono dal piano di servizio e dal tipo di distribuzione dell'app:

• Distribuzione di codice sorgente, JAR e artefatti:
  • Basic, Standard e Standard Consumption & Dedicated Plan:
    • Strumenti comuni - Sì
    • Strumenti JDK: sì, solo per i carichi di lavoro Java.
  • Piano aziendale:
    • Strumenti comuni: dipende dallo stack del sistema operativo scelto nel generatore. Sì, per lo stack di sistemi operativi completo. No, per stack del sistema operativo di base.
    • Strumenti JDK: sì, solo per i carichi di lavoro Java.
• Distribuzione di immagini personalizzate: dipende dal set di strumenti installato nell'immagine.

Nota

Gli strumenti JDK non sono inclusi nel percorso per il tipo di distribuzione del codice sorgente. Eseguire export PATH="$PATH:/layers/tanzu-buildpacks_microsoft-openjdk/jdk/bin" prima di eseguire qualsiasi comando JDK.

Limiti

L'uso dell'ambiente shell all'interno delle istanze dell'applicazione presenta le limitazioni seguenti:

• Poiché l'app è in esecuzione come utente non radice, non è possibile eseguire alcune azioni che richiedono l'autorizzazione radice. Ad esempio, non è possibile installare nuovi strumenti usando gestione pacchetti apt / yumdi sistema .

• Poiché alcune funzionalità di Linux non sono consentite, gli strumenti che richiedono privilegi speciali, ad esempio tcpdump, non funzionano.

Passaggi successivi

• Diagnosticare e risolvere in autonomia i problemi in Azure Spring Apps