การแก้ปัญหาข้อผิดพลาดในการทำให้นโยบายแคชใช้งานไม่ได้

คุณกำลังดูเอกสารประกอบ Apigee Edge
ไปที่ เอกสารประกอบเกี่ยวกับ Apigee X.
ข้อมูล

InvalidCacheResourceReference

ข้อความแสดงข้อผิดพลาด

การทำให้พร็อกซี API ใช้งานได้ผ่าน Edge UI หรือ Edge Management API จะล้มเหลวโดยมีข้อความแสดงข้อผิดพลาดต่อไปนี้

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

ตัวอย่างภาพหน้าจอแสดงข้อผิดพลาด

สาเหตุ

ข้อผิดพลาดนี้เกิดขึ้นหากมีการตั้งค่าองค์ประกอบ <CacheResource> ในนโยบาย ExampleateCache เป็นชื่อที่ไม่มีอยู่ในสภาพแวดล้อมที่ทำให้พร็อกซี API ใช้งานได้

การวินิจฉัย

  1. ระบุชื่อนโยบาย invalidateCache, แคชที่ไม่ถูกต้องที่ใช้ในองค์ประกอบ <CacheResource> ของนโยบาย invalidateCache และสภาพแวดล้อมที่เกิดข้อผิดพลาดขึ้น คุณสามารถดูรายการเหล่านี้ทั้งหมดได้ในข้อความแสดงข้อผิดพลาด ตัวอย่างเช่น ในข้อผิดพลาดต่อไปนี้ ชื่อนโยบาย 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. ตรวจสอบ XML ของนโยบาย "DefaultateCache" ที่ล้มเหลว และยืนยันว่าชื่อแคชที่ระบุสำหรับองค์ประกอบ <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 ให้ไปที่ ผู้ดูแลระบบ > สภาพแวดล้อม > ทดสอบและตรวจสอบว่ามีแคชอยู่ในแท็บแคชของการกำหนดค่าสภาพแวดล้อมหรือไม่ หากไม่มีแคชอยู่ แสดงว่าเกิดข้อผิดพลาด

    เช่น โปรดสังเกตในภาพหน้าจอด้านล่างว่าไม่มีแคชชื่อ tokencache อยู่

    เนื่องจากไม่มีการระบุแคชชื่อ tokencache ไว้ในสภาพแวดล้อม test คุณจึงได้รับข้อผิดพลาด

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

ความละเอียด

ตรวจสอบว่าได้สร้างแคชที่ระบุในเอลิเมนต์ <CacheResource> ของนโยบาย invalidateCache ในสภาพแวดล้อมที่คุณต้องการทำให้พร็อกซี API ใช้งานได้

โปรดดูข้อมูลเกี่ยวกับวิธีสร้างแคชในการสร้างและแก้ไขแคชของสภาพแวดล้อม

CacheNotFound

ข้อความแสดงข้อผิดพลาด

การทำให้พร็อกซี API ใช้งานได้ผ่าน Edge UI หรือ Edge Management API จะแสดงข้อความแสดงข้อผิดพลาดดังนี้ และสถานะการติดตั้งใช้งานของพร็อกซี 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

ความละเอียด

หากคุณเป็นผู้ใช้ Private Cloud โปรดทำตามวิธีการด้านล่าง

  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. เข้าสู่ระบบ Message Processor ที่ต้องการ และรีสตาร์ทโดยใช้คำสั่งต่อไปนี้:

    apigee-service edge-message-processor restart

หากคุณเป็นผู้ใช้ Public Cloud หรือหากยังคงพบปัญหาสําหรับ Private Cloud โปรดติดต่อทีมสนับสนุนของ Apigee เพื่อขอความช่วยเหลือ