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.
- Controllo di integrità a livello di regione / istanza Apigee: restituisce l'integrità complessiva dell'istanza Apigee in una regione.
- Controlli di integrità a livello di ambiente:restituisce lo stato di integrità di un determinato ambiente nell'istanza Apigee.
- 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.
Esecuzione di 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 integrità 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 creando 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
$HOST
rappresenta il nome host definito nel
gruppo di ambienti Apigee
servito 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 ambiente specifico gestito dall'istanza Apigee. Questo pattern di controllo di integrità è preferibile quando vuoi eseguire failover regionali 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 nel seguente modo:
- Anteponi
/healthz/
al percorso di base del proxy. - Aggiungi l'intestazione della richiesta:
User-Agent: GoogleHC
.
Ad esempio, supponi che /catalog
sia un basepath 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 Ready
$HOST
rappresenta il nome host definito nel
gruppo di ambienti Apigee
servito dal bilanciatore del carico.
Esecuzione di un controllo di integrità personalizzato tramite un proxy API
Se vuoi eseguire ulteriori convalide, puoi definire una logica di controllo di integrità personalizzata in un proxy API di cui è stato eseguito il deployment in un ambiente. Ad esempio, il controllo dello stato potrebbe non riuscire quando più ambienti non sono disponibili. In alternativa, potresti non superare il controllo di integrità in base all'integrità o alla latenza della destinazione.
In questo caso, puoi eseguire il controllo di integrità effettuando una normale chiamata API a questo 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 basepath /healthcheck-prod
.
Per controllare l'integrità dell'ambiente prod
gestito dall'istanza Apigee,
chiama il proxy nel seguente modo:
$ curl https://$HOST/healthcheck-prod
$HOST
rappresenta il nome host definito nel
gruppo di ambienti Apigee
servito 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 il User-Agent
corretto.
Per Apigee hybrid: la funzionalità di controllo di integrità è disponibile solo per la versione 1.4 e successive.