הגדרת סוכן האורח

במסמך הזה מוסבר איך לנהל את שירות סוכן האורח ואיך להגדיר את התכונות שלו באמצעות עריכה של קובץ ההגדרות שלו.

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

הפעלה מחדש של סוכן האורח

סוכן האורח פועל כדמון במערכות הפעלה של Linux ו-Windows. ב-Linux, סוכן האורח מופעל כשירות systemd, וב-Windows הוא מופעל כשירות מערכת.

השלבים להפעלה מחדש משתנים בין מערכות הפעלה של Linux ו-Windows באופן הבא:

Linux

כדי להפעיל מחדש ב-Linux, בוחרים באחת מהאפשרויות הבאות:

  • בסוכן האורח בגרסה 20250901.00 ואילך, מריצים את הפקודה הבאה:

    ggactl_plugin coreplugin restart

  • בגרסאות קודמות של guest agent, מריצים את הפקודה הבאה:

    systemctl restart google-guest-agent

Windows

כדי להפעיל מחדש ב-Windows, בוחרים באחת מהאפשרויות הבאות:

  • בסוכן האורח בגרסה 20250901.00 ואילך, מריצים את הפקודה הבאה:

    ggactl_plugin coreplugin restart

  • בגרסאות קודמות של guest agent, משתמשים בפקודות PowerShell הבאות:

    1. כדי להפסיק את סוכן האורח: 

      Stop-Service GCEAgent

    2. כדי להפעיל את סוכן האורח: 

      Start-Service GCEAgent

    לחלופין, כדי להפעיל מחדש את סוכן האורח: 

    Restart-Service GCEAgent

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

עדכון קובץ ההגדרה של נציג אורח

כדי לשנות את ההתנהגות של סוכן האורח, אפשר לערוך את קובץ ההגדרות שלו, instance_configs.cfg. הקובץ הזה מאפשר להפעיל או להשבית תכונות ולהגדיר ערכי ברירת מחדל לפעולות.

כדי לערוך את קובץ instance_configs.cfg במערכות הפעלה של Linux ו-Windows, צריך לעיין בקטעים הבאים.

Linux

כדי לערוך את קובץ התצורה במכונת Linux וירטואלית:

  1. יוצרים או עורכים את קובץ ההגדרות שנמצא ב-/etc/default/instance_configs.cfg ומגדירים את האפשרות הנדרשת. רשימת האפשרויות מופיעה במאמר אפשרויות הגדרה.

    לדוגמה, כדי להתאים אישית את אופן היצירה של משתמשים חדשים ולציין אילו סוגים של מפתחות מארח SSH ליצור, יוצרים או מעדכנים את הקובץ עם התוכן הבא:

    [Accounts]
useradd_cmd = useradd -m -G google-sudoers
[InstanceSetup]
host_key_types = ecdsa,ed25519

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

קדימות של קובץ התצורה

הסוכן האורח קורא את הגדרות התצורה מ-/etc/default/instance_configs.cfg, ומהגרסאות .distro ו-.template שלו. הקבצים האלה מעובדים בהיררכיה ספציפית כדי לאפשר למשתמשים ולמערכות הפעלה מבוססות לינוקס להגדיר ברירות מחדל. סדר העדיפות, מהגבוה לנמוך, הוא כדלקמן:

  1. /etc/default/instance_configs.cfg.template (העדיפות הכי גבוהה)
  2. /etc/default/instance_configs.cfg.distro
  3. /etc/default/instance_configs.cfg (העדיפות הכי נמוכה)

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

Windows

במכונות וירטואליות של Windows, קובץ ההגדרות נמצא בנתיב C:\Program Files\Google\Compute Engine\instance_configs.cfg. פרטים על הגדרת הסוכן ב-Windows מופיעים במאמר הפעלה והשבתה של תכונות של מופע Windows.

אפשרויות להגדרות אישיות

בטבלאות הבאות מפורטות אפשרויות ההגדרה הזמינות לקובץ instance_configs.cfg.

חשבונות

משתמשים באפשרויות שבקטע Accounts בקובץ instance_configs.cfg כדי לשלוט בניהול של משתמשים וקבוצות על ידי סוכן האורחים.

אפשרות תיאור מערכת הפעלה ערך ברירת המחדל
deprovision_remove אם הערך מוגדר ל-true, סוכן האורח מסיר את חשבון המשתמש כשמבטלים את הקצאת ההרשאות למשתמש. כברירת מחדל (אם ההגדרה היא false), סוכן האורח מסיר את המשתמש רק מהקבוצה google-sudoers ומוחק את מפתחות ה-SSH שלו, אבל לא מסיר את חשבון המשתמש. Linux false
groups רשימה מופרדת בפסיקים של קבוצות למשתמשים חדשים. Linux adm,dip,docker,lxd,plugdev,video
useradd_cmd מגדיר את הפקודה שהנציג האורח מריץ כשיוצרים משתמש חדש. לדוגמה, כדי ליצור ספריית בית למשתמש ולהוסיף אותו לקבוצה google-sudoers, מגדירים את הערך useradd -m -G google-sudoers. Linux ברירת מחדל של המערכת
userdel_cmd מציינת את הפקודה שהסוכן של מערכת ההפעלה האורחת מריץ כדי למחוק משתמש כש-deprovision_remove הוא true. לדוגמה, מגדירים את האפשרות הזו לערך userdel -r כדי להסיר את ספריית הבית והקבצים של המשתמש. Linux ברירת מחדל של המערכת
usermod_cmd מגדירה את הפקודה שאמצעי הניהול של האורח מפעיל כשמשנים את הקבוצות של המשתמש. Linux ברירת מחדל של המערכת
gpasswd_add_cmd הגדרת הפקודה שהנציג האורח מריץ כשמוסיפים משתמש לקבוצה. Linux ברירת מחדל של המערכת
gpasswd_remove_cmd מגדיר את הפקודה שהסוכן האורח מריץ כשמסירים משתמש מקבוצה. Linux ברירת מחדל של המערכת
groupadd_cmd מגדיר את הפקודה שהסוכן לאורחים מריץ כשיוצרים קבוצה חדשה. Linux ברירת מחדל של המערכת

ליבה

משתמשים באפשרויות שבקטע Core בקובץ instance_configs.cfg כדי לשלוט בפונקציות הליבה של סוכן האורח.

אפשרות תיאור מערכת הפעלה ערך ברירת המחדל
acs_client אם ההגדרה היא false, התקשורת של נציג האורח עם מישור הבקרה של הנציג מושבתת. הפעולה הזו משביתה תכונות כמו תוספים דינמיים של מכונות וירטואליות וטלמטריה של סוכנים. ‫Linux ו-Windows true
cloud_logging_enabled אם הערך הוא false, סוכן האורח לא שולח יומני פעילות ל-Cloud Logging. ‫Linux ו-Windows true
log_file אם מגדירים את האפשרות הזו, יומני האורח של הסוכן נשמרים בקובץ מקומי. ‫Linux ו-Windows
log_level מגדיר את רמת הרישום ביומן של יומני הסוכן לאורחים. ההגדרה הזו חלה על כל היומנים שנוצרים על ידי סוכן האורח, ולא רק על Cloud Logging. ההגדרות והרמות הן:
  • ‫0 (FATAL): יומנים של שגיאות קריטיות שגורמות לסוכן להפסיק לפעול.
  • ‫1 (ERROR): יומנים של שגיאות שעשויות למנוע את הפעלת הסוכן.
  • ‫2 (WARN): מתעד תנאים שעלולים להיות מזיקים.
  • 3 (INFO): יומנים של הודעות מידע על פעילות הסוכן. זו הגדרת ברירת המחדל.
  • ‫4 (DEBUG): מידע על ניפוי באגים ביומנים. המידע הזה יכול להיות מפורט מאוד, אבל אפשר לצמצם את רמת הפירוט באמצעות האפשרות log_verbosity.
 ‫Linux ו-Windows 3
log_verbosity הגדרה של רמת הפירוט של היומנים ב-DEBUG. הערכים הקבילים הם מ-0 עד 4. ככל שהערך גבוה יותר, כך התשובה מפורטת יותר. ‫Linux ו-Windows 0
enable_local_plugins אם המדיניות מוגדרת כ-true, סוכן האורח מתקין באופן דינמי ומפעיל פלאגינים מקומיים שמאוחסנים בספריית הפלאגינים המקומית שהוגדרה. זמין בגרסה 20260228.00 ואילך של סוכן אורח. ‫Linux ו-Windows true

דימונים

משתמשים באפשרויות שבקטע Daemons בקובץ instance_configs.cfg כדי להפעיל או להשבית דמונים ספציפיים ברקע שמנוהלים על ידי סוכן האורח.

אפשרות תיאור מערכת הפעלה ערך ברירת המחדל
accounts_daemon אם הערך מוגדר ל-false, סוכן האורח משבית את ניהול חשבון המשתמש ומפתח ה-SSH. Linux true
clock_skew_daemon אם הערך מוגדר כ-false, סוכן האורח משבית את סנכרון השעון. Linux true
network_daemon אם המדיניות מוגדרת לערך false, סוכן האורח משבית את ניהול הרשת. Linux true

הגדרת מכונה

משתמשים באפשרויות שבקטע InstanceSetup בקובץ instance_configs.cfg כדי לשלוט במשימות שונות שמבצע סוכן האורח במהלך ההגדרה הראשונית של המופע.

אפשרות תיאור מערכת הפעלה ערך ברירת המחדל
host_key_types רשימה מופרדת בפסיקים של סוגי מפתחות מארח ליצירה. Linux ecdsa,ed25519,rsa
optimize_local_ssd אם המדיניות מוגדרת ל-false, האורח לא מבצע אופטימיזציה של Local SSD בזמן ההפעלה. Linux true
network_enabled אם הערך מוגדר ל-false, סוכן האורח מדלג על פונקציות להגדרת מכונה שדורשות מידע ממטא-נתונים. הגדרת האפשרות הזו כ-false משביתה גם את יצירת מפתח המארח ומונעת מסוכן האורח להגדיר את קובץ ההגדרות boto. ‫Linux ו-Windows true
set_boto_config אם הערך מוגדר כ-false, סוכן האורח לא יוצר או מעדכן את קובץ ההגדרות boto. יכול להיות שאפליקציות שמשתמשות בספריית Boto ומסתמכות על הגדרת ברירת המחדל של סוכן האורח לגישה ל-Cloud Storage לא יפעלו כמצופה בלי botoהגדרה ידנית. ‫Linux ו-Windows true
set_host_keys אם הערך מוגדר ל-false, סוכן האורח מדלג על יצירת מפתחות מארח ב-firstboot. Linux true
set_multiqueue אם ההגדרה היא false, סוכן האורח לא מנסה לבצע אופטימיזציה של ביצועי הרשת על ידי הפעלת תכונות של תורים מרובים עבור מנהלי ההתקנים של הרשת. כשמפעילים את true, הסוכן מגדיר את המערכת כך שתשתמש בכמה תורים לתעבורת נתונים ברשת, מה שעשוי לשפר את קצב העברת הנתונים ולהפחית את זמן האחזור. Linux true

העברת IP

משתמשים באפשרויות שבקטע IpForwarding בקובץ instance_configs.cfg כדי להגדיר איך סוכן האורח מנהל את העברת ה-IP והניתוב.

אפשרות תיאור מערכת הפעלה ערך ברירת המחדל
ethernet_proto_id מחרוזת מזהה הפרוטוקול של מסלולים שנוספו על ידי דמון. Linux 66
ip_aliases אם הערך מוגדר כ-false, סוכן האורח לא מגדיר נתיבי IP של כינויים. Linux true
target_instance_ips אם הערך הוא false, סוכן האורח לא מפעיל איזון עומסים של כתובות IP פנימיות. Linux true

זהויות מנוהלות של עומסי עבודה

משתמשים באפשרויות שבקטע MWLID בקובץ instance_configs.cfg כדי להגדיר את האתחול של פרטי הכניסה של Workload Identity.

אפשרות תיאור מערכת הפעלה ערך ברירת המחדל
enabled אם מגדירים את enabled=true, סוכן האורח מאתחל את פרטי הכניסה של Workload Identity בנתיבים הבאים במכונה הווירטואלית:
  • ‫Linux: ‏ /run/secrets/workload-spiffe-credentials
  • ב-Windows:‏ C:\ProgramData\Google\ComputeEngine\secrets\workload-spiffe-credentials‎
 ‫Linux ו-Windows false
credential_refresh_minutes התדירות, בדקות, שבה מתרעננים פרטי הכניסה של עומסי העבודה. ‫Linux ו-Windows 10 דקות

ביצוע סקריפט של מטא-נתונים

משתמשים באפשרויות שבקטע MetadataScripts בקובץ instance_configs.cfg כדי לשלוט בהרצה של סקריפטים של מטא-נתונים, כמו סקריפטים של הפעלה וכיבוי.

אפשרות תיאור מערכת הפעלה ערך ברירת המחדל
default_shell מעטפת ברירת המחדל להפעלת סקריפטים. Linux /bin/bash
run_dir ספריית הבסיס לביצוע סקריפט של מטא-נתונים. ‫Linux ו-Windows ברירת המחדל היא הספרייה הזמנית של מערכת ההפעלה. לדוגמה, /tmp ב-Linux. כדי לזהות את הספרייה הזמנית, אפשר להשתמש בפונקציה os.TempDir().
startup אם הערך מוגדר כ-false, הסוכן האורח לא מריץ סקריפטים לטעינה בזמן ההפעלה מתוך המטא-נתונים. ‫Linux ו-Windows true
shutdown אם הערך מוגדר ל-false, סוכן האורח לא מריץ סקריפטים של כיבוי ממטא-נתונים. ‫Linux ו-Windows true

ממשקי רשת

כדי לקבוע איך סוכן האורח ינהל את ממשקי הרשת במכונה הווירטואלית, משתמשים באפשרויות שבקטע NetworkInterfaces בקובץ instance_configs.cfg.

אפשרות תיאור מערכת הפעלה ערך ברירת המחדל
setup אם המדיניות מוגדרת לערך false, סוכן האורחים מדלג על הגדרת ממשק הרשת. Linux true
ip_forwarding אם הערך מוגדר כ-false, סוכן האורח מדלג על העברת ה-IP. Linux true
manage_primary_nic אם הערך הוא true, סוכן האורח מנהל את כרטיסי ה-NIC הראשיים והמשניים. Linux false
dhcp_command הנתיב לקובץ ההרצה החלופי של DHCP להפעלת ממשקי רשת. Linux ריק
restore_debian12_netplan_config אם ההגדרה היא true, סוכן האורח יוצר מחדש את הגדרת ברירת המחדל של netplan ב-Debian 12 שנמצאת ב-/etc/netplan/90-default.yaml. ‫Linux (Debian 12) true
vlan_setup_enabled אם ההגדרה היא true, סוכן האורח מגדיר ומנהל כרטיסי רשת דינמיים. Linux false

OS Login

כדי להגדיר את השילוב של סוכן האורח עם הכניסה לחשבון מערכת ההפעלה, משתמשים באפשרויות שבקטע OSLogin של הקובץ instance_configs.cfg.

אפשרות תיאור מערכת הפעלה ערך ברירת המחדל
cert_authentication אם הערך הוא false, סוכן האורח לא מגדיר את המפתחות TrustedUserCAKeys,‏ AuthorizedPrincipalsCommand ו-AuthorizedPrincipalsCommandUser של sshd. Linux true

מנהל הפלאגינים

כדי להגדיר את מנהל הפלאגינים של סוכן האורח, משתמשים באפשרויות שבקטע PluginConfig בקובץ instance_configs.cfg.

אפשרות תיאור מערכת הפעלה ערך ברירת המחדל
socket_connections_dir הספרייה שבה מנהל התוספים יוצר שקעים כדי לתקשר עם תוספים. ‫Linux ו-Windows
  • ‫Linux: ‏ /run/google-guest-agent/plugin-connections
  • ב-Windows:‏ C:\ProgramData\Google\Compute Engine\google-guest-agent‎
state_dir הספרייה שבה מנהל הפלאגינים שומר את מצב הפלאגין ומוריד את הקבצים הבינאריים שלו. ‫Linux ו-Windows
  • ‫Linux: ‏ /var/lib/google-guest-agent
  • ב-Windows:‏ C:\ProgramData\Google\Compute Engine\google-guest-agent‎
local_plugin_dir הספרייה שבה מנהל הפלאגינים מחפש פלאגינים שהותקנו באופן מקומי. האפשרות זמינה בגרסה 20260228.00 ואילך. ‫Linux ו-Windows
  • ‫Linux: ‏ /usr/lib/google/guest_agent/
  • ב-Windows:‏ C:\Program Files\Google\Compute Engine\agent‎
connection_type סוג החיבור שסוכן האורח משתמש בו כדי לתקשר עם התוספים שלו. יש תמיכה רק בערכים הבאים:
  • uds
  • tcp

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

 ‫Linux ו-Windows uds

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