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

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X. info

InvalidCacheResourceReference

Komunikat o błędzie

Wdrożenie serwera proxy interfejsu API za pomocą interfejsu Edge lub interfejsu 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:[apiproxy_name];Organization:[organization];Environment:[environment]

Przykładowy komunikat o błędzie

Error Deploying Revision 2 to test
Invalid cache resource reference tokencache in Step definition PopulateCache-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> w zasadzie PopulateCache jest ustawiony na nazwę, która nie istnieje w środowisku, w którym wdrażany jest serwer proxy interfejsu API.

Diagnostyka

  1. Określ nazwę zasady PopulateCache, nieprawidłową pamięć podręczną używaną w elemencie <CacheResource> zasady oraz środowisko, w którym wystąpił błąd. Wszystkie te elementy znajdziesz w komunikacie o błędzie. Na przykład w tym błędzie nazwa zasady PopulateCache to PopulateCache-Token, nazwa nieprawidłowej pamięci podręcznej to tokencache, a nazwa środowiska to test.

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

  2. Sprawdź kod XML zasady PopulateCache, która nie powiodła się, i sprawdź, czy nazwa pamięci podręcznej określona w elemencie <CacheResource> jest zgodna z komunikatem o błędzie.

    W tym przykładzie nazwa pamięci podręcznej określona w elemencie <CacheResource> to tokencache:

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

  3. Sprawdź, czy pamięć podręczna (określona w kroku 1) została zdefiniowana w konkretnym środowisku (określonym w kroku 1).

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

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

    Ponieważ pamięć podręczna o nazwie tokencache nie jest zdefiniowana w środowisku test, wyświetla się ten błąd:

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

Rozdzielczość

Upewnij się, że pamięć podręczna określona w elemencie <CacheResource> zasady PopulateCache została utworzona w środowisku, w którym chcesz wdrożyć serwer proxy interfejsu API.

Informacje o tym, jak utworzyć pamięć podręczną, znajdziesz w artykule Tworzenie i edytowanie pamięci podręcznej środowiska.

CacheNotFound

Komunikat o błędzie

Wdrożenie serwera proxy interfejsu API za pomocą interfejsu Edge lub interfejsu Edge Management API powoduje wyświetlenie komunikatu o błędzie podobnego do tego, 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 konkretna pamięć podręczna wymieniona w komunikacie o błędzie nie została utworzona w konkretnym komponencie procesora komunikatów. Procesor komunikatów to wewnętrzny komponent Edge, który przetwarza przepływ ruchu API przez Apigee Edge.

Rozdzielczość

Jeśli jesteś użytkownikiem chmury prywatnej, postępuj zgodnie z instrukcjami poniżej:

  1. Wyświetl listę wdrożeń serwera proxy interfejsu API i sprawdź, które procesory wiadomości mają 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 procesorów wiadomości, w których występuje błąd steps.cache.CacheNotFound. Określ nazwę hosta lub adres IP procesora komunikatów odpowiadający identyfikatorowi UUID.

  3. Zaloguj się do konkretnego procesora komunikatów i uruchom go ponownie za pomocą tego polecenia:

    apigee-service edge-message-processor restart

Jeśli jesteś użytkownikiem chmury publicznej lub jeśli problem nadal występuje w chmurze prywatnej, skontaktuj się z zespołem pomocy Apigee.