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

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

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

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

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

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

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

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

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

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

בפקודה הבאה, מחליפים את שם שרת ה-proxy, שם המשתמש והסיסמה של 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 ופורסת אותם אותם לסביבה שצוינה.

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

בהצלחה, הפלט יופיע בטופס:

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

מהספרייה /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.

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

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