تحديد المشاكل وحلّها في ما يتعلّق بنشر سياسة ذاكرة التخزين المؤقت

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

InvalidCacheResourceReference

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم 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> في سياسة InvalidateCache على اسم غير متوفّر في البيئة التي يتم نشر خادم 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 الخاص بسياسة 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. تأكَّد مما إذا تم تحديد ذاكرة التخزين المؤقت (التي تم تحديدها في الخطوة 1) في البيئة المحدّدة (التي تم تحديدها في الخطوة 1).

    في واجهة مستخدم 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

رسالة الخطأ

يؤدي نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge إلى ظهور رسالة خطأ على النحو التالي، ويتم وضع علامة "تم النشر جزئيًا" على حالة نشر خادم وكيل لواجهة برمجة التطبيقات:

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 للحصول على المساعدة.