Come configurare i probe di integrità e i periodi di terminazione normale per le app ospitate in Azure Spring Apps

Questo articolo si applica a: ✔️ Java ✔️ C#

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

Questo articolo illustra come personalizzare le app in esecuzione in Azure Spring Apps con probe di integrità e periodi di terminazione normale.

Un probe è un'attività di diagnostica eseguita periodicamente da Azure Spring Apps in un'istanza dell'app. Per eseguire una diagnostica, Azure Spring Apps esegue una delle azioni seguenti:

• Esegue un comando arbitrario di propria scelta all'interno dell'istanza dell'app.
• Stabilisce una connessione socket TCP.
• Effettua una richiesta HTTP.

Azure Spring Apps offre regole di probe di integrità predefinite per ogni applicazione. Questo articolo illustra come personalizzare l'applicazione con tre tipi di probe di integrità:

• I probe di attività determinano quando riavviare un'applicazione. Ad esempio, i probe di attività possono identificare un deadlock, ad esempio quando un'applicazione è in esecuzione ma non è in grado di eseguire progressi. Il riavvio dell'applicazione in uno stato di deadlock può rendere disponibile l'applicazione nonostante gli errori.

• I probe di idoneità determinano quando un'istanza dell'app è pronta per iniziare ad accettare il traffico. Ad esempio, i probe di idoneità possono controllare quali istanze dell'app vengono usate come back-end per l'applicazione. Quando un'istanza dell'app non è pronta, viene rimossa dall'individuazione del servizio Kubernetes. Per altre informazioni, vedere Individuare e registrare le applicazioni Spring Boot. Per altre informazioni sull'individuazione dei servizi con il piano Enterprise, vedere Usare il Registro di sistema del servizio Tanzu.

• I probe di avvio determinano quando un'applicazione è stata avviata. Un probe di avvio disabilita i controlli di attività e conformità fino a quando l'avvio non riesce, assicurando che i probe di attività e conformità non interferiscano con l'avvio dell'applicazione. Puoi usare i probe di avvio per eseguire controlli di attività sulle applicazioni a avvio lento, impedendo all'app di terminare prima che sia operativa.

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
  

Configurare probe di integrità e terminazione normale per le applicazioni

Le sezioni seguenti descrivono come configurare i probe di integrità e la terminazione normale usando l'interfaccia della riga di comando di Azure.

Terminazione normale

Nella tabella seguente viene descritta la proprietà , che è possibile usare per configurare la terminationGracePeriodSeconds terminazione normale.

Proprietà del probe di integrità

Nella tabella seguente vengono descritte le proprietà che è possibile usare per configurare i probe di integrità.

Proprietà dell'azione probe

Esistono tre modi per controllare un'istanza dell'app usando un probe. Ogni probe deve definire una delle azioni probe seguenti:

• HTTPGetAction

  Esegue una richiesta HTTP GET sull'istanza dell'app in un percorso specificato. La diagnostica viene considerata corretta se la risposta ha un codice di stato maggiore o uguale a 200 e minore di 400.

  Nome proprietà	Descrizione
  scheme	Schema da usare per la connessione all'host. Il valore predefinito è HTTP.
  path	Percorso di accesso nel server HTTP dell'istanza dell'app, ad esempio /healthz.

• ExecAction

  Esegue un comando specificato all'interno dell'istanza dell'app. La diagnostica viene considerata corretta se il comando viene chiuso con un codice di stato pari a 0.

  Nome proprietà

  Descrizione

  command

  Comando da eseguire all'interno dell'istanza dell'app. La directory di lavoro per il comando è la directory radice (/) nel file system dell'istanza dell'app. Poiché il comando viene eseguito usando exec anziché all'interno di una shell, le istruzioni della shell non funzioneranno. Per usare una shell, chiamare in modo esplicito la shell. Uno stato di uscita pari a 0 viene considerato come attivo/integro e non zero non è integro.

• TCPSocketAction

  Esegue un controllo TCP sull'istanza dell'app.

  Non sono disponibili proprietà per l'azione TCPSocketAction .

Personalizzare l'applicazione

Procedure consigliate

Usare le procedure consigliate seguenti quando si aggiungono probe di integrità ad Azure Spring Apps:

• Usare insieme probe di attività e idoneità. Azure Spring Apps offre due approcci per l'individuazione dei servizi contemporaneamente. Quando il probe di idoneità non riesce, l'istanza dell'app viene rimossa solo dall'individuazione del servizio Kubernetes. Un probe di attività configurato correttamente può rimuovere l'istanza dell'app rilasciata dall'individuazione del servizio Eureka per evitare casi imprevisti. Per altre informazioni sull'individuazione dei servizi, vedere Individuare e registrare le applicazioni Spring Boot. Per altre informazioni sull'individuazione dei servizi con il piano Enterprise, vedere Usare il Registro di sistema del servizio Tanzu.

• All'avvio di un'istanza dell'app, il primo controllo si verifica dopo il ritardo specificato da initialDelaySeconds. I controlli successivi vengono eseguiti periodicamente, in base alla lunghezza del periodo specificata da periodSeconds. Se l'app non risponde più volte alle richieste, come specificato da failureThreshold, l'istanza dell'app viene riavviata. Assicurarsi che l'applicazione possa iniziare abbastanza velocemente o aggiornare questi parametri, in modo che il timeout initialDelaySeconds + periodSeconds * failureThreshold totale sia più lungo dell'ora di inizio dell'applicazione.

• Per le applicazioni Spring Boot, Spring Boot viene fornito con il supporto dei gruppi di integrità, consentendo agli sviluppatori di selezionare un subset di indicatori di integrità e raggrupparli in un unico stato di integrità correlato. Per altre informazioni, vedere Liveness and Readiness Probes with Spring Boot (Liveness and Readiness Probes with Spring Boot ) nel blog di Spring.

  L'esempio seguente mostra un probe di attività con Spring Boot:

  "probe": {
         "initialDelaySeconds": 30,
         "periodSeconds": 10,
         "timeoutSeconds": 1,
         "failureThreshold": 30,
         "successThreshold": 1,
         "probeAction": {
             "type": "HTTPGetAction",
             "scheme": "HTTP",
             "path": "/actuator/health/liveness"
         }
     }
  

  L'esempio seguente mostra un probe di idoneità con Spring Boot:

  "probe": {
         "initialDelaySeconds": 0,
         "periodSeconds": 10,
         "timeoutSeconds": 1,
         "failureThreshold": 3,
         "successThreshold": 1,
         "probeAction": {
             "type": "HTTPGetAction",
             "scheme": "HTTP",
             "path": "/actuator/health/readiness"
         }
     }
  

Domande frequenti

Questa sezione fornisce risposte alle domande frequenti sull'uso dei probe di integrità con Azure Spring Apps.

• Ho ricevuto una risposta 400 quando ho creato applicazioni con probe di integrità personalizzati. Che cosa significa?

  Il messaggio di errore indica il probe responsabile dell'errore di provisioning. Assicurarsi che le regole del probe di integrità siano corrette e che il timeout sia sufficientemente lungo per consentire all'applicazione di trovarsi nello stato in esecuzione.

• Quali sono le impostazioni predefinite del probe per un'applicazione esistente?

  L'esempio seguente mostra le impostazioni predefinite:

  "startupProbe": null,
  "livenessProbe": {
      "disableProbe": false,
      "failureThreshold": 3,
      "initialDelaySeconds": 300,
      "periodSeconds": 10,
      "probeAction": {
          "type": "TCPSocketAction"
      },
      "successThreshold": 1,
      "timeoutSeconds": 3
  },
  "readinessProbe": {
      "disableProbe": false,
      "failureThreshold": 3,
      "initialDelaySeconds": 0,
      "periodSeconds": 5,
      "probeAction": {
          "type": "TCPSocketAction"
      },
      "successThreshold": 1,
      "timeoutSeconds": 3
  }
  

Passaggi successivi

• Ridimensionare un'applicazione in Azure Spring Apps.