תחילת העבודה עם Application Integration ויעדי שילוב של שרתי proxy של Apigee

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

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

לפני שמתחילים

• מאשרים את פרטי הכניסה ל-Apigee ואת פרטי הארגון. המידע הזה נדרש כדי לגשת לתכונה Application Integration ולאשף הפרוקסי בממשק המשתמש של Apigee.
• יוצרים ומפרסמים שילוב עם API Trigger ולפחות משימה אחת.
  • אם עדיין לא יצרתם שילוב שמשתמש בטריגר API, אתם יכולים לפעול לפי השלבים במאמר שליפת מטען ייעודי (payload) של API ושליחת אימייל.
  • חשוב לשים לב לשם השילוב שיוצרים או לשם השילוב הקיים שרוצים להשתמש בו, כי תצטרכו אותו בשלב מאוחר יותר.
• יוצרים חשבון שירות של Google באותו פרויקט Google Cloud שבו נוצר הארגון שלכם ב-Apigee, ומבצעים את הפעולות הבאות:
  • מקצים לחשבון השירות את התפקיד Application Integration Invoker (roles/integrations.applicationIntegrationInvokerRole). מידע על התפקידים המוגדרים מראש של Application Integration זמין במאמר תפקידים מוגדרים מראש ב-IAM.
  • לאפשר לחשבון המשתמש (הגורם הראשי) לצרף חשבונות שירות למשאבים באמצעות ההרשאה iam.serviceAccounts.actAs. מידע על הרשאות לחשבון שירות זמין במאמר תפקידים לאימות חשבון שירות .

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

• אם רוצים להשתמש בשילובים של אפליקציות ללא הגבלות, אפשר לשלם על השילובים. Application Integration זמין כשירות נוסף למינוי שלכם. אם כבר רכשתם את הזכאות ל-Application Integration ואתם רוצים להפעיל אותה בפרויקט בענן של Google Cloud או בארגון Apigee, אתם צריכים לפנות לתמיכה של Apigee. עם זאת, אם רוצים לרכוש את הזכאות ל-Application Integration, צריך לפנות למחלקת המכירות של Apigee. אחרי שהפעלנו בשבילכם את Application Integration, צריך לבצע את המשימות הבאות:
  1. מפעילים את ממשקי ה-API הבאים:
     • ‫Apigee API ‏ (apigee.googleapis.com)
     • ‫Application Integration API‏ (integrations.googleapis.com)
     • ‫Secret Manager API‏ (secretmanager.googleapis.com)
     • Connectors API ‏ (connectors.googleapis.com)

     מידע על הפעלת ממשקי ה-API זמין במאמר הפעלת שירותים.

  2. מפעילים את השילוב ואת התוספים Connectors בארגון Apigee.

     • אם אתם יוצרים ארגון חדש לשימוש בשילוב, מריצים את הפקודה הבאה:

       curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" -d '{"name":"${ORG_ID}", "analyticsRegion":"us-west1", "authorized_network":"${NETWORK_ID}", "runtimeType":"CLOUD", "runtimeDatabaseEncryptionKeyName":"${ENCRYPTION_KEY_NAME}", "addonsConfig": {"integrationConfig": {"enabled": true}, "connectorsPlatformConfig":{"enabled":true}}}' "https://apigee.googleapis.com/v1/organizations?parent=projects/${PROJECT_ID}"

     • אם אתם משתמשים בארגון קיים, מריצים את הפקודה הבאה:

       curl -H "Authorization: Bearer $TOKEN" -H "content-type:application/json" "https://apigee.googleapis.com/v1/organizations/${ORG_ID}:setAddons" -XPOST -d '{"addonsConfig":{"integrationConfig":{"enabled":true},"connectorsPlatformConfig":{"enabled":true}}}'

  3. כדי לוודא שהתוספים הופעלו בהצלחה, משתמשים בפקודה הבאה:

     curl -H "Authorization: Bearer $TOKEN"  -H "content-type:application/json" "https://apigee.googleapis.com/v1/organizations/${ORG_ID}"

     אחרי הרצת הפקודה, אמורה להופיע הודעה דומה לזו:

     {
       "name": "Test....",
       "createdAt": "1615483867669",
       "lastModifiedAt": "1615483873468",
       …...
       "addonsConfig": {
         "integrationConfig": {
           "enabled": true,
         "connectorsPlatformConfig": {
           "enabled": true
         }
       }
       }

  4. מקצים לחשבון השירות שמוגדר כברירת מחדל ב-Apigee(service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com) את תפקידי ה-IAM הבאים:
     • Application Integration Invoker (roles/integrations.applicationIntegrationInvokerRole)

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

יצירת שרת proxy של יעד לשילוב אפליקציות

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

פריסת שרת ה-Proxy

כדי לפרוס את ה-proxy החדש שנוצר:

ממשק המשתמש מתחיל בתהליך הפריסה של הגרסה שנבחרה. פריסת ה-proxy עשויה להימשך עד דקה.

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

בדיקת שרת ה-proxy של יעד השילוב

מריצים את הפקודה הבאה מחלון הטרמינל כדי להפעיל את ה-proxy ולהפעיל את השילוב:

curl -v https://YOUR_ENV_GROUP_HOSTNAME/PROXY_NAME

כאשר YOUR_ENV_GROUP_HOSTNAME הוא שם המארח של קבוצת סביבות שמכילה את הסביבה שבה ה-proxy שלכם נפרס.

לדוגמה:

curl -v https://my-org-prod.hybrid.e2e.apigeeks.net/my-proxy

כדי לוודא שהשילוב הופעל על ידי הפעלת ה-proxy:

עדכון מטען הייעודי (payload) של בקשת ה-proxy (אופציונלי)

כדי לעדכן את מטען הייעודי (payload) של בקשת ה-proxy:

המאמרים הבאים

כדאי לעיין בפריסת הכלי לעיצוב שילובים ולהבין את מושגי השילוב השונים שמתוארים במאמר כל המושגים.