פריסת שרתי proxy משורת הפקודה

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

במאמר הזה מוסבר איך פורסים שרת proxy משורת הפקודה. ב-Apigee Edge יש שתי אפשרויות לפריסה משורת הפקודה. האפשרות הראשונה היא להשתמש בכלי פריסה של Apigee Edge שנכתב ב-Python. האפשרות השנייה היא להגדיר ולהפעיל סקריפט מעטפת.

משתמשים בטכניקות פריסה משורת הפקודה כשעובדים ישירות עם קובצי מקור של Proxy במערכת. יכולות להיות הרבה סיבות לכך שאתם עובדים במצב אופליין. אולי תרצו להשתמש בעורך XML מועדף, או שאתם מפתחים מדיניות שדורשת קידוד ב-Java ואתם עובדים בעיקר בסביבת פיתוח משולבת (IDE). הטכניקות שמתוארות בקטע הזה מאפשרות להעלות ולפרוס את קובצי המקור בסביבת API Services שתבחרו.

אם אתם עובדים בעיקר בממשק המשתמש לניהול, כדאי לעיין במאמר פריסת שרתי proxy בממשק המשתמש.

You're viewing Apigee Edge documentation.
Go to the Apigee X documentation. info

הפעלת כלי הפריסה של Python ב-Apigee Edge

כלי הפריסה של Python ב-Apigee Edge פועל עם Edge management API כדי לייבא ולפרוס שרתי proxy ל-API. הכלי זמין כחלק מהפצת הדוגמאות של פלטפורמת ה-API ב-GitHub. מידע נוסף זמין במאמר בנושא שימוש בשרתי proxy לדוגמה של API.

אפשר להשתמש בכלי Python של Apigee Edge כדי לייבא (להעלות) ולפרוס את ה-API בתהליך פשוט אחד.

צריך להריץ את כלי הפריסה מהספרייה הבסיסית בהפצה של הדוגמאות של API Platform, כאשר הספרייה הבסיסית היא ספריית האב של הספרייה setup ושל הספרייה tools.

בפקודה הבאה, מחליפים את שם ה-proxy, את שם המשתמש והסיסמה שלכם ב-Edge, את הארגון והסביבה של Edge ואת הנתיב לספרייה שמכילה את ה-proxy של ה-API, כלומר הספרייה apiproxy":

python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /

לדוגמה:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /

הפקודה הזו מכווצת את הקבצים, מעבירה אותם לארגון שלכם ב-Apigee Edge ומבצעת פריסה שלהם בסביבה שצוינה.

כלי הפריסה מזהה באופן אוטומטי את הגרסה הנוכחית של שרת ה-proxy של ה-API, מבטל את הפריסה של הגרסה הקיימת ופורס גרסה חדשה של שרת ה-proxy של ה-API.

אם הפעולה תצליח, הפלט ייראה כך:

Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml
Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml
Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml
Imported new proxy version 1
Environment: test
  Revision: 1 BasePath = /
  State: deployed

כברירת מחדל, הכלי מעלה את proxy ל-API אל https://api.enterprise.apigee.com, שמקביל ל-Edge בענן. אפשר גם להשתמש בכלי הזה כדי להעלות את proxy ל-API לגרסה מקומית של Edge על ידי ציון הדגל -h:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080

בדוגמה הזו, מציינים את כתובת ה-IP של שרת הניהול של Edge. אם יצרתם רשומת DNS לשרת הניהול, תוכלו לציין כתובת URL בפורמט הבא:

https://ms_URL:8080

הרשימה המלאה של התגים לפקודה היא:

  • ‫-n: השם של ה-proxy ל-API.
  • ‫-u: שם המשתמש והסיסמה של החשבון בארגון ב-Apigee Edge.
  • ‫-o: השם של הארגון שבו יש לכם חשבון.
  • ‫-e: הסביבה שבה צריך לפרוס את proxy ל-API (test או prod).
  • ‫-d: הנתיב לספרייה שמכילה את קובצי ה-proxy ל-API. קבצי ה-proxy ל-API צריכים להיות מאוחסנים בספרייה בשם apiproxy. הערך הזה הוא הנתיב של הספרייה שמכילה את הספרייה apiproxy, ולא הנתיב של הספרייה apiproxy עצמה.
  • ‫-p: נתיב ה-URI שמשמש כהתאמה לתבנית כדי להפנות הודעה נכנסת לפריסת ה-API Proxy הזו. ברוב המקרים, אפשר להגדיר את הערך הזה כ-'/', אלא אם יש לכם דרישות מתקדמות לגבי פריסה וניתוב. הנתיב הראשי שמשמש לניתוב של proxy ל-API מוגדר בקובץ התצורה של ProxyEndpoint של proxy ל-API.
  • ‫-h: כתובת ה-URL של Edge. כברירת מחדל, כתובת ה-URL היא https://api.enterprise.apigee.com, שמתאימה ל-Edge בענן. בפריסה מקומית, משתמשים בכתובת ה-URL של שרת הניהול של Edge וביציאה 8080, כמו בדוגמה הבאה: 
    https://ms_URL:8080

    לחלופין, אפשר להשתמש בכתובת ה-IP של שרת הניהול, כמו בדוגמה https://192.168.11.111:8080.

הגדרת סקריפט של מעטפת פריסה והרצה שלו

הגישה הכי קלה היא להריץ את סקריפט הפריסה שמצורף לפרוקסי לדוגמה של ה-API. סקריפטים של מעטפת עוטפים את כלי הפריסה של Python ב-Apigee Edge.

מהספרייה /simplyProxy מריצים:

$ sh deploy.sh

הפרטים שמוצגים הם:

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]:

מזינים את הסיסמה ומקישים על Enter.

אחרי כן אמור להופיע:

Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com

אם מופיע:

Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]:

כלומר, צריך לשנות את הקובץ /setup/setenv.sh בהפצה של דוגמאות הפלטפורמה. הוראות מפורטות מופיעות בקובץ ה-README או במאמר ממשקי API של Apigee Edge.

אם הפריסה מצליחה, כלי הפריסה יוצר קובץ ZIP של הקבצים בתיקייה /apiproxy, imports ומייבא את החבילה לארגון שלכם ב-Apigee Edge, ואז פורס את ה-proxy ל-API בסביבת הבדיקה.

ה-proxy ל-API מוכן להפעלה.