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-distributed-trace
    • apigee-logger
    • apigee-mart
    • apigee-metrics
    • apigee-synchronizer
    • apigee-udca
    • apigee-watcher

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

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

תיאור מפורט

הכלי create-service-account:

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

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

רכיב* תפקיד נדרש להתקנה בסיסית? תיאור
apigee-cassandra אדמין של אובייקטים באחסון מאפשר גיבוי של Cassandra ל-Cloud Storage, כמו שמתואר במאמר גיבוי ושחזור.
apigee-logger בעל הרשאת כתיבה של יומנים מאפשר רישום של איסוף נתונים ביומן, כפי שמתואר במאמר בנושא רישום ביומן. נדרש רק להתקנות של אשכולות שאינם GKE.
apigee-mart Apigee Connect Agent מאפשר אימות של שירות MART. תפקיד הסוכן של Apigee Connect מאפשר לו לתקשר בצורה מאובטחת עם תהליך Apigee Connect, כפי שמתואר במאמר שימוש ב-Apigee Connect.
apigee-metrics בעל הרשאת כתיבה של מדדי מעקב מאפשר איסוף נתונים של מדדים, כפי שמתואר במאמר סקירה כללית על איסוף מדדים.
apigee-synchronizer Apigee Synchronizer Manager מאפשרת למסנכרן להוריד חבילות של שרת proxy ונתוני תצורת סביבה. היא גם מאפשרת את הפעולה של תכונת המעקב.
apigee-udca Apigee Analytics Agent מאפשר העברה של נתוני מעקב, ניתוח וסטטוס פריסה למישור הניהול.
apigee-watcher Apigee Runtime Agent ‫Apigee Watcher שולף מהסנכרון שינויים שקשורים למארחים וירטואליים בארגון, ומבצע את השינויים הנדרשים כדי להגדיר את istio ingress.
‫* השם הזה משמש כשם הקובץ של המפתח של חשבון השירות שהורדתם.

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

דוגמה

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

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