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

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

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

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

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

התחלה מהירה:

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

מידע על פריסה

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

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

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

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

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

פריסה ללא השבתה

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

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

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

הערה: אם הפריסה של גרסה 2 נכשלת מסיבה כלשהי, הגרסה הקודמת, גרסה 1, עדיין לא נפרסת. במקרה כזה, אפשר לפרוס מחדש את הגרסה הקודמת כדי לשחזר אותה. לאחר מכן, תוכלו לתקן את הגרסה החדשה ולפרוס אותה.

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

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

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

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

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

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

בממשק המשתמש של Apigee נעשה שימוש בסמלים הבאים כדי לספק סטטוס מהיר לכל 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

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

הערה: אם הארגון שלכם מוגדר כ-Apigee hybrid, מוצג רק חלק ממדדי השימוש האלה.

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

כדי לראות את נתוני השימוש ב-Deployment (פריסה) של 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: המספר הכולל של שרתי proxy של API ושל זרימות משותפות שפריסתם בוצעה בארגון, בהשוואה למגבלה שנקבעה לסוג הארגון.
   • יחידות פריסה שניתנות להרחבה: מספר הגרסאות של proxy ל-API שניתנות להרחבה שנפרסו בארגון. כל פריסה לכל סביבה ולכל מופע נספרת כיחידה אחת.
   • יחידות פריסה רגילות: מספר הגרסאות של proxy ל-API רגיל שנפרסו בארגון. כל פריסה לכל סביבה ולכל מופע נספרת כיחידה אחת.

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

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

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

   מעבר אל API Proxies

2. בדף שרתי proxy ל-API מוצג המידע הבא:
   • סך ה-proxies שנוצרו: המספר הכולל של שרתי proxy ל-API שפותחו בארגון, כולל שרתי proxy שנפרסו ושלא נפרסו.
   • Proxies deployed: המספר הכולל של גרסאות של proxy ל-API שנפרסו בכל הסביבות בארגון.
   • יחידות פריסת Proxy: המספר הכולל של תיקוני proxy ל-API או של רכיבי Shared Flow שנפרסו בכל הסביבות בארגון. כל פריסה לכל סביבה ולכל מופע נספרת כיחידה אחת.
   • יחידות פריסה של שרתי proxy עם יכולת הרחבה: מספר הגרסאות של proxy ל-API עם יכולת הרחבה שנפרסו בכל הסביבות בארגון. כל פריסה לכל סביבה ולכל מופע נספרת כיחידה אחת.
   • יחידות פריסה של שרתי proxy רגילים: מספר הגרסאות של שרתי 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