שם
gdcloud topic configurations - Supplementary help for named configurations.
תיאור
אפשר לאחסן את המאפיינים של gdcloud CLI במערכי הגדרות אישיות עם שם, שהם אוספים של צמדי מפתח-ערך שמשפיעים על ההתנהגות של gdcloud CLI.
הגדרות אישיות עם שם מועילות אם מנהלים יותר מפרויקט אחד או מארגון אחד.
המאפיינים שמאוחסנים בדרך כלל בהגדרות האישיות כוללים את כתובת ה-URL של מסוף הארגון ומזהה הפרויקט. מערכי ההגדרות האישיות מאפשרים ליצור ולהפעיל את ההגדרות האלה ואחרות ביחד כקבוצה.
נתוני ההגדרה מאוחסנים ב-$HOME/.config/gdcloud/.
הגדרות שימושיות במיוחד אם אתם:
+ עובדים עם כמה פרויקטים. אפשר ליצור הגדרה נפרדת לכל פרויקט.
– שימוש בכמה כתובות URL של מסוף הארגון.
* ביצוע משימות נפרדות באופן כללי לדוגמה, אפשר להשתמש בהגדרה אחת כדי לעבוד על שירות Object Storage בפרויקט אחד ולנהל שירות לא קשור בפרויקט אחר.
כל הפקודות ב-CLI של gcloud יכולות לקרוא את פרטי המאפיינים שמאוחסנים בהגדרות אישיות שקיבלו שם ייחודי. כדי להגדיר את המאפיינים, משתמשים בפקודה gdcloud config set.
יצירת הגדרות
משתמשים יכולים להגדיר תצורות בעלות שם, או להשתמש בתצורות מובנות ב-CLI של gcloud.
ההגדרות שמוגדרות על ידי המשתמשים כוללות שמות באותיות קטנות, כמו johndoe, default, jeff-staging או foo2. הם מוגדרים על ידי הביטוי הרגולרי הבא ^[a-z][-a-z0-9]*$.
כדי ליצור הגדרה חדשה, מריצים את הפקודה
gdcloud init
במדריך הזה מוסבר איך להגדיר את ההגדרה הראשונה בעלת שם, ליצור הגדרה חדשה בעלת שם או לאתחל מחדש הגדרה קיימת בעלת שם. שימו לב: אתחול מחדש של הגדרה קיימת מסיר את כל המאפיינים הקיימים שלה.
כדי ליצור הגדרה ריקה חדשה, מריצים את הפקודה
gdcloud config configurations create [CONFIG_NAME]
שימוש בהגדרות
ל-CLI של gcloud צריך להיות לכל היותר מערך הגדרות פעיל אחד שמספק ערכי מאפיינים. למערכי הגדרות אישיות לא פעילים אין השפעה על הפעלות של ה-CLI של gcloud. כדי להפעיל מערך הגדרות אישיות, מריצים את הפקודה
gdcloud config configurations activate [CONFIG_NAME]
כדי להציג ולשנות את המאפיינים של מערך ההגדרות הפעיל, מריצים את הפקודה
gdcloud config list
gdcloud config set
בנוסף, פקודות בקבוצה gdcloud config configurations מאפשרות לכם להציג רשימה של הגדרות אישיות, להפעיל, לשנות את השם, לתת תיאור ולמחוק הגדרות אישיות שעשויות להיות פעילות או לא פעילות.
כדי להפעיל מערך הגדרות אישיות לצורך הזנה וביצוע של פקודה אחת ב-gcloud, משתמשים בדגל --configuration my-config.
מאפיינים זמינים
accessibility
* screen_reader
* אם ההגדרה מופעלת, ה-CLI של gdcloud מפעיל את קורא המסך.
auth
* login_config_cert_path
* הנתיב של הקובץ שבו מאוחסן האישור של הגדרות הכניסה הנוכחיות.
component_manager
* disable_update_check
* אם ההגדרה הזו מוגדרת, ה-CLI של gdcloud לא בודק אוטומטית אם יש עדכונים.
core
* disable_prompts
* אם הערך הוא True, התשובה שמוגדרת כברירת מחדל מניחה את כל ההנחיות של המשתמשים. עם זאת, אם יש הנחיות שדורשות קלט של משתמשים, תופיע שגיאה.
* format
* הגדרת הפורמט של משאבי פלט של פקודות הדפסה. ברירת המחדל היא פורמט פלט ידידותי למשתמש שספציפי לפקודה. אם מציינים גם את core/format וגם את --format, המדיניות --format מקבלת עדיפות. הפורמטים הנתמכים הם csv, json, table, text ו-yaml.
* organization_console_url
* כתובת ה-URL של ממשק המשתמש או המסוף של הארגון הנוכחי. הערה: הערך צריך להתחיל ב-https //console.. לדוגמה, https //console.org-name.gdch.google.com.
* project
* שם הפרויקט הנוכחי.
storage
* s3_access_key_id
* מזהה מפתח הגישה של אובייקט האחסון ב-S3. זהו מזהה ייחודי של משתמשים.
* s3_custom_ca_certs_file
* קובץ אישורים בהתאמה אישית לאובייקט האחסון ב-S3.
* s3_endpoint
* כתובת ה-URL של אובייקט S3 מורכבת מ-S3_ENDPOINT/$BUCKET_NAME/$OBJECT_NAME. S3_ENDPOINT הוא המיקום שבו נמצאת קטגוריית האחסון ב-S3.
* s3_region
* השם של אזור S3 שבו נמצאת קטגוריית האחסון של S3. ברירת המחדל היא us-east-1.
* s3_secret_access_key
* המפתח הפרטי של אובייקט האחסון ב-S3 שמשמש לחתימה על בקשות.