פתרון בעיות בפריסת מדיניות של PythonScript

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

האם מדריך פתרון הבעיות הזה עזר לך? נשמח לקבל משוב בלחיצה על שליחת משוב .

InvalidResourceUrlFormat

הודעת השגיאה

פריסת proxy ל-API דרך ממשק המשתמש או ה-API של Apigee נכשלת ומוצגת הודעת השגיאה הבאה:

Error Deploying Revision revision_number to environment
Invalid resource url format. Resource url is invalid_URL.

הודעת שגיאה לדוגמה

Error Deploying Revision 2 to prod
Invalid resource url format. Resource url is py:myscript.py.

דוגמה לצילום מסך

מטרה

אם הפורמט של כתובת ה-URL של המשאב שצוינה ברכיב <ResourceURL> או ברכיב <IncludeURL> של מדיניות PythonScript לא תקין, פריסת proxy ל-API תיכשל.

הפורמט הנכון הוא כמו שמוצג בהמשך:

<ResourceURL>py://file_name.py</ResourceURL>
<IncludeURL>py://file_name.py</IncludeURL>

לדוגמה, אם הרכיב <ResourceURL> מצוין כמו בדוגמה שלמטה, הפריסה של proxy ל-API נכשלת כי הוא לא עומד בדרישות התבנית:

<ResourceURL>py:myscript.py</ResourceURL>

אבחון

1. מזהים את הפורמט הלא תקין של כתובת ה-URL של המשאב שנעשה בו שימוש במדיניות PythonScript. המידע הזה מופיע בהודעת השגיאה. לדוגמה, בשגיאה הבאה, פורמט כתובת ה-URL של המשאב לא תקין: py:myscript.py:

   Invalid resource url format. Resource url is py:myscript.py.

2. בודקים את כל כללי המדיניות של PythonScript ב-API Proxy הספציפי שבו התרחשה הכשל. אם יש מדיניות PythonScript שבה כתובת ה-URL של המשאב שצוינה ברכיב <ResourceURL> או ברכיב <IncludeURL> תואמת לרשומה הלא תקינה שזוהתה בשלב 1 למעלה, אז זו הסיבה לשגיאה.

   לדוגמה, במדיניות הבאה כתובת ה-URL של המשאב היא py:myscript.py, שזהה לכתובת שמופיעה בהודעת השגיאה:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <Script async="false" continueOnError="false" enabled="true" timeLimit="200" name="py-TotalVariable">
       <DisplayName>py-TotalVariable</DisplayName>
       <Properties/>
       <ResourceURL>py:myscript.py</ResourceURL>
   </Script>

   מכיוון שכתובת ה-URL של המשאב מוגדרת כ-py:myscript.py, שהיא לא תקינה, הפריסה של שרת ה-API Proxy נכשלת עם השגיאה:

   Invalid resource url format. Resource url is py:myscript.py.

רזולוציה

מוודאים שפורמט כתובת ה-URL של המשאב שצוין ברכיב <ResourceURL> של מדיניות PythonScript תקין. לדוגמה:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Script async="false" continueOnError="false" enabled="true" timeLimit="200" name="py-TotalVariable">
    <DisplayName>py-TotalVariable</DisplayName>
    <Properties/>
    <ResourceURL>py://myscript.py</ResourceURL>
</Script>

InvalidResourceUrlReference

הודעת השגיאה

פריסת proxy ל-API דרך ממשק המשתמש או ה-API של Apigee נכשלת ומוצגת הודעת השגיאה הבאה:

Error Deploying Revision revision_number to environment
Invalid resource url ref invalid_reference in policy policy_name in org_name

הודעת שגיאה לדוגמה

Error Deploying Revision 2 to prod
Invalid resource url ref py://myscript.py in policy Python_script in myorg

דוגמה לצילום מסך

מטרה

אם הרכיבים <ResourceURL> ו-<IncludeURL> מפנים לקובץ PythonScript שלא קיים, הפריסה של proxy ל-API תיכשל. אם אתם פורסים חבילת proxy ל-API מהמחשב המקומי, קובצי המקור של PythonScript צריכים להיות מאוחסנים בתיקייה /apiproxy/resources/py(בטווח של proxy ל-API).

בממשק המשתמש של Apigee, קובצי המקור של PythonScript מופיעים בקטע Scripts (סקריפטים) בחלונית Navigator (ניווט) של עורך ה-proxy ל-API, מתחת ל-py, כמו שמוצג כאן:

אפשר גם לאחסן קובצי משאבים במאגרי מידע ברמת הסביבה (לדוגמה, כדי להפוך קוד PythonScript לזמין לכל השרתים הפרוקסי בסביבה). השגיאה הזו מתרחשת אם לא ניתן למצוא קובץ משאבים כלשהו שצוין במדיניות.

אבחון

1. מזהים את מדיניות PythonScript שבה התרחשה השגיאה ואת ההפניה הלא תקינה לכתובת ה-URL של המשאב. המידע הזה מופיע בהודעת השגיאה. לדוגמה, בשגיאה הבאה, שם המדיניות הוא Python_script וההפניה הלא חוקית לכתובת ה-URL של המשאב היא py://myscript.py:

   Invalid resource url ref py://myscript.py in policy Python_script in myorg

2. מוודאים שההפניה לכתובת ה-URL של המשאב שצוינה במדיניות PythonScript שנכשלה תואמת לערך שזוהה בהודעת השגיאה (שלב 1 למעלה). לדוגמה, במדיניות הבאה מצוינת הפניה לכתובת ה-URL של המשאב כ-py://myscript.py, שזהה למה שמופיע בהודעת השגיאה:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <Script async="false" continueOnError="false" enabled="true" name="Python_script">
       <DisplayName>Python-1</DisplayName>
       <Properties/>
       <ResourceURL>py://myscript.py</ResourceURL>
   </Script>

3. בודקים אם הקובץ שזוהה בשלב 1 הוא חלק מחבילת ה-API Proxy הספציפית, או שהוא קיים בהיקף הסביבה.

   1. כדי לבדוק אם הקובץ הוא חלק מחבילת ה-API Proxy הספציפית, פועלים לפי אחד מהשלבים הבאים:
      1. בממשק המשתמש של Apigee, בודקים אם הקובץ נמצא בקטע Scripts של proxy ל-API.
      2. מורידים את חבילת ה-API Proxy ומחפשים אם הקובץ קיים.
   2. אם הקובץ לא כלול בחבילת ה-API Proxy הספציפית, צריך לבדוק אם הוא קיים ברמת הסביבה. אפשר להשתמש ב-Resource Files API לחקירה הזו.

   אם הקובץ לא קיים ברמת ה-API Proxy או הסביבה, זו הסיבה לשגיאה.

   בדוגמה שלמעלה, שם הקובץ הלא תקין של PythonScript הוא myscript.py. בצילום המסך שלמטה, אפשר לראות שהקובץ שצוין ככתובת URL של משאב במדיניות לא מופיע בקטע Scripts (סקריפטים). בנוסף, הקובץ לא קיים ברמת הסביבה. לכן, פריסת ה-API Proxy נכשלת עם השגיאה:

   Invalid resource url ref py://myscript.py in policy Python_script in myorg

רזולוציה

מוודאים שקובצי ה-PythonScript שצוינו ברכיבים <ResourceURL> ו-<IncludeURL> מפנים לקובץ תקין שקיים ברמת ה-API Proxy או הסביבה.

כדי לתקן את מדיניות PythonScript שמוצגת למעלה, מוסיפים את הקובץ myscript.py לחבילת ה-API Proxy. בצילום המסך שלמטה אפשר לראות שקבצי PythonScript שצוינו באלמנטים <ResourceURL> ו-<IncludeURL> מוצגים בקטע Scripts של חבילת ה-API Proxy: