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

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

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

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

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

כרגע מוצג התיעוד של Apigee Edge.
נכנסים למסמכי התיעוד של Apigee X. מידע

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

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

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

חובה להפעיל את כלי הפריסה מהספרייה הבסיסית בהתפלגות 'דוגמאות הפלטפורמה של API', שבה ספריית הבסיס היא ספריית ההורה של הספריות setup ו-tools.

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

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, מבטל את הפריסה הקיימת ופורס גרסה קודמת של שרת ה-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

כברירת מחדל, הכלי מעלה את שרת ה-API של שרת ה-proxy ל-https://api.enterprise.apigee.com, בהתאם ל-Edge בענן. אפשר להשתמש בכלי הזה גם כדי להעלות את שרת ה-API של ה-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: השם של שרת ה-API של שרת ה-proxy.
• -u: שם המשתמש והסיסמה של החשבון שלך בארגון ב-Apigee Edge.
• -o: שם הארגון שבו יש לכם חשבון.
• -e: הסביבה שאליה צריך לפרוס את שרת ה-proxy של ה-API (test או prod).
• -d: הנתיב לספרייה שמכילה את קובצי ה-API של שרת ה-API. קובצי ה-API של שרת ה-API חייבים להיות מאוחסנים בספרייה שנקראת "apiproxy". הערך הזה הוא הנתיב לספרייה שמכילה את הספרייה "apiproxy", ולא לנתיב של ספריית ה-apiproxy עצמה.
• -p: נתיב ה-URI המשמש כהתאמת תבנית לניתוב הודעות נכנסות לפריסה של שרת ה-proxy של ה-API. ברוב המקרים אפשר להגדיר את הערך כ-'/', אלא אם יש לכם דרישות מתקדמות של פריסה וניתוב. הנתיב הראשי שמשמש לניתוב של שרת proxy ל-API מוגדר בקובץ התצורה ProxyEndpoint של ה-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.

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

הגישה הקלה ביותר היא להריץ את סקריפט הפריסה שסופק עם שרת ה-proxy לדוגמה של ממשק ה-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 או ב-Apigee Edge APIs.

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

שרת ה-API של ה-API מוכן להפעלה.