填入快取政策部署錯誤的問題

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

InvalidCacheResourceReference

錯誤訊息

透過 Edge UI 或 Edge 管理 API 部署 API Proxy 時失敗，並顯示以下錯誤訊息：

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

錯誤螢幕截圖範例

原因

如果 PopulateCache 政策中的 <CacheResource> 元素設為 API Proxy 部署環境中不存在的名稱，就會發生這個錯誤。

診斷

  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. 檢查失敗的 PopulateCache 政策 XML，並確認為 <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 UI 中，依序前往「ADMIN」>「Environment」>「test」，然後檢查「Environment Configuration」的「Caches」分頁中是否有快取。如果快取不存在，就是錯誤原因。

    舉例來說，請注意下方的螢幕截圖，名為 tokencache 的快取不存在。

    由於 test 環境中未定義名為 tokencache 的快取，因此您會收到以下錯誤訊息：

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

解析度

請確認您已在要部署 API Proxy 的環境中，建立 PopulateCache 政策 <CacheResource> 元素指定的快取。

如要瞭解如何建立快取，請參閱「建立及編輯環境快取」。

CacheNotFound

錯誤訊息

透過 Edge UI 或 Edge 管理 API 部署 API Proxy 時，會產生類似這樣的錯誤訊息，且 API Proxy 的部署狀態會標示為部分部署：

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

錯誤訊息範例

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

原因

如果錯誤訊息中提及的特定快取未在特定訊息處理器元件上建立，就會發生這個錯誤。訊息處理器是 Edge 內部元件，負責處理透過 Apigee Edge 的 API 流量。

解析度

如果您是 Private Cloud 使用者，請按照下列指示操作：

  1. 列出 API Proxy 部署作業，並判斷哪些訊息處理器發生 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. 記下發生錯誤的 Message Processor UUID steps.cache.CacheNotFound。找出與 UUID 相對應的訊息處理器主機名稱/IP 位址。

  3. 登入特定訊息處理器，然後使用下列指令重新啟動：

    apigee-service edge-message-processor restart

如果您是 Public Cloud 使用者，或是 Private Cloud 的問題持續發生，請與 Apigee 支援團隊聯絡，尋求相關協助。