Questa pagina si applica a Apigee e Apigee ibrido.
Visualizza la documentazione di Apigee Edge.
Apigee espone controlli di integrità a diversi livelli, che puoi sfruttare a seconda del caso d'uso.
- Controllo di integrità dell'istanza Apigee a livello di regione:restituisce l'integrità dell'istanza Apigee complessiva in una regione.
- Controlli di integrità a livello di ambiente: restituisce l'integrità di un determinato ambiente nell'istanza Apigee.
- Controllo di integrità personalizzato tramite proxy API: per casi d'uso complessi, puoi configurare un proxy API dedicato come endpoint di controllo di integrità personalizzato.
Esecuzione di un controllo di integrità a livello di regione
Apigee offre un controllo di integrità dell'istanza Apigee a livello di regione per valutare lo stato di integrità complessivo dell'istanza Apigee in una regione specifica. Questo pattern di controllo di integrità, ampiamente usato dai bilanciatori del carico, determina lo stato di integrità delle istanze Apigee ed esegue failover a livello di regione. Puoi eseguire un controllo di integrità a livello di regione costruendo la richiesta come segue:
- Percorso del controllo di integrità:
/healthz/ingress
- Aggiungi intestazione della richiesta:
User-Agent: GoogleHC
.
$ curl -H 'User-Agent: GoogleHC' https://$HOST/healthz/ingress Apigee Ingress is healthydove
$HOST
rappresenta il nome host definito nel
gruppo di ambienti Apigee
gestito dal bilanciatore del carico.
Esecuzione di un controllo di integrità a livello di ambiente
Apigee offre un controllo di integrità a livello di ambiente per valutare l'integrità di un particolare ambiente gestito dall'istanza Apigee. Questo pattern di controllo di integrità è preferibile quando vuoi eseguire failover a livello di regione in base all'integrità 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 intestazione della richiesta:
User-Agent: GoogleHC
.
Ad esempio, supponiamo che /catalog
sia un percorso di base del proxy valido di cui è stato eseguito il deployment in un ambiente. Per eseguire un controllo di integrità, chiama il proxy nel seguente modo:
$ curl -H 'User-Agent: GoogleHC' https://$HOST/healthz/catalog Server Readydove
$HOST
rappresenta il nome host definito nel
gruppo di ambienti Apigee
che viene gestito dal bilanciatore del carico.
Esecuzione di un controllo di integrità personalizzato tramite un proxy API
Se vuoi eseguire altre convalide, puoi definire una logica personalizzata del controllo di integrità in un proxy API di cui è stato eseguito il deployment in un ambiente. Ad esempio, potresti non superare il controllo di integrità quando più ambienti sono inattivi. Oppure, potresti non superare il controllo di integrità in base all'integrità o alla latenza target.
In questo caso, puoi eseguire il controllo di integrità effettuando una normale chiamata API a quel proxy.
Ad esempio, supponiamo di voler controllare l'integrità di un ambiente chiamato prod
.
Esegui il deployment di un proxy API nell'ambiente con il percorso base /healthcheck-prod
.
Per verificare l'integrità dell'ambiente prod
gestito dall'istanza Apigee,
chiama il proxy in questo modo:
$ curl https://$HOST/healthcheck-prod
dove $HOST
rappresenta il nome host definito nel
gruppo di ambienti Apigee
che viene gestito 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 di Google Cloud, il bilanciatore del carico imposta l'intestazione User-Agent
corretta. Se il tuo client utilizza queste chiamate API per il controllo di integrità, devi assicurarti che sia impostato il User-Agent
corretto.
Per Apigee hybrid: la funzionalità di controllo di integrità è disponibile solo per la versione 1.4 e successive.