عیب‌یابی خطای استقرار خط‌مشی «نامعتبر کردن حافظه نهان»

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

InvalidCacheResourceReference

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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> در خط‌مشی «نامعتبر کردن حافظه نهان» روی نامی تنظیم شده باشد که در محیطی که پراکسی API در آن مستقر می‌شود وجود ندارد.

تشخیص

  1. نام خط‌مشی InvalidCache، حافظه نهان نامعتبر استفاده‌شده در عنصر <CacheResource> خط‌مشی InvalidCache، و محیطی که خطا در آن رخ داده است را شناسایی کنید. می‌توانید همه این موارد را در پیام خطا پیدا کنید. برای مثال، در خطای زیر، نام خط‌مشی 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 را بررسی کنید و مطمئن شوید نام حافظه نهان مشخص‌شده برای عنصر <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. بررسی کنید که آیا حافظه نهان (تعیین‌شده در مرحله #۱) در محیط خاص (شناسایی‌شده در مرحله #۱) تعریف شده است یا نه.

    در «میانای کاربری Edge»، به ADMIN > Environment > test پیمایش کنید و بررسی کنید که آیا حافظه نهان در برگه Caches از Environment Configuration وجود دارد یا نه. اگر حافظه نهان وجود نداشته باشد، دلیل خطا همین است.

    برای مثال، در نماگرفت زیر توجه کنید که حافظه نهان با نام 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 مشخص شده است در محیطی که می‌خواهید پراکسی میانای برنامه‌سازی کاربردی را در آن مستقر کنید ایجاد شده باشد.

برای اطلاعات بیشتر درباره نحوه ایجاد حافظه نهان، به ایجاد و ویرایش حافظه نهان محیط مراجعه کنید.

CacheNotFound

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» منجر به پیام خطایی مانند این می‌شود و وضعیت استقرار «پراکسی API» به‌عنوان «استقرار جزئی» علامت‌گذاری می‌شود:

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

نمونه پیام خطا

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

علت

این خطا زمانی رخ می‌دهد که حافظه نهان خاص ذکرشده در پیام خطا در یک جزء «پردازشگر پیام» خاص ایجاد نشده باشد. «پردازشگر پیام» یکی از اجزای داخلی Edge است که جریان ترافیک «میانای برنامه‌سازی کاربردی» را ازطریق Apigee Edge پردازش می‌کند.

وضوح

اگر کاربر ابر خصوصی هستید، لطفاً دستورالعمل‌های زیر را دنبال کنید:

  1. فهرست استقرار پراکسی «میانای برنامه‌سازی کاربردی» را تهیه کنید و مشخص کنید کدام «پردازنده‌های پیام» خطای 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 تماس بگیرید.