סקירה כללית על הפריסה

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

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

כשמבצעים שינוי ב-proxy ל-API, אפשר לשמור אותו כגרסה חדשה ולפרוס אותו באשכול.

מידע על פריסה

באיור הבא מוצג מחזור החיים של פריסת תיקון של שרת proxy ל-API ב-Apigee.

מחזור החיים של פריסת proxy ל-API ב-Apigee, שכולל את רמת הניהול, רמת זמן הריצה והכותרת Cloud Operations title=

מגבלות על גרסאות של proxy ל-API

המגבלות הבאות חלות על גרסאות של proxy ל-API:

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

פריסה ללא זמן השבתה

כל הפריסות של proxy ל-API ב-Apigee שבוצעו בהצלחה הן פריסות ללא השבתה. פריסות של proxy ל-API מתבצעות בסדר הזה:

  1. גרסה 1 של ה-proxy ל-API‏ /hello נפרסה ומטפלת בתעבורת נתונים.
  2. גרסה 2 של /hello נפרסה.
  3. גרסה 2 נפרסת למעבדי ההודעות במישור זמן הריצה.
  4. גרסה 1 לא נפרסה.

הפריסה של הגרסה של ה-proxy ל-API הושלמה ללא השבתה.

צפייה בסטטוס הפריסה

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

ממשק המשתמש של Apigee

  1. במסוף Google Cloud , נכנסים לדף Apigee > Proxy development > API proxies.

    מעבר לשרתי proxy ל-API

  2. בוחרים את ה-proxy ל-API הרצוי. הסטטוס מוצג בקטע Deployments.

    3. בממשק המשתמש של Apigee נעשה שימוש בסמלים הבאים כדי להציג במהירות את הסטטוס של כל proxy ל-API:

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

Apigee API

כדי לראות את סטטוס ה-Deployment (פריסה) של גרסה ב-proxy ל-API בסביבה, משתמשים בקריאה הבאה ל-API:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/revisions/$REV/deployments" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

‫$TOKEN מוגדר כאסימון הגישה מסוג OAuth 2.0, כפי שמתואר במאמר איך מקבלים אסימון גישה מסוג OAuth 2.0. מידע על האפשרויות curl שבהן נעשה שימוש בדוגמה הזו מופיע במאמר שימוש ב-curl. תיאור של משתני הסביבה שבהם אפשר להשתמש מופיע במאמר בנושא הגדרת משתני סביבה לבקשות API של Apigee.

בהמשך מופיעה דוגמה לתגובה. בדוגמה הזו מוצג סטטוס הפריסה של גרסה 1 של proxy ל-API של helloworld שנפרס בסביבת test:

{
  "environment": "test",
  "apiProxy": "helloworld",
  "revision": "1",
  "deployStartTime": "1559149080457",
  "pods": [
    {
      "podName": "apigee-runtime-myorg-test-f8bdf9d-2s72w",
      "deploymentStatus": "deployed",
      "statusCodeDetails": "Deployment Success",
      "podStatus": "active",
      "podStatusTime": "1595357668001"
    }
  ],
  "state": "READY"
}

מידע נוסף זמין במאמר בנושא API proxy revision environment deployments API.

gcloud

כדי לראות את סטטוס הפריסה של תיקון של שרת proxy ל-API בסביבה, משתמשים בפקודה הבאה של gcloud: 

gcloud alpha apigee deployments describe --api=$API --environment=$ENV

מידע נוסף ותיאור של משתני הסביבה שמשמשים בדוגמאות זמינים במאמר תחילת העבודה עם gcloud ב-Apigee.

בהמשך מופיעה דוגמה לתגובה. בדוגמה הזו מוצג סטטוס הפריסה של גרסה 1 של proxy ל-API של helloworld שנפרס בסביבת test: 

Using Apigee organization `my-org`
Using deployed revision `1`
apiProxy: helloworld
deployStartTime: '1598032332802'
environment: test
pods:
- deploymentStatus: deployed
  podName: apigee-runtime-myorg-test-f8bdf9d-2s72w
  podStatus: active
  podStatusTime: '1598302128087'
  statusCodeDetails: Deployment Success
revision: '1'
state: READY

מידע נוסף זמין במאמר Describe deployments CLI.

צפייה בנתוני השימוש בפריסת שרת proxy

יכול להיות שהשימוש ב-API proxy בארגון שלכם כפוף למכסת פריסות, שהיא מגבלה על מספר יחידות הפריסה שבהן אתם יכולים להשתמש בכל פעם. פרטים נוספים זמינים בזכויות שלכם (Pay-as-you-go או מינוי). אפשר לראות את נתוני השימוש בפריסת ה-proxy של הארגון בכמה מקומות בממשק המשתמש של Apigee במסוף Cloud, כמו שמתואר בהמשך.

צפייה בשימוש בפריסה בדף הסקירה הכללית של Apigee

כדי לראות את נתוני השימוש בפריסת proxy ל-API בדף Overview ב-Apigee:

  1. במסוף Google Cloud , נכנסים לדף Apigee > Overview.

    לסקירה הכללית

  2. אתם יכולים לראות את נתוני השימוש בפריסת ה-Proxy בארגון שלכם במבט חטוף באמצעות הכרטיס Proxy Usage, שבו מוצגים הפרטים הבאים לגבי הארגון שלכם:
    • סך שרתי ה-proxy שנוצרו: המספר הכולל של שרתי proxy ל-API שנוצרו, כולל שרתי proxy שנפרסו ושלא נפרסו.
    • Proxies deployed: המספר הכולל של שרתי proxy של API שנפרסו בכל הסביבות בארגון.
    • יחידות פריסה של שרתי proxy: המספר הכולל של תיקונים של שרתי proxy ל-API או של רכיבי Shared Flow שנפרסו בארגון. כל פריסה לכל סביבה ולכל מופע נספרת כיחידה אחת.
    • Proxies and shared flows deployed against limit: Total number of API proxies and shared flows deployed in the organization, against the limit for your organization type.
    • יחידות פריסה שניתנות להרחבה: מספר הגרסאות של proxy ל-API שניתנות להרחבה שנפרסו בארגון. כל פריסה לכל סביבה ולכל מופע נספרת כיחידה אחת.
    • יחידות פריסה רגילות: מספר הגרסאות של proxy ל-API שנפרסו בארגון. כל פריסה לכל סביבה ולכל מופע נספרת כיחידה אחת.

צפייה בשימוש בפריסה בדף API Proxies (שרתי proxy ל-API)

כדי לראות את נתוני השימוש בפריסת שרתי proxy ל-API בדף API Proxies:

  1. נכנסים לדף API Proxies במסוף Google Cloud .

    מעבר אל API Proxies

  2. בדף API Proxies מוצג המידע הבא:
    • סך ה-proxies שנוצרו: המספר הכולל של ה-proxies ל-API שפותחו בארגון, כולל proxies שנפרסו ושלא נפרסו.
    • Proxies deployed: המספר הכולל של גרסאות של proxy ל-API שנפרסו בכל הסביבות בארגון.
    • יחידות פריסת שרת proxy: המספר הכולל של תיקוני שרת proxy ל-API או של תיקוני זרימה משותפת שנפרסו בכל הסביבות בארגון. כל פריסה לכל סביבה ולכל מופע נספרת כיחידה אחת.
    • יחידות פריסה של שרתי proxy עם יכולת הרחבה: מספר הגרסאות של proxy ל-API עם יכולת הרחבה שנפרסו בכל הסביבות בארגון. כל פריסה לכל סביבה ולכל מופע נספרת כיחידה אחת.
    • יחידות פריסה של proxy ל-API רגיל: מספר הגרסאות של proxy ל-API רגילים שנפרסו בכל הסביבות בארגון. כל פריסה לכל סביבה ולכל מופע נספרת כיחידה אחת.

צפייה בשימוש בפריסה בדף Environments (סביבות)

כדי לראות את נתוני השימוש ב-proxy ל-API בדף Environments:

  1. נכנסים לדף Environments במסוף Google Cloud .

    מעבר אל Environments

  2. בוחרים בכרטיסייה סקירה כללית של סביבות כדי להציג את המידע הבא לגבי כל הסביבות:
    • Total proxy deployment units: המספר הכולל של תיקונים של שרת proxy ל-API או של רכיב Shared Flow שנפרסו בכל הסביבות בארגון.
    • יחידות פריסה של שרתי proxy עם יכולת הרחבה: מספר הגרסאות של proxy ל-API עם יכולת הרחבה שנפרסו בכל הסביבות בארגון. כל פריסה לכל סביבה ולכל מופע נספרת כיחידה אחת.
    • יחידות פריסה של שרתי proxy רגילים: מספר הגרסאות של proxy ל-API רגילים שנפרסו בכל הסביבות בארגון. כל פריסה לכל סביבה ולכל מופע נספרת כיחידה אחת.
    • יחידות פריסה של תהליכי עבודה משותפים: המספר הכולל של גרסאות של תהליכי עבודה משותפים שנפרסו בכל הסביבות בארגון. כל פריסה לכל סביבה ולכל מופע נספרת כיחידה אחת.
  3. כדי לראות את נתוני השימוש בפריסת שרת proxy בסביבה אחת:
    1. ברשימה Environments, בוחרים שם של סביבה כדי לראות את הפרטים שלה.
    2. בוחרים בכרטיסייה פריסות כדי לראות את השימוש ביחידת הפריסה בסביבה שנבחרה.

השלבים הבאים

 

איך פורסים:

פריסת proxy ל-API

 

 

איך מבטלים את הפריסה

ביטול הפריסה של proxy ל-API