create-service-account

יוצר חשבונות שירות ב-Google Cloud Platform ‏ (GCP) עם תפקידים שמאפשרים לרכיבים נפרדים של Apigee Hybrid לבצע קריאות מורשות ל-API ולהוריד את קובצי המפתחות המשויכים של חשבון השירות. אתם יכולים להשתמש בקובצי המפתחות של חשבונות השירות שנוצרו באמצעות הפקודה הזו בקובץ שינויי ההגדרות.

הכלי create-service-account נמצא בספרייה hybrid_root_dir/tools.

דרישות מוקדמות

כדי להשתמש בכלי create-service-account, צריך להתקין את gcloud CLI. למשתמשים שמפעילים את כלי השירות צריך להיות התפקיד Service Account Admin.

כדי להתחיל, מוודאים שהגדרת הפרויקט gcloud מוגדרת לפרויקט בענן שיצרתם בשלב 2: יצירת פרויקט ב-Google Cloud:

gcloud config list project

אם אתם צריכים לשנות את מזהה הפרויקט הנוכחי, משתמשים בפקודה הזו: 

gcloud config set project gcp_project_id

כאשר gcp_project_id הוא הפרויקט שנוצר בשלב 2: יצירת פרויקט ב-Google Cloud.

תחביר של create-service-account

התחביר של הכלי create-service-account הוא:

create-service-account component_name output_dir [gcp_project_id]

כאשר:

  • ‫component_name: מציין את השירות ההיברידי שמשתמש בחשבון השירות. הערכים התקפים הם:
    • apigee-cassandra
    • apigee-logger
    • apigee-mart
    • apigee-metrics
    • apigee-synchronizer
    • apigee-udca

    שימו לב: אי אפשר ליצור את חשבון השירות apigee-org-admin באמצעות הכלי create-service-account. צריך ליצור אותו באמצעות ממשקי ה-API של GCP או gCloud, כמו שמתואר במאמר יצירת חשבונות שירות.

  • ‫output_dir: ספריית הפלט שבה יישמר המפתח של חשבון השירות שהורד.
  • ‫gcp_project_id: (אופציונלי) ציון מזהה הפרויקט ב-GCP של הפרויקט שמקושר לארגון שלכם עם הפעלה של תכונות היברידיות. אם לא מספקים את מזהה פרויקט GCP, הכלי מנסה לאחזר אותו מההגדרה הנוכחית של gcloud.

תיאור מפורט

הכלי create-service-account:

  • יוצר חשבונות שירות ב-GCP שמשמשים רכיבים היברידיים. לחשבון השירות שנוצר מוקצה התפקיד שנדרש לרכיב הספציפי כדי לפעול.
  • המפתח של חשבון השירות יורד למערכת. ממקמים את המפתחות של חשבון השירות בקובץ של חריגות בהגדרת ההיברידי, כמו שמוסבר בהוראות ההתקנה של ההיברידי.

הכלי יוצר חשבונות שירות לרכיבים הבאים:

רכיב* תפקיד נדרש להתקנה בסיסית? תיאור
apigee-cassandra אדמין של אובייקטים באחסון מאפשר גיבוי של Cassandra ל-Google Cloud Storage, כפי שמתואר במאמר גיבוי ושחזור.
apigee-logger בעל הרשאת כתיבה של יומנים מאפשר רישום של איסוף נתונים ביומן, כפי שמתואר במאמר בנושא רישום ביומן. נדרש רק להתקנות של אשכולות שאינם GKE.
apigee-mart אין תפקיד מאפשר אימות של שירות MART. לחשבון השירות הזה לא צריך להיות תפקיד משויך. לכן, כשיוצרים את חשבון השירות הזה, לא מקצים לו תפקיד.
apigee-metrics בעל הרשאת כתיבה של מדדי מעקב הרשאה לאיסוף נתוני מדדים, כפי שמתואר במאמר בנושא איסוף מדדים
apigee-org-admin אדמין של ארגון Apigee מאפשרת לשלוח קריאה ל-getSyncAuthorization API ול-setSyncAuthorization API. אי אפשר ליצור את חשבון השירות הזה באמצעות הכלי create-service-account.
apigee-synchronizer Apigee Synchronizer Manager מאפשרת למסנכרן להוריד חבילות של שרת proxy ונתוני תצורת סביבה. היא גם מאפשרת את הפעולה של תכונת המעקב.
apigee-udca Apigee Analytics Agent מאפשר העברה של נתוני מעקב, ניתוח וסטטוס פריסה למישור הניהול.
‫* השם הזה משמש כשם הקובץ של המפתח של חשבון השירות שהורדתם.

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

דוגמה

בדוגמה הבאה נוצר חשבון שירות חדש עבור השירות apigee-logger והמפתח שהורד ממוקם בספרייה ./service-accounts.

./my-hybrid-root/tools/create-service-account apigee-logger ./service-accounts