ניהול המאפיינים ב-CLI של gcloud

המאפיינים הם ההגדרות שמנהלות את ההתנהגות של ה-CLI של gcloud.

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

מאפיינים ודגלים

ב-CLI של gcloud יש תמיכה בכמה דגלים כלליים ודגלי פקודות שמתפקדים בדיוק כמו המאפיינים ב-CLI של gcloud. לדוגמה, ב-CLI של gcloud יש תמיכה בדגל --project וגם במאפיין project. מאפיינים מאפשרים לקבוע הגדרות לביצוע מספר גדול של פקודות, בעוד הדגלים משפיעים על ההתנהגות של הפקודות בכל ביצוע בנפרד. שימו לב שהשפעת הדגלים גוברת על הגדרת המאפיינים כאשר מגדירים את שניהם.

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

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

הצגת רשימה של מאפיינים

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

gcloud config list

ה-CLI של gcloud מחזיר רשימה של מאפיינים:

[compute]
region = us-east1
zone = us-east1-d
[core]
account = user@google.com
disable_usage_reporting = False
project = example-project
[metrics]
command_name = gcloud.config.list

הגדרת מאפיינים

כדי להגדיר מאפיין במערך ההגדרות הפעיל מריצים את gcloud config set. בדוגמה הבאה המאפיין project מוגדר כאשר PROJECT_ID הוא המזהה הייחודי של הפרויקט.

gcloud config set project PROJECT_ID

כדי להגדיר מאפיינים שלא נמצאים במקטע המאפיינים core, מציינים את המקטע ולאחריו קו נטוי לפנים לפני שם המאפיין. בדוגמה הבאה שם התחום (zone) נקבע כ-us-east1-b.

gcloud config set compute/zone us-east1-b

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

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

CLOUDSDK_CORE_PROJECT=PROJECT_NAME

CLOUDSDK_COMPUTE_ZONE=ZONE_NAME

ביטול ההגדרה של מאפיינים

אפשר לבטל את ההגדרה של מאפיין במערך ההגדרות הפעיל בעזרת gcloud config unset:

gcloud config unset disable_usage_reporting

מאפיינים זמינים

כדי להציג רשימה של כל המאפיינים מריצים את gcloud topic configurations או את gcloud config set --help ומחפשים את המקטע Available Properties (מאפיינים זמינים).

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