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

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

InvalidTimeout

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

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

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

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

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

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

Причина

Если элемент <CacheLookupTimeoutInSeconds> правила LookupCache имеет отрицательное значение, развертывание прокси-сервера API завершится неудачно.

Например, если элемент <CacheLookupTimeoutInSeconds> имеет значение -1, развертывание прокси-сервера API завершится неудачно.

диагностика;

  1. Определите недопустимое значение, указанное для элемента <CacheLookupTimeoutInSeconds> в правиле LookupCache. Эта информация есть в сообщении об ошибке. Например, в приведенной ниже ошибке недопустимое значение элемента <CacheLookupTimeoutInSeconds> – -1:

    CacheLookupTimeoutInSeconds -1 value should be greater than zero.

  2. Проверьте все правила LookupCache в определенном прокси API, где произошел сбой. Может быть одно или несколько правил LookupCache, в которых указан элемент <CacheLookupTimeoutInSeconds>. Определите правило LookUpCache, в котором для элемента <CacheLookupTimeoutInSeconds> указано недействительное значение (определенное на шаге 1 выше).

    Например, в приведенной ниже конфигурации правил указано значение <CacheLookupTimeoutInSeconds> для -1, которое соответствует сообщению об ошибке:

    <?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. Если <CacheLookupTimeoutInSeconds> указано как отрицательное целое число, это и будет причиной ошибки.

Разрешение

Убедитесь, что значение элемента <CacheLookupTimeoutInSeconds> правила LookupCache всегда задано как неотрицательное целое число.

Чтобы исправить пример политики LookupCache, приведенный выше, можно изменить элемент <CacheLookupTimeoutInSeconds> на 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

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

Развертывание прокси-сервера 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:ResponseCache;Organization:[organization];Environment:[environment]

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

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

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

Причина

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

диагностика;

  1. Определите недопустимый кеш, используемый в элементе <CacheResource> правила LookupCache, и среду, в которой произошла ошибка. Оба этих элемента можно найти в сообщении об ошибке. Например, в приведенной ниже ошибке название недопустимого кеша – tokencache, а название среды – test.

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

  2. Проверьте все правила LookupCache в определенном прокси API, где произошел сбой. Определите, в каких правилах LookupCache в элементе <CacheResource> указан недействительный кеш (определенный на шаге 1).

    Например, в следующем правиле значение параметра <CacheResource> указано как tokencache, что соответствует сообщению об ошибке:

    <?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. Проверьте, определен ли кеш (определенный на шаге 1) в определенной среде (определенной на шаге 1).

    В интерфейсе Edge перейдите в раздел ADMIN > Environment > test (Администратор > Среда > тест) и проверьте, есть ли кеш на вкладке Caches (Кеши) в разделе Environment Configuration (Конфигурация среды). Если кеша нет, то в этом и заключается причина ошибки.

    Например, на скриншоте ниже видно, что кеш с названием tokencache не существует.

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

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

Разрешение

Убедитесь, что название кеша, указанное в элементе <CacheResource>, создано в среде, в которой вы хотите развернуть прокси-сервер 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

Причина

Эта ошибка возникает, если упомянутый в сообщении об ошибке кеш не был создан в определенном компоненте Message Processor.

Разрешение

Если вы используете частное облако, выполните следующие действия:

  1. Перечислите развертывания прокси-сервера API и определите, какие Message Processor выдают ошибку 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-адрес Message Processor, связанного с UUID.

  3. Войдите в нужный Message Processor и перезапустите его с помощью следующей команды:

    apigee-service edge-message-processor restart

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