‫Cloud Endpoints for OpenAPI

‫Cloud Endpoints היא מערכת לניהול API שעוזרת לכם לאבטח, לנטר, לנתח ולהגדיר מכסות בממשקי ה-API שלכם באמצעות אותה תשתית שבה Google משתמשת לממשקי ה-API שלה. ‫Endpoints פועל עם Extensible Service Proxy‏ (ESP) ועם Extensible Service Proxy V2‏ (ESPv2) כדי לספק ניהול של ממשקי API. מידע נוסף על Endpoints,‏ ESP ו-ESPv2 זמין במאמר מידע על Endpoints.

‫Endpoints תומך בממשקי API שמתוארים באמצעות OpenAPI 2.0 ו-OpenAPI 3.x של מפרט OpenAPI (לשעבר מפרט Swagger, שנקרא בעבר מפרט Swagger) – תקן התעשייה להגדרת ממשקי REST API.

אם אתם לא מכירים את מפרט OpenAPI, כדאי לעיין בסקירה הכללית של OpenAPI. מידע נוסף על גרסאות נתמכות זמין במאמר גרסאות נתמכות של OpenAPI.

בסדרת המסמכים הזו מוסבר איך להשתמש ב-Endpoints עם OpenAPI. לעיון במסמכים בנושא אפשרויות אחרות של Endpoints, אפשר לעבור אל All Endpoints Docs.

כדי להתחיל, מומלץ לעיין במסמכים הבאים:

1. כדי לראות את התכונות של Endpoints בפעולה, אפשר לעבור על המדריך למתחילים ב-Cloud Endpoints, שבו נעשה שימוש בסקריפטים כדי לפרוס API לדוגמה בסביבה הגמישה של App Engine.

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

3. אחרי שמחליטים על ה-backend של ה-API, אפשר לעבור על הדרכה לפלטפורמת המחשוב המועדפת.

פלטפורמות מחשוב נתמכות

נקודות הקצה של OpenAPI תלויות ב-ESP או ב-ESPv2 לניהול API. גם ESP וגם ESPv2 הם פרויקטים בקוד פתוח, ואפשר להשתמש בהם בדרכים הבאות:

• קונטיינר ב-Artifact Registry.
  • הערות המוצר של ESP כוללות את קובץ האימג' הנוכחי של ESP Docker.
  • בהערות המוצר של ESPv2 מופיע מידע על תמונת ה-Docker הנוכחית של ESPv2.
• קוד המקור ב-GitHub.
  • פרטים על בניית ESP מופיעים בקובץ ה-README של ESP.
  • פרטים על בניית ESPv2 מופיעים בקובץ ה-README של ESPv2.

אפשר להריץ את מאגר ה-ESP ב:

• סביבה גמישה של App Engine
• Compute Engine
• ‫Kubernetes, כולל Google Kubernetes Engine
• מחשב עם Linux או macOS או פלטפורמה אחרת

אפשר להריץ את מאגר ESPv2 ב:

• App Engine
• פונקציות Cloud Run
• Cloud Run
• מילוי בקשות מסוג Knative
• GKE
• Compute Engine
• ‏Kubernetes

מידע נוסף זמין במאמר מידע כללי על Cloud Endpoints.

בסביבה הגמישה של App Engine, ‏ ESP נפרס באופן אוטומטי כשמוסיפים כמה שורות לקובץ app.yaml. מידע נוסף מופיע במאמר פריסת ה-API ו-ESP. ‫ESPv2 לא תומך בסביבה גמישה של App Engine.

בסביבה הרגילה של App Engine, דור 1, צריך להשתמש ב-Endpoints Frameworks. אם במקום זאת תפרסו את הקונטיינר לאחת מאפשרויות החישוב שלמעלה, תוכלו להשתמש ב-proxy לכל אחד מהדורות של סביבת זמן הריצה הרגילה של App Engine.