Esecuzione dei controlli di integrità

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Apigee espone i controlli di integrità a diversi livelli, che puoi sfruttare a seconda del caso d'uso.

  1. Controllo di integrità a livello di regione / dell'istanza Apigee: restituisce l'integrità dell'istanza Apigee complessiva in una regione.
  2. Controlli di integrità a livello di ambiente:restituisce lo stato di un determinato ambiente nell'istanza Apigee.
  3. Controllo di integrità personalizzato tramite un proxy API:per casi d'uso complessi, puoi configurare un proxy API dedicato come endpoint di controllo di integrità personalizzato.

Eseguire un controllo di integrità a livello di regione

Apigee offre un controllo di integrità a livello di regione / istanza Apigee per valutare lo stato di salute complessivo dell'istanza Apigee in una regione specifica. Questo pattern di controllo di integrità, ampiamente utilizzato dai bilanciatori del carico, determina lo stato di integrità delle istanze Apigee ed esegue i failover regionali. Puoi eseguire un controllo di integrità a livello di regione costruendo la richiesta nel seguente modo:

  • Percorso del controllo di integrità: /healthz/ingress
  • Aggiungi l'intestazione della richiesta: User-Agent: GoogleHC.
$ curl -H 'User-Agent: GoogleHC' https://$HOST/healthz/ingress
Apigee Ingress is healthy
 dove $HOST rappresenta il nome host definito nel gruppo di ambienti Apigee pubblicato dal bilanciatore del carico.

Eseguire un controllo di integrità a livello di ambiente

Apigee offre un controllo di integrità a livello di ambiente per valutare lo stato di un determinato ambiente fornito dall'istanza Apigee. Questo modello di controllo di integrità è preferibile quando vuoi eseguire interruzioni del servizio a livello di regione in base allo stato di determinati ambienti critici/selettivi. Puoi eseguire un controllo di integrità a livello di ambiente chiamando qualsiasi proxy API valido in un ambiente costruendo la richiesta come segue:

  • Anteponi /healthz/ al percorso di base del proxy.
  • Aggiungi l'intestazione della richiesta: User-Agent: GoogleHC.

Ad esempio, supponiamo che /catalog sia un percorso base proxy valido di cui è stato eseguito il deployment in un ambiente. Per eseguire un controllo di integrità, chiama il proxy come segue: 

$ curl -H 'User-Agent: GoogleHC' https://$HOST/healthz/catalog
Server Ready
 dove $HOST rappresenta il nome host definito nel gruppo di ambienti Apigee pubblicato dal bilanciatore del carico.

Esecuzione di un controllo di integrità personalizzato tramite un proxy API

Se vuoi eseguire ulteriori convalide, puoi definire la logica di controllo di integrità personalizzata in un proxy API di cui è stato eseguito il deployment in un ambiente. Ad esempio, potresti non superare il controllo dell'integrità quando più ambienti sono inattivi. In alternativa, puoi far fallire il controllo di integrità in base all'integrità o alla latenza del target.

In questo caso, puoi eseguire il controllo di integrità effettuando una normale chiamata API al proxy.

Ad esempio, supponiamo che tu voglia controllare l'integrità di un ambiente denominato prod. Esegui il deployment di un proxy API in quell'ambiente con il percorso di base /healthcheck-prod. Per controllare l'integrità dell'ambiente prod servito dall'istanza Apigee, chiama il proxy nel seguente modo: 

$ curl https://$HOST/healthcheck-prod
 dove $HOST rappresenta il nome host definito nel gruppo di ambienti Apigee pubblicato dal bilanciatore del carico.

Note sull'utilizzo

Per i controlli di integrità a livello di regione e di ambiente: se vengono eseguiti dai bilanciatori del carico Google Cloud, il bilanciatore del carico imposta l'intestazione User-Agent corretta. Se il tuo client utilizza queste chiamate API di controllo di integrità, devi assicurarti che sia impostato User-Agent corretto.

Per Apigee hybrid: la funzionalità di controllo di integrità è disponibile solo per la versione 1.4 e successive.