撤銷快取政策部署錯誤疑難排解

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件
資訊

InvalidCacheResourceReference

錯誤訊息

透過 Edge UI 或 Edge Management API 部署 API Proxy 會失敗,並顯示以下錯誤訊息:

Error Deploying Revision revision_number to environment
Invalid cache resource reference [cache_resource] in Step definition [invalidate_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 InvalidateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test

錯誤螢幕截圖

原因

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

診斷

  1. 找出 InvalidateCache 政策名稱、InvalidateCache 政策 <CacheResource> 元素中使用的無效快取,以及發生錯誤的環境。您可以在錯誤訊息中找到以上所有項目。例如,在下列錯誤中,InvalidateCache 政策名稱為 InvalidateCache-Token,無效快取的名稱為 tokencache,環境名稱為 test

    Invalid cache resource reference tokencache in Step definition InvalidateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
    
  2. 檢查失敗的 InvalidateCache 政策 XML,並確認針對 <CacheResource> 元素指定的快取名稱是否與錯誤訊息相符。

    在這個範例中,<CacheResource> 元素中指定的快取名稱為 tokencache

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <InvalidateCache async="false" continueOnError="false" enabled="true" name="InvalidateCache-Token">
        <DisplayName>InvalidateCache-Token</DisplayName>
        <Properties/>
        <CacheKey>
            <Prefix/>
            <KeyFragment ref=""/>
        </CacheKey>
        <CacheResource>tokencache</CacheResource>
        <Scope>Exclusive</Scope>
        <CacheContext>
            <APIProxyName/>
            <ProxyName>default</ProxyName>
            <TargetName>default</TargetName>
        </CacheContext>
        <PurgeChildEntries>false</PurgeChildEntries>
    </InvalidateCache>
    
  3. 確認是否已在特定環境中定義快取 (依步驟 1 所述) 是否已定義於特定環境 (如步驟 1 所示)。

    在 Edge UI 中,依序前往「Admin」>環境 >測試,並檢查快取是否存在環境設定快取分頁中。如果快取不存在,就是導致錯誤的原因。

    例如,請注意下方螢幕截圖中名為 tokencache 的快取不存在。

    由於 test 環境中並未定義名為 tokencache 的快取,因此您會收到錯誤訊息:

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

解析度

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

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

CacheNotFound

錯誤訊息

透過 Edge UI 或 Edge Management 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

原因

如果錯誤訊息提及的特定快取並未在特定的訊息處理器元件中建立,就會發生這個錯誤。訊息處理器是一種內部邊緣元件,用於透過 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. 記下訊息處理者的 UUID,您在其中觀察到錯誤 steps.cache.CacheNotFound。找出與 UUID 對應的訊息處理器主機名稱/IP 位址。

  3. 登入特定訊息處理器,並使用下列指令重新啟動:

    apigee-service edge-message-processor restart

如果您是公有雲使用者,或 Private Cloud 問題仍未解決,請向 Apigee 支援團隊尋求協助。