מערך הגדרות אישיות הוא קבוצה של מאפיינים של Distributed Cloud CLI שקיבלה שם ייחודי. המאפיינים האלה הם צמדים של מפתח-ערך המסודרים במקטעים, שקובעים את ההתנהגות של ה-CLI של gcloud.
המאפיינים שמאוחסנים בדרך כלל בהגדרות האישיות כוללים את כתובת ה-URL של מסוף הארגון ומזהה הפרויקט. מערכי ההגדרות האישיות מאפשרים ליצור ולהפעיל את ההגדרות האלה ואחרות ביחד כקבוצה.
מערכי ההגדרות האישיות מאוחסנים בספריית ההגדרות האישיות של המשתמש, בדרך כלל
~/.config/gdcloud ב-Linux, $HOME/Library/Application Support/gdcloud ב-Mac ו-%AppData%\gdcloud ב-Windows. חשוב גם לזכור שאפשרות הרשאות הכתיבה לספריית ההגדרות צריכה להיות מופעלת.
אם יש לכם כמה מערכים של הגדרות אישיות, אפשר לעבור ביניהם או להריץ פקודות באמצעות מערך ספציפי של הגדרות (בעזרת הדגל --configuration). לקבלת מידע נוסף על מעבר בין מערכים של הגדרות אישיות, קראו את הסעיף בנושא הפעלת הגדרות אישיות.
כדי לקרוא על מערכי הגדרות אישיות משורת הפקודה ולהציג רשימה של כל המאפיינים הזמינים והמקטעים שבהם הם נמצאים, מריצים את הפקודה gdcloud topic
configurations.
הגדרות ברירת מחדל
ה-CLI של gcloud יוצר בהתחלה מערך הגדרות אישיות אחד בשם default. תוכלו לקבוע מאפיינים ישירות במערך ההגדרות האישיות שלכם באמצעות הפקודה gdcloud
init או הפקודה gdcloud config set.
מערכים מרובים של הגדרות אישיות
המערך היחיד של הגדרות אישיות default מתאים לתרחישי שימוש רבים. אבל אפשר גם ליצור מערכים נוספים של הגדרות אישיות ולעבור ביניהם בהתאם לצורך באמצעות gdcloud config configurations activate. מערך default הראשוני נוצר כדי להתחיל בעבודה בקלות, אבל לא חייבים להשתמש בו. תוכלו לתת למערך ההגדרות האישיות הזה, או לכל מערך אחר, כל שם שיתאים לצרכים שלכם.
שימוש בכמה מערכי הגדרות אישיות מתאים למקרים הבאים:
- כאשר יש לכם כמה פרויקטים, אפשר ליצור מערך נפרד של הגדרות אישיות לכל אחד מהם ולעבור ביניהם לפי הצורך.
- שימוש בכמה כתובות URL של מסוף הארגון.
- לביצוע משימות נפרדות באופן כללי: לדוגמה, עם מערך הגדרות אישיות אחד אפשר לעבוד על שירות א' בפרויקט אחד ולנהל בנפרד שירות ב' בפרויקט אחר.
יצירת הגדרה
כדי ליצור מערך הגדרות אישיות, מריצים את הפקודה:
gdcloud config configurations create NAME
כדי להשתמש במערך ההגדרות האישיות החדש, צריך להפעיל אותו אחרי שיוצרים אותו.
הפעלת מערך הגדרות אישיות
רק מערך אחד של הגדרות אישיות יכול להיות פעיל ברגע נתון. המערך הפעיל של ההגדרות האישיות הוא המערך שהמאפיינים שלו יקבעו את ההתנהגות של ה-CLI של gcloud.
כדי להפעיל מערך חדש של הגדרות אישיות או לעבור למערך פעיל חדש, מריצים את הפקודה:
gdcloud config configurations activate NAME
הקוד gdcloud config list תמיד יציג את המאפיינים במערך ההגדרות האישיות הפעיל.
כדי להחליף את המערך הפעיל של הגדרות אישיות לצורך הזנה וביצוע של פקודה אחת, משתמשים בדגל --configuration בכל פקודה ב-CLI של gcloud.
gdcloud auth print-identity-token --configuration=CONFIGURATION
הצגת רשימה של מערכי הגדרות אישיות
כדי להציג רשימה של מערכי ההגדרות האישיות ב-CLI של gcloud, מריצים את הפקודה:
gdcloud config configurations list
ה-CLI של gcloud מציג רשימה של מערכי ההגדרות האישיות ומראה איזה מהם פעיל:
NAME ISACTIVE PROPERTIES.CORE.PROJECT PROPERTIES.CORE.ORGANIZATIONCONSOLEURL
default False example-project-default https://console.default-org.example.com
config-project-1 False example-project-1 https://console.org-1.example.com
config-project-2 False example-project-2 https://console.org-2.example.com
קביעת המאפיינים של מערך הגדרות אישיות
כדי להגדיר או לבטל את ההגדרה של מאפיין במערך הפעיל של הגדרות אישיות מריצים את הפקודה:
gdcloud config set project PROJECT
הצגת המאפיינים של מערך הגדרות אישיות
כדי להציג את המאפיינים של מערך הגדרות אישיות מריצים את הקוד:
gdcloud config configurations describe NAME
ה-CLI של gcloud מדפיס את המאפיינים של מערך ההגדרות האישיות:
is_active: false
name: default
properties:
accessibility:
screen_reader: "false"
core:
organization_console_url: https://console.example.com
project: example-project
כדי להציג את המאפיינים במערך הפעיל של ההגדרות האישיות, מריצים את הפקודה:
gdcloud config list
מחיקת הגדרה
כדי למחוק הגדרה, מריצים את הפקודה:
gdcloud config configurations delete NAME
אי אפשר למחוק הגדרה פעילה. כדי לעבור למערך הגדרות אישיות אחר לפני המחיקה, אפשר להשתמש ב-gdcloud config configurations activate.