Устранение ошибок при развертывании политики кэширования заполнения

Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee
X.info

InvalidCacheResourceReference

Сообщение об ошибке

Развертывание API-прокси через пользовательский интерфейс Edge или API управления Edge завершается с ошибкой, о которой сообщается ниже:

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]

Пример сообщения об ошибке

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

Пример скриншота ошибки

Причина

Эта ошибка возникает, если элементу <CacheResource> в политике PopulateCache присвоено имя, которого не существует в среде, где развертывается API-прокси.

Диагноз

  1. Укажите имя политики PopulateCache, недействительный кэш, используемый в элементе <CacheResource> политики, и среду, в которой произошла ошибка. Все эти данные можно найти в сообщении об ошибке. Например, в следующем сообщении об ошибке имя политики PopulateCache — PopulateCache-Token , имя недействительного кэша — tokencache , а имя среды — test .

    Invalid cache resource reference tokencache in Step definition PopulateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
    
  2. Изучите XML-файл политики PopulateCache, в котором произошла ошибка, и убедитесь, что имя кэша, указанное для элемента <CacheResource> соответствует сообщению об ошибке.

    В этом примере имя кэша, указанное в элементе <CacheResource> , — 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. Проверьте, определен ли кэш (настроенный на шаге №1) в конкретной среде (указанной на шаге №1).

    В пользовательском интерфейсе Edge перейдите в раздел АДМИНИСТРИРОВАНИЕ > Окружение > Тест и проверьте, существует ли кэш на вкладке «Кэши» в разделе «Конфигурация среды» . Если кэш отсутствует, то это и является причиной ошибки.

    Например, обратите внимание на скриншот ниже: кэш с именем tokencache не существует.

    Поскольку кэш с именем tokencache не определен в test среде, возникает ошибка:

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

Разрешение

Убедитесь, что кэш, указанный в элементе <CacheResource> политики PopulateCache, создан в среде, где вы хотите развернуть API-прокси.

Для получения информации о создании кэша обратитесь к разделу «Создание и редактирование кэша среды» .

CacheNotFound

Сообщение об ошибке

При развертывании API-прокси через пользовательский интерфейс Edge или API управления Edge появляется сообщение об ошибке, подобное этому, а статус развертывания API-прокси помечается как частично развернутый:

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

Пример сообщения об ошибке

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

Причина

Эта ошибка возникает, если указанный в сообщении об ошибке кэш не был создан для конкретного компонента обработчика сообщений. Обработчик сообщений — это внутренний компонент Edge, который обрабатывает поток API-трафика через Apigee Edge.

Разрешение

Если вы используете частное облако , пожалуйста, следуйте приведенным ниже инструкциям:

  1. Перечислите развертывания API-прокси и определите, какие обработчики сообщений имеют ошибку steps.cache.CacheNotFound .

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

    Пример выходных данных

      {
        "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. Запишите UUID(-а) обработчика сообщений, в котором вы наблюдаете ошибку steps.cache.CacheNotFound . Определите имя хоста/IP-адрес обработчика сообщений, соответствующего этому UUID.

  3. Войдите в систему конкретного обработчика сообщений и перезапустите его, используя следующую команду:

    apigee-service edge-message-processor restart

Если вы используете публичное облако или если проблема сохраняется в частном облаке , обратитесь за помощью в службу поддержки Apigee .