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

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

Инвалидкачересаурцеференсе

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

Развертывание прокси-сервера 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 перейдите в раздел «ADMIN» > «Среда» > «тест» и проверьте, существует ли кеш на вкладке «Кэши » в разделе «Конфигурация среды» . Если кэша нет, то это и есть причина ошибки.

    Например, обратите внимание на скриншоте ниже, что кэша с именем 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.

Дополнительную информацию о том, как создать кэш, см. в разделе Создание и редактирование кэша среды .

Кэш не найден

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

Развертывание прокси-сервера 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 .