מפתחות מטא-נתונים מוגדרים מראש

מפתחות מטא-נתונים מוגדרים מראש והערכים שלהם מספקים מידע על המכונה ועל הפרויקט. אפשר להשתמש במקשים האלה כדי לשלוט בהתנהגויות שונות של המופע.

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

אתם יכולים לעדכן את הערכים של המפתחות המוגדרים מראש האלה. הערכים של המפתחות הם תלויי-אותיות-רישיות. עם זאת, אי אפשר לשנות את המקשים עצמם. כשמבינים את מפתחות המטא-נתונים שנמצאים בספריות המטא-נתונים instance/ ו-project/, אפשר לבצע אופטימיזציה של ביצועי המופע, לפתור בעיות בהגדרות ולשמור על סביבת מחשוב אמינה.

במאמר מידע על מטא-נתונים של מכונות וירטואליות מוסבר איך מוגדרים, מסווגים ומסודרים מטא-נתונים של מכונות וירטואליות ב-Compute Engine.

מפתחות מטא-נתונים מוגדרים מראש של פרויקט

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

  • http://metadata.google.internal/computeMetadata/v1/project/

בטבלה הבאה מפורטים מפתחות מטא-נתונים וספריות ש-Compute Engine יוצר באופן אוטומטי בספריית המטא-נתונים project/:

רשומה של מטא-נתונים תיאור
attributes/

ספרייה של ערכי מטא-נתונים מותאמים אישית שמועברים למכונות הווירטואליות בפרויקט במהלך ההפעלה או הכיבוי. הערכים המותאמים אישית האלה יכולים להיות Cloud de Confiance by S3NS מאפיינים או ערכים של מטא-נתונים שנוצרו על ידי המשתמש.

רשימה של מאפייני Cloud de Confiance by S3NS ברמת הפרויקט שאפשר להגדיר מופיעה במאמר מאפייני פרויקט.

למידע נוסף: הגדרת מטא-נתונים בהתאמה אישית.
numeric-project-id מזהה הפרויקט המספרי (מספר הפרויקט) של המכונה, שהוא לא אותו דבר כמו שם הפרויקט שמופיע ב- Cloud de Confiance console. הערך הזה שונה מהערך של רשומת המטא-נתונים project-id.
project-id מזהה הפרויקט.

מפתחות מטא-נתונים מוגדרים מראש של מאפייני פרויקטים

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

  • http://metadata.google.internal/computeMetadata/v1/project/attributes/

בטבלה הבאה מפורטים מפתחות מטא-נתונים שאם הם מוגדרים לפרויקט, מערכת Compute Engine יוצרת אותם בספריית המטא-נתונים project/attributes/, לצד ההשפעה המשויכת שלהם:

רשומה של מטא-נתונים תיאור
disable-legacy-endpoints

השבתת נקודות הקצה של שרת המטא-נתונים מדור קודם בכל המכונות הווירטואליות בפרויקט.

נקודות קצה מדור קודם הוצאו משימוש, תמיד מוגדר disable-legacy-endpoints=TRUE.

enable-guest-attributes

הגדרת מאפייני אורח לפרויקט.

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

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

enable-os-inventory

הפעלה או השבתה של מלאי מערכות הפעלה בפרויקט.

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

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

enable-windows-ssh

הפעלה או השבתה של SSH למכונות וירטואליות של Windows.

מידע נוסף זמין במאמר איך מתחברים למכונות וירטואליות של Windows באמצעות SSH.

google-compute-default-data-protection

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

מידע נוסף זמין במאמר הגדרת ברירת המחדל לגיבוי במסוף.
google-compute-default-region אם המדיניות מוגדרת, היא שומרת את אזור ברירת המחדל שבו נעשה שימוש בפרויקט.

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

google-compute-default-zone אם המאפיין מוגדר, הוא מאחסן את אזור ברירת המחדל שבו הפרויקט משתמש.

למידע נוסף על הגדרת אזורי ברירת מחדל, ראו אזור ברירת מחדל ואזור זמין כברירת מחדל.

ssh-keys

אם אתם מנהלים מפתחות SSH באמצעות מטא-נתונים, המאפיין הזה מאפשר לכם להגדיר מפתחות SSH ציבוריים שיכולים להתחבר למכונות וירטואליות בפרויקט הזה. אם יש כמה מפתחות SSH, כל מפתח מופרד באמצעות תו של שורה חדשה (\n). הערך של המאפיין ssh-keys הוא מחרוזת.

לדוגמה: "user1:ssh-rsa mypublickey user1@host.com\nuser2:ssh-rsa mypublickey user2@host.com"

sshKeys הוצא משימוש: אפשר להשתמש ב-ssh-keys.
vmdnssetting

מפעילים DNS אזורי ו-DNS גלובלי למכונות הווירטואליות בפרויקט.

מידע נוסף על שימוש בשמות DNS אזוריים למכונות וירטואליות זמין במאמר שימוש ב-DNS אזורי לסוג ה-DNS הפנימי.

מפתחות מטא-נתונים מוגדרים מראש של מופעים

מפתחות מטא-נתונים מוגדרים מראש של מטא-נתונים של מופע מאוחסנים בספרייה הבאה:

  • http://metadata.google.internal/computeMetadata/v1/instance/

בטבלה הבאה מפורטים מפתחות מטא-נתונים וספריות ש-Compute Engine יוצר באופן אוטומטי בספריית המטא-נתונים instance/:

רשומה של מטא-נתונים תיאור
attributes/

ספרייה של ערכי מטא-נתונים בהתאמה אישית שמועברים למכונה הווירטואלית במהלך ההפעלה או הכיבוי. הערכים המותאמים אישית האלה יכולים להיות Cloud de Confiance by S3NS מאפיינים או ערכים של מטא-נתונים שנוצרו על ידי המשתמש.

רשימת Cloud de Confiance by S3NS המאפיינים ברמת המכונה שאפשר להגדיר

מידע נוסף על הגדרת מטא-נתונים מותאמים אישית זמין במאמר בנושא הגדרת מטא-נתונים מותאמים אישית.
cpu-platform

פלטפורמת המעבד (CPU) של ה-VM.

מידע על פלטפורמות CPU זמין במאמר בנושא פלטפורמות CPU.
description תיאור בטקסט חופשי של מכונה שמוקצה באמצעות הדגל --description, באמצעות Google Cloud CLI או ה-API.
disks/

ספרייה של דיסקים שמצורפים ל-VM. לכל דיסק מוצגים הפרטים הבאים:

  • device-name
  • index
  • interface
  • mode
  • type

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

gce-workload-certificates/ (הוצאה משימוש)

התכונה מאחסנת את נקודות הקצה הבאות עבור הזהויות המנוהלות של עומסי העבודה שמשמשות אפליקציות שפועלות במכונה הווירטואלית.

  • ‫config-status: מכיל שגיאות בערכי ההגדרות שסופקו דרך המטא-נתונים של המכונה הווירטואלית.
  • ‫workload-identities: מכיל את הזהויות שמנוהלות על ידי מישור הבקרה של Compute Engine. נקודת הקצה הזו מכילה את אישור X.509 ואת המפתח הפרטי של מתחם האמון (trust domain) של המכונה הווירטואלית.
  • ‫trust-anchors: מכיל קבוצה של אישורים מהימנים לאימות שרשרת אישורי X.509 של עמיתים.

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

guest-attributes/

הגדרת מאפייני אורח למכונה הווירטואלית. הערכים המותאמים אישית האלה יכולים להיות Cloud de Confiance by S3NS מאפיינים או ערכים של מטא-נתונים שנוצרו על ידי המשתמש.

רשימה של מאפיינים ברמת המכונה Cloud de Confiance by S3NS שאפשר להגדיר מופיעה במאמר מאפייני אורח של מכונה.

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

hostname שם המארח של המכונה הווירטואלית.
id המזהה של המכונה הווירטואלית. זהו מזהה מספרי ייחודי שנוצר על ידי Compute Engine לפרויקט ולאזור של ה-VM. אתם יכולים להשתמש במזהה הזה כדי לזהות את המכונה הווירטואלית, במיוחד אם לא הקציתם לה שם בהתאמה אישית.
image קובץ האימג' של מערכת ההפעלה שמשמש את ה-VM. הערך הזה צריך להיות בפורמט הבא: projects/IMAGE_PROJECT/global/images/IMAGE_NAME.
legacy-endpoint-access/ מאחסן את רשימת נקודות הקצה מדור קודם. הערכים האפשריים הם 0.1 ו-v1beta1.
licenses/ רשימה של מזהי קודי רישיון שמשמשים לצירוף הרישיונות לתמונות, לתמונות מצב ולדיסקים.
machine-type סוג המכונה של ה-VM הזה. הערך הזה הוא בפורמט הבא: projects/PROJECT_NUM/machineTypes/MACHINE_TYPE
maintenance-event מציין אם אירוע תחזוקה משפיע על המכונה הווירטואלית הזו. מידע נוסף זמין במאמר בנושא מיגרציה פעילה.
name שם המכונה הווירטואלית.
network-interfaces/

ספרייה של ממשקי רשת. לכל ממשק רשת זמין המידע הבא:

  • ‫access-configs/: הספרייה שמכילה את הגדרות הגישה לממשק הזה. רק 0/ נתמך, והוא מכיל פרטים של הגדרת גישה ל-NAT אחד-לאחד. בקטע access-configs/0/:
    • ‫external-ip: כתובת ה-IP החיצונית של הממשק הזה.
    • ‫type: סוג הגדרת הגישה. ONE_TO_ONE_NAT הוא הערך היחיד שזמין כרגע.
  • ‫dns-servers: רשימה של שרתי שמות DNS לממשק הזה.
  • ‫forwarded-ips/: ספרייה שמכילה כתובות IP שמועברות למופע הזה באמצעות איזון עומסים או העברת פרוטוקולים. כל רשומה היא כתובת IP.
  • ‫forwarded-ipv6s/: ספרייה שמכילה טווחי CIDR של IPv6 שהועברו למופע הזה באמצעות איזון עומסים או העברת פרוטוקולים. כל רשומה היא טווח CIDR של IPv6.
  • ‫gateway: כתובת השער של ממשק הרשת הזה.
  • ‫gateway-ipv6: כתובת שער IPv6 של ממשק הרשת הזה.
  • ‫ip: כתובת ה-IP הפנימית שהוקצתה לממשק הרשת הזה.
  • ‫ip-aliases/: ספרייה שמכילה טווחי כתובות IP וירטואליות שהוקצו לממשק הרשת הזה. כל רשומה היא טווח של כתובות IP וירטואליות.
  • ‫ipv6: רשימה של טווחי CIDR של IPv6 שהוקצו לממשק הרשת.
  • ‫ipv6s: רשימה של כתובות IPv6 או קידומות שהוקצו לממשק הרשת.
  • ‫mac: כתובת ה-MAC של ממשק הרשת הזה.
  • ‫mtu: ערך ה-MTU של ממשק הרשת הזה.
  • ‫network: הרשת של הממשק הזה, בפורמט projects/PROJECT_ID/networks/NETWORK_NAME.
  • ‫subnetmask: מסכה של רשת משנה עבור ממשק הרשת הזה.
  • ‫target-instance-ips: רשימת כתובות ה-IP הפנימיות של כללי העברה שמטרגטים את המכונה הזו.

מידע נוסף על ממשקי רשת זמין במאמר סקירה כללית של ממשקי רשת מרובים.

partner-attributes/ (הוצאה משימוש)

ספרייה שמכילה מרחבי שמות שבהם מאוחסנים רשומות של מטא-נתונים. מרחבי השמות נוצרים על ידי Cloud de Confiance שירותים, שמשתמשים במאפייני שותף כדי לאחסן את ההגדרות שלהם. אם אין שירותים שמשתמשים במאפייני השותף, הספרייה ריקה.

לדוגמה, Workload Identity מנוהל משתמש במאפייני שותפים בהגדרות שלו.

preempted

ערך בוליאני שמציין אם מכונה וירטואלית עומדת להידחק.
scheduling/

הגדרת אפשרויות התזמון של המכונה הווירטואלית.

ערכי המטא-נתונים של התזמון כוללים את הפרטים הבאים:

  • ‫on-host-maintenance: מציין אם המכונה הווירטואלית (VM) מסיימת את הפעולה או עוברת מיגרציה פעילה במהלך תחזוקת המארח.
  • ‫automatic-restart: אם הערך הוא TRUE, המכונה הווירטואלית מופעלת מחדש באופן אוטומטי אחרי אירוע תחזוקה או קריסה.
  • ‫preemptible: אם הערך הזה הוא TRUE, המכונה הווירטואלית ניתנת להפסקת פעולה. הערך הזה מוגדר כשיוצרים מכונה וירטואלית, ואי אפשר לשנות אותו.

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

service-accounts/

ספרייה של חשבונות שירות שמשויכים למכונה הווירטואלית. לכל חשבון שירות, הפרטים הבאים זמינים:

  • aliases
  • ‫email: כתובת האימייל של חשבון השירות.
  • ‫identity: אסימון JSON Web Token שייחודי למכונה הווירטואלית. כדי לקבל את ערך המטא-נתונים הזה של המכונה הווירטואלית, צריך לכלול את הפרמטר audience בבקשה. לדוגמה, ?audience=http://www.example.com.

    במאמר אימות הזהות של מכונה וירטואלית מוסבר איך לבקש ולאמת אסימוני זהות של מכונות.

  • ‫scopes: היקפי הגישה שהוקצו לחשבון השירות.
  • ‫token: אסימון הגישה OAuth2 שאפשר להשתמש בו כדי לאמת אפליקציות.

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

מידע נוסף על השימוש בחשבונות שירות ב-Compute Engine זמין במאמר חשבונות שירות.

tags

רשימה של תגי הרשת שמשויכים למכונה הווירטואלית.

למידע נוסף על תגי רשת, קראו את המאמר הוספת תגי רשת.
virtual-clock/drift-token

הסטיות המצטברות של השעון במכונה הווירטואלית. הערך מאותחל לאפס במהלך יצירת המכונה, וגדל בהתאם להפרש השעון המצטבר בזמן המיגרציה הפעילה של ה-VM.
zone האזור שבו נמצאת המכונה הווירטואלית הזו. הערך הזה הוא בפורמט הבא: projects/PROJECT_NUM/zones/ZONE

מפתחות מטא-נתונים מוגדרים מראש של מאפייני מכונות

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

  • http://metadata.google.internal/computeMetadata/v1/instance/attributes/

בטבלה הבאה מפורטים מפתחות מטא-נתונים שאם הם מוגדרים למופע, Compute Engine יוצר אותם בספריית המטא-נתונים instance/attributes/, יחד עם ההשפעה המשויכת שלהם:

רשומה של מטא-נתונים תיאור
physical_host_topology

מחרוזת hash שמייצגת את המיקום הפיזי של מכונה וירטואלית בתחום.

מידע נוסף על המאפיין הזה זמין במאמר אימות המיקום הפיזי של מכונה וירטואלית.

enable-windows-ssh (תצוגה מקדימה)

הפעלה או השבתה של SSH למכונות וירטואליות של Windows.

מידע נוסף זמין במאמר התחברות למכונות וירטואליות של Windows באמצעות SSH.

enable-workload-certificate (הוצאה משימוש)

הגדרה שמאפשרת או משביתה Workload Identity מנוהלים במכונה וירטואלית.

מידע נוסף זמין במאמר הפעלת Workload Identity מנוהל למכונות וירטואליות ספציפיות.
vmdnssetting

מפעילים DNS אזורי ו-DNS גלובלי למכונה הווירטואלית.

מידע נוסף על שימוש בשמות DNS אזוריים עבור ה-DNS של המכונות הווירטואליות זמין במאמר שימוש ב-DNS אזורי עבור סוג ה-DNS הפנימי.

ssh-keys

אם אתם מנהלים את מפתחות ה-SSH באמצעות מטא-נתונים, המאפיין הזה מאפשר לכם להגדיר מפתחות SSH ציבוריים שיכולים להתחבר למכונות וירטואליות בפרויקט הזה. אם יש כמה מפתחות SSH, כל מפתח מופרד באמצעות תו של שורה חדשה (\n). הערך של מאפיין ssh-keys הוא מחרוזת.

דוגמה: "user1:ssh-rsa mypublickey user1@host.com\nuser2:ssh-rsa mypublickey user2@host.com"

block-project-ssh-keys

חסימה של מפתחות SSH של פרויקט ממכונות וירטואליות שמשתמשות במפתחות SSH שמבוססים על מטא-נתונים.

מידע נוסף זמין במאמר הגבלת מפתחות SSH ממכונות וירטואליות.
disable-https-mds-setup

ההגדרה הזו משביתה את ההקצאה האוטומטית של אישור שרת מטא-נתונים של HTTPS על ידי Compute Engine.

מידע נוסף זמין במאמר הפעלת הגדרה אוטומטית של אישורים.
enable-https-mds-native-cert-store

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

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

מפתחות מטא-נתונים מוגדרים מראש של מאפייני אורחים

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

  • http://metadata.google.internal/computeMetadata/v1/instance/guest-attributes/

בטבלה הבאה מופיעה רשימה של מפתחות מטא-נתונים וספריות שנוצרים באופן אוטומטי על ידי Compute Engine בספריית המטא-נתונים instance/guest-attributes/:

רשומה של מטא-נתונים תיאור
guestInventory/

שמירת מלאי מערכת ההפעלה של המכונה הווירטואלית.

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

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

hostkeys/

מאחסן מפתחות מארח SSH. אפשר להשתמש במפתחות מארח כדי לזהות מארח או מכונה מסוימים.

מידע על מפתחות מארח זמין במאמר בנושא אחסון מפתחות מארח על ידי הפעלת מאפייני אורח.

מה השלב הבא?