Rozwiązywanie problemów związanych z błędem wdrożenia zasady pamięci podręcznej wyszukiwania

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X. informacje.

InvalidTimeout

Komunikat o błędzie

Wdrożenie serwera proxy interfejsu API przy użyciu interfejsu Edge UI lub Edge Management API nie powiedzie się i wyświetli się ten komunikat o błędzie:

Error Saving Revision revision_number
CacheLookupTimeoutInSeconds value value should be greater than zero.

Przykładowy komunikat o błędzie

Error Saving Revision 2
CacheLookupTimeoutInSeconds -1 value should be greater than zero.

Przykładowy zrzut ekranu z błędem

Przyczyna

Jeśli element <CacheLookupTimeoutInSeconds> zasady wyszukiwania pamięci podręcznej ma wartość ujemną, wdrożenie serwera proxy interfejsu API się nie uda.

Jeśli na przykład element <CacheLookupTimeoutInSeconds> to -1, wdrożenie serwera proxy interfejsu API się nie uda.

Diagnostyka

1. Znajdź nieprawidłową wartość podaną w elemencie <CacheLookupTimeoutInSeconds> w zasadzie wyszukiwania pamięci podręcznej. Te informacje znajdziesz w komunikacie o błędzie. Na przykład w tym błędzie nieprawidłowa wartość użyta w elemencie <CacheLookupTimeoutInSeconds> to -1:

   CacheLookupTimeoutInSeconds -1 value should be greater than zero.
   

2. Sprawdź wszystkie zasady lookupCache na konkretnym serwerze proxy interfejsu API, na którym wystąpił błąd. Element <CacheLookupTimeoutInSeconds> może zawierać co najmniej 1 zasadę lookupCache. Zidentyfikuj zasadę LookUpCache, w której dla elementu <CacheLookupTimeoutInSeconds> określono nieprawidłową wartość (wskazaną w kroku 1).

   Na przykład ta konfiguracja zasady określa wartość <CacheLookupTimeoutInSeconds> atrybutu -1, która jest zgodna z komunikatem o błędzie:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
       <DisplayName>LookupCache-Token</DisplayName>
       <Properties/>
       <CacheKey>
           <Prefix/>
           <KeyFragment ref="request.queryparam.client_id"/>
       </CacheKey>
       <CacheLookupTimeoutInSeconds>-1</CacheLookupTimeoutInSeconds>
       <Scope>Exclusive</Scope>
       <ExpirySettings>
           <TimeoutInSec>3600</TimeoutInSec>
       </ExpirySettings>
       <AssignTo>usertoken</AssignTo>
   </LookupCache>
   

3. Jeśli parametr <CacheLookupTimeoutInSeconds> jest określony jako ujemna liczba całkowita, to jest przyczyną błędu.

Rozdzielczość

Upewnij się, że wartość elementu <CacheLookupTimeoutInSeconds> zasady lookupCache jest zawsze określana jako nieujemna liczba całkowita.

Aby poprawić przykładową zasadę lookupCache widoczną powyżej, możesz zmodyfikować element <CacheLookupTimeoutInSeconds> na 30.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
    <DisplayName>LookupCache-Token</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.queryparam.client_id"/>
    </CacheKey>
    <CacheResource>tokencache</CacheResource>
    <CacheLookupTimeoutInSeconds>30</CacheLookupTimeoutInSeconds>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <TimeoutInSec>3600</TimeoutInSec>
    </ExpirySettings>
    <AssignTo>usertoken</AssignTo>
</LookupCache>

InvalidCacheResourceReference

Komunikat o błędzie

Wdrożenie serwera proxy interfejsu API przy użyciu interfejsu Edge UI lub Edge Management API nie powiedzie się i wyświetli się ten komunikat o błędzie:

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

Przykładowy komunikat o błędzie

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

Przykładowy zrzut ekranu z błędem

Przyczyna

Ten błąd występuje, jeśli element <CacheResource> ma nazwę, która nie istnieje w środowisku, w którym wdrażany jest serwer proxy interfejsu API.

Diagnostyka

1. Zidentyfikuj nieprawidłową pamięć podręczną w elemencie <CacheResource> zasady wyszukiwania pamięci podręcznej oraz w środowisku, w którym wystąpił błąd. Oba te elementy znajdziesz w komunikacie o błędzie. Na przykład w tym błędzie nazwa nieprawidłowej pamięci podręcznej to tokencache, a nazwa środowiska to test.

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

2. Sprawdź wszystkie zasady lookupCache na konkretnym serwerze proxy interfejsu API, na którym wystąpił błąd. Zidentyfikuj konkretną zasadę lookupCache, w której określona jest nieprawidłowa pamięć podręczna (podana w kroku 1) w elemencie <CacheResource>.

   Na przykład ta zasada określa wartość <CacheResource> jako tokencache, która jest zgodna z komunikatem o błędzie:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
       <DisplayName>LookupCache-Token</DisplayName>
       <Properties/>
       <CacheKey>
           <Prefix/>
           <KeyFragment ref="request.queryparam.client_id"/>
       </CacheKey>
       <CacheResource>tokencache</CacheResource>
       <CacheLookupTimeoutInSeconds/>
       <Scope>Exclusive</Scope>
       <ExpirySettings>
           <TimeoutInSec>3600</TimeoutInSec>
       </ExpirySettings>
       <AssignTo>usertoken</AssignTo>
   </LookupCache>
   

3. Sprawdź, czy pamięć podręczna (określona w kroku 1) jest zdefiniowana w konkretnym środowisku (określone w kroku 1).

   W interfejsie Edge otwórz ADMINISTRACJA > Środowisko > test i sprawdź, czy pamięć podręczna jest dostępna na karcie Pamięci podręczne w sekcji Konfiguracja środowiska. Jeśli pamięć podręczna nie istnieje, to jest przyczyną błędu.

   Na przykład na zrzucie ekranu poniżej zwróć uwagę, że pamięć podręczna o nazwie tokencache nie istnieje.

   

   Pamięć podręczna o nazwie tokencache nie jest zdefiniowana w środowisku test, dlatego pojawia się błąd:

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

Rozdzielczość

Sprawdź, czy nazwa pamięci podręcznej określona w elemencie <CacheResource> została utworzona w środowisku, w którym chcesz wdrożyć serwer proxy interfejsu API.

Więcej informacji o tworzeniu pamięci podręcznej znajdziesz w artykule Tworzenie i edytowanie pamięci podręcznej środowiska.

CacheNotFound

Komunikat o błędzie

Wdrożenie serwera proxy interfejsu API przy użyciu interfejsu Edge lub Edge Management API powoduje wyświetlenie takiego komunikatu o błędzie, a stan wdrożenia serwera proxy interfejsu API jest oznaczony jako częściowo wdrożony:

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

Przykładowy komunikat o błędzie

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

Przyczyna

Ten błąd występuje, jeśli pamięć podręczna wspomniana w komunikacie o błędzie nie została utworzona w konkretnym komponencie procesora wiadomości.

Rozdzielczość

Jeśli jesteś użytkownikiem Private Cloud, wykonaj te instrukcje:

1. Wyświetl listę wdrożeń proxy interfejsu API i określ, w których procesorach wiadomości występuje błąd steps.cache.CacheNotFound.

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

   Przykładowe dane wyjściowe

   {
     "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. Zanotuj identyfikatory UUID procesora wiadomości, w których występuje błąd steps.cache.CacheNotFound. Określ nazwę hosta/adres IP procesora wiadomości powiązanego z identyfikatorem UUID.

3. Zaloguj się w określonym procesorze wiadomości i uruchom go ponownie za pomocą następującego polecenia:

   apigee-service edge-message-processor restart

Jeśli korzystasz z usługi Public Cloud lub jeśli problem z Private Cloud nie ustąpi, skontaktuj się z zespołem pomocy Apigee.