Risoluzione dei problemi relativi agli errori di deployment dei criteri di convalida della cache

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

InvalidCacheResourceReference

Messaggio di errore

Il deployment del proxy API tramite la UI Edge o l'API di gestione Edge non riesce e viene visualizzato questo messaggio di errore:

Error Deploying Revision revision_number to environment
Invalid cache resource reference [cache_resource] in Step definition [invalidate_cache_policy_name]. Context Revision:[revision_number];APIProxy:[apiproxy_name];Organization:[organization];Environment:[environment]

Esempio di messaggio di errore

Error Deploying Revision 2 to test
Invalid cache resource reference tokencache in Step definition InvalidateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test

Screenshot di esempio dell'errore

Causa

Questo errore si verifica se l'elemento <CacheResource> nel criterio InvalidateCache è impostato su un nome che non esiste nell'ambiente in cui viene eseguito il deployment del proxy API.

Diagnosi

  1. Identifica il nome del criterio InvalidateCache, la cache non valida utilizzata nell'elemento <CacheResource> del criterio InvalidateCache e l'ambiente in cui si è verificato l'errore. Puoi trovare tutti questi elementi nel messaggio di errore. Ad esempio, nel seguente errore, il nome della policy InvalidateCache è InvalidateCache-Token, il nome della cache non valida è tokencache e il nome dell'ambiente è test.

    Invalid cache resource reference tokencache in Step definition InvalidateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test

  2. Esamina il file XML della policy InvalidateCache non riuscita e verifica se il nome della cache specificato per l'elemento <CacheResource> corrisponde al messaggio di errore.

    In questo esempio, il nome della cache specificato nell'elemento <CacheResource> è tokencache:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<InvalidateCache async="false" continueOnError="false" enabled="true" name="InvalidateCache-Token">
    <DisplayName>InvalidateCache-Token</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref=""/>
    </CacheKey>
    <CacheResource>tokencache</CacheResource>
    <Scope>Exclusive</Scope>
    <CacheContext>
        <APIProxyName/>
        <ProxyName>default</ProxyName>
        <TargetName>default</TargetName>
    </CacheContext>
    <PurgeChildEntries>false</PurgeChildEntries>
</InvalidateCache>

  3. Verifica se la cache (determinata nel passaggio 1) è stata definita nell'ambiente specifico (identificato nel passaggio 1).

    Nell'interfaccia utente Edge, vai a ADMIN > Environment > test e verifica se la cache esiste nella scheda Cache di Configurazione dell'ambiente. Se la cache non esiste, è questa la causa dell'errore.

    Ad esempio, nello screenshot riportato di seguito nota che la cache denominata tokencache non esiste.

    Poiché la cache denominata tokencache non è definita nell'ambiente test, viene visualizzato l'errore:

    Invalid cache resource reference tokencache in Step definition InvalidateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test

Risoluzione

Assicurati che la cache specificata nell'elemento <CacheResource> del criterio InvalidateCache sia stata creata nell'ambiente in cui vuoi eseguire il deployment del proxy API.

Per informazioni su come creare la cache, consulta Creazione e modifica di una cache dell'ambiente.

CacheNotFound

Messaggio di errore

Il deployment del proxy API tramite la UI di Edge o l'API di gestione Edge genera un messaggio di errore simile a questo e lo stato di deployment del proxy API viene contrassegnato come parzialmente eseguito:

Error: Cache : cache_resource, not found in organization : organization__environment.

Esempio di messaggio di errore

Error Cache : configCache, not found in organization : kkalckstein-eval__test

Causa

Questo errore si verifica se la cache specifica menzionata nel messaggio di errore non è stata creata in un componente specifico del processore di messaggi. Un processore di messaggi è un componente interno di Edge che elabora il flusso di traffico API tramite Apigee Edge.

Risoluzione

Se sei un utente di Private Cloud, segui le istruzioni riportate di seguito:

  1. Elenca i deployment del proxy API e determina quali processori di messaggi hanno l'errore steps.cache.CacheNotFound.

    curl -u $USERID:$USERPASSWORD http://:8080/v1/organizations//environments//apis//revisions//deployments

    Output di esempio

      {
    "aPIProxy" : "TestCache",
    "environment" : [ {
      "configuration" : {
        "basePath" : "/",
        "configVersion" : "SHA-512:45d3f39783414d3859bf2dec4135d8f5f9960ee6b2d361db2799c82693a8e3f8b95dbbb37c547eb3c0a3819d8ca51727f390502bcaefdf1f113263521a9023b6",
        "steps" : [ ]
      },
      "name" : "prod",
      "server" : [ {
        "pod" : {
          "name" : "pod1",
          "region" : "us-central1"
        },
        "status" : "deployed",
        "type" : [ "message-processor" ],
        "uUID" : "f2e5e34a-5630-43a9-8fef-48a5b9da76d1"
      }, {
        "pod" : {
          "name" : "pod1",
          "region" : "us-central1"
        },
        "status" : "deployed",
        "type" : [ "message-processor" ],
        "uUID" : "879a6538-a5e0-4503-b142-9cb2b4e0623d"
      }, {
      "error" : "Cache : configCache, not found in organization : kkalckstein-eval__test",
      "errorCode" : "steps.cache.CacheNotFound",
      "status" : "error",
      "type" : [ "message-processor" ],
       "uUID" : "a8f9ce0b-c32d-48a9-b26c-9c75d8bf467d"
  },
  ...
      "state" : "deployed"
    } ],
    "name" : "2",
    "organization" : "kkalckstein-eval"
    ...

  2. Prendi nota degli UUID del processore di messaggi in cui osservi l'errore steps.cache.CacheNotFound. Identifica il nome host/l'indirizzo IP del processore di messaggi corrispondente all'UUID.

  3. Accedi al processore di messaggi specifico e riavvialo utilizzando il seguente comando:

    apigee-service edge-message-processor restart

Se sei un utente di Public Cloud o se il problema persiste per Private Cloud, contatta l'assistenza Apigee per ricevere aiuto.