ניהול ההגדרות האישיות ב-CLI של gcloud

מערך הגדרות אישיות הוא קבוצה של מאפייני Google Cloud CLI שקיבלה שם ייחודי. המאפיינים האלו הם צמדים של מפתח-ערך המסודרים במקטעים, שקובעים את ההתנהגות של ה-CLI של gcloud.

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

מערכי ההגדרות האישיות מאוחסנים בספריית ההגדרות האישיות של המשתמש (בדרך כלל ~/.config/gcloud ב-MacOs וב-Linux, או %APPDATA%\gcloud ב-Windows). תוכלו למצוא את המיקום של ספריית ההגדרות שלכם על ידי הרצת הקוד gcloud info --format='value(config.paths.global_config_dir)'. אפשר לשנות את ספריית ההגדרות על ידי שינוי הערך של משתנה הסביבה CLOUDSDK_CONFIG. חשוב גם לזכור שאפשרות הרשאות הכתיבה לספריית ההגדרות צריכה להיות מופעלת. עם זאת, כשמשתמשים ב-Cloud Shell, ההעדפות האישיות של ה-CLI של gcloud מאוחסנות בתיקיית tmp זמנית, שהוגדרה עבור הכרטיסייה של Cloud Shell בלבד, ולא נשמרות מהפעלה אחת להפעלה הבאה אחריה.

אם יש לכם כמה מערכים של הגדרות אישיות, אפשר לעבור ביניהם או להריץ פקודות באמצעות מערך ספציפי של הגדרות (בעזרת הדגל --configuration). לקבלת מידע נוסף על מעבר בין מערכים של הגדרות אישיות, קראו את הסעיף הבא שעוסק בהפעלת הגדרות אישיות.

כדי לקרוא על מערכי הגדרות אישיות משורת הפקודה (ולהציג רשימה של כל המאפיינים הזמינים והמקטעים שבהם הם נמצאים), הריצו את הקוד gcloud topic configurations.

הגדרות ברירת מחדל

ה-CLI של gcloud מתחיל לפעול עם מערך הגדרות אישיות אחד בשם default. תוכלו לקבוע מאפיינים ישירות במערך ההגדרות האישיות שלכם באמצעות הפקודה gcloud init או הפקודה gcloud config set.

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

gcloud config set disable_prompts true

מערכים מרובים של הגדרות אישיות

המערך היחיד של הגדרות אישיות default מתאים לתרחישי שימוש רבים. אבל אפשר גם ליצור מערכים נוספים של הגדרות אישיות ולעבור ביניהם בהתאם לצורך באמצעות gcloud config configurations activate. למערך default הראשוני אין חשיבות מיוחדת והוא קיים רק כדי להתחיל בעבודה בקלות. תוכלו לתת למערך ההגדרות האישיות הזה, או לכל מערך אחר, כל שם שיתאים לצרכים שלכם.

שימוש בכמה מערכי הגדרות אישיות מתאים למקרים הבאים:

  • כאשר יש לכם כמה פרויקטים, אפשר ליצור מערך נפרד של הגדרות אישיות לכל אחד מהם ולעבור ביניהם לפי הצורך.
  • כאשר משתמשים בכמה חשבונות להרשאות
  • לביצוע משימות נפרדות באופן כללי: לדוגמה, עם מערך הגדרות אישיות אחד אפשר לעבוד על אפליקציה ב-App Engine בפרויקט אחד ולנהל בנפרד מכונות Compute Engine בפרויקט אחר.

יצירת מערך הגדרות אישיות

כדי ליצור מערך הגדרות אישיות מריצים את הקוד gcloud config configurations create:

gcloud config configurations create [NAME]

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

הפעלת מערך הגדרות אישיות

רק מערך אחד של הגדרות אישיות יכול להיות פעיל ברגע נתון. המאפיינים של המערך הפעיל של ההגדרות האישיות יקבעו את ההתנהגות של ה-CLI של gcloud.

כדי להפעיל מערך חדש של הגדרות אישיות או לעבור למערך פעיל חדש, מריצים את הקוד: gcloud config configurations activate:

gcloud config configurations activate [NAME]

הקוד gcloud config list תמיד יציג את המאפיינים במערך ההגדרות האישיות הפעיל.

כדי להחליף את המערך הפעיל של הגדרות אישיות לצורך הזנה וביצוע של פקודה אחת, משתמשים בדגל --configuration בכל פקודה ב-CLI של gcloud.

gcloud auth list --configuration=[CONFIGURATION_NAME]

כדי להחליף את המערך הפעיל של הגדרות אישיות עבור כל הפקודות בטרמינל הנוכחי, מגדירים את הערך של משתנה הסביבה CLOUDSDK_ACTIVE_CONFIG_NAME לשם של מערך ההגדרות שבו אתם רוצים להשתמש.

החלפה אוטומטית של מערכי הגדרות אישיות

כלים כמו direnv ו-ondir יכולים לאפשר מעבר אוטומטי וחלק בין מערכי הגדרות אישיות כאשר אתם מחליפים ספריות עבודה. דרך אחת לעשות זאת היא להגדיר את משתנה הסביבה הנחוץ (כמו CLOUDSDK_ACTIVE_CONFIG_NAME) בקובץ ‎.envrc בספריית השורש של הפרויקט.

הצגת רשימה של מערכי הגדרות אישיות

כדי להציג רשימה של מערכי ההגדרות האישיות בהתקנת ה-CLI של gcloud מריצים את הקוד gcloud config configurations list:

gcloud config configurations list

ה-CLI של gcloud מציג רשימה של מערכי ההגדרות האישיות ומראה איזה מהם פעיל.

NAME         IS_ACTIVE     ACCOUNT            PROJECT               DEFAULT_ZONE  DEFAULT_REGION
default      False         user@gmail.com     example-project-1     us-east1-b    us-east1
project-1    False         user@gmail.com     example-project-2     us-east1-c    us-east1
project-2    True          user@gmail.com     example-project-3     us-east1-b    us-east1

קביעת המאפיינים של מערך הגדרות אישיות

כדי להגדיר או לבטל את ההגדרה של מאפיין במערך הפעיל של הגדרות אישיות מריצים את הקוד gcloud config set ואת הקוד gcloud config unset:

gcloud config set project [PROJECT]

gcloud config unset project

אפשר להגדיר את המאפיינים גם דרך משתנה הסביבה שנקרא CLOUDSDK_SECTION_NAME_PROPERTY_NAME. לדוגמה, אפשר להגדיר את המאפיינים core/project ו-compute/zone באופן הבא:

CLOUDSDK_CORE_PROJECT=[YOUR_PROJECT_NAME]

CLOUDSDK_COMPUTE_ZONE=[YOUR_ZONE_NAME]

הצגת המאפיינים של מערך הגדרות אישיות

כדי להציג את המאפיינים של מערך הגדרות אישיות מריצים את הקוד: gcloud config configurations describe:

gcloud config configurations describe [NAME]

או כדי להציג את המאפיינים במערך הפעיל של ההגדרות האישיות:

gcloud config list

ה-CLI של gcloud מדפיס את המאפיינים של מערך ההגדרות האישיות:

is_active: false
name: default
properties:
  compute:
    region: us-east1
    zone: us-east1-b
  core:
    account: user@google.com
    project: example-project

מחיקת מערך של הגדרות אישיות

כדי למחוק מערך של הגדרות אישיות מריצים את הקוד: gcloud config configurations delete:

gcloud config configurations delete [NAME]

אי אפשר למחוק את המערך הפעיל של הגדרות אישיות. במקרה הצורך, אפשר לעבור בעזרת gcloud config configurations activate למערך הגדרות אישיות אחר לפני המחיקה.

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