התקנת סוכן תפעול באמצעות כללי המדיניות של VM Extension Manager

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

לפני שמתחילים

לפני שיוצרים כללי מדיניות לתוספים של VM Extension Manager כדי לנהל את סוכן תפעול, צריך:

הסרה של סוכני תצפית קיימים

לפני שיוצרים מדיניות של VM Extension Manager ל-Ops Agent, צריך לוודא שאין מכונות של סוכן תפעול או של סוכן המעקב וסוכן Logging הקודמים שכבר נמצאים ב-VM. אם מריצים את סוכן תפעול ואת הסוכנים הקודמים באותה VM, יכול להיות שיווצרו כפילויות ביומנים או התנגשויות בהטמעת המדדים.

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

האופן שבו מסירים סוכנים קיימים תלוי באופן שבו הסוכנים האלה הותקנו.

הפעלת ממשקי ה-API שנדרשים לשימוש ב-Ops Agent

כדי להשתמש בסוכן תפעול לכתיבת יומנים ומדדים, צריך להפעיל את Cloud Logging API ואת Cloud Monitoring API בפרויקט ב- Google Cloud .

התפקידים שנדרשים כדי להפעיל ממשקי API

כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

הפעלת ממשקי ה-API

הקצאת התפקידים שנדרשים לשימוש בסוכן תפעול

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

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

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

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

הפעלת ה-API שמשמש את VM Extension Manager

‫VM Extension Manager משתמש ב-Compute Engine API. אם ה-API לא מופעל בפרויקט ב- Google Cloud , צריך להפעיל אותו.

הפעלת Compute Engine API

הקצאת התפקידים שנדרשים כדי להשתמש ב-VM Extension Manager

כדי לקבל את ההרשאות שדרושות ליצירת מדיניות של תוספים למכונות וירטואליות, בקשו מהאדמין להקצות לכם את התפקידים הבאים ב-IAM בפרויקט:

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

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

ההרשאות הנדרשות

כדי ליצור כללי מדיניות של תוספי VM, צריך את ההרשאות הבאות:

  • כדי ליצור כללי מדיניות של תוספים: compute.vmExtensionPolicies.create

יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

למידע נוסף על תפקידים והרשאות ב-IAM ב-Compute Engine, קראו את המאמר תפקידים והרשאות ב-Compute Engine.

התקנת Google Cloud CLI

אפשר ליצור ולנהל מדיניות של תוספי VM באמצעות Google Cloud או Google Cloud CLI, ‏ gcloud. כדי להשתמש ב-gcloud, קודם צריך להתקין את Google Cloud CLI.

כדי לראות את הרכיבים שהתקנתם, מריצים את הפקודה הבאה:

gcloud components list

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

gcloud components update

התנגשויות בין כללי מדיניות וסדרי עדיפויות

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

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

תוכניות השקה של כללי מדיניות גלובליים

כללי המדיניות הגלובליים של VM Extension Manager משתמשים בתוכנית השקה כדי לקבוע איך המדיניות מופצת למכונות הווירטואליות המטורגטות. יש שני סוגים של תוכניות השקה:

  • תוכניות השקה מוגדרות מראש. יש שתי תוכניות השקה מוגדרות מראש, שנבחרות לפי הערך שמשמש עם האפשרות --rollout-predefined-plan לפקודות ה-CLI של gcloud.

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

      כדי לציין את תוכנית ההשקה הזו, משתמשים באפשרות --rollout-predefined-plan=slow_rollout.

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

      כדי לציין את תוכנית ההשקה הזו, משתמשים באפשרות --rollout-predefined-plan=fast_rollout.

  • תוכניות השקה בהתאמה אישית, שמוגדרות באמצעות האפשרות --rollout-custom-plan לפקודות ב-CLI של gcloud.

    כדי ליצור תוכניות השקה בהתאמה אישית, מוסיפים אותן לקבוצת תוכניות ההשקה בפרויקט ב- Google Cloud . מידע נוסף זמין ב-method‏ rolloutPlans.insert של Compute Engine API.

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

יצירת כללי מדיניות של תוספי VM להתקנת סוכן תפעול

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

אתם יכולים להשתמש בכללי מדיניות של תוספים ל-סוכן תפעול כדי לבצע משימות כמו:

  • התקנה בכל הצי: מתקינים את סוכן תפעול במקומות הבאים:

    • כל המכונות הווירטואליות באזור אחד או יותר בפרויקט ב- Google Cloud .
    • כל המכונות הווירטואליות באופן גלובלי (בפרויקט Google Cloud ).
    • קבוצת משנה של מכונות וירטואליות באזור, שמזוהות באמצעות תוויות.
    • קבוצת משנה של מכונות וירטואליות באזורים שונים בפרויקט ב- Google Cloud , שמזוהות לפי תוויות.

  • ניהול גרסאות:

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

  • ניהול הגדרות: החלת הגדרה מותאמת אישית על Ops Agent בכל המכונות הווירטואליות שמנוהלות על ידי מדיניות.

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

‫VM Extension Manager תומך ב-Ops Agent בגרסה 2.58.0 ואילך, כשה-Ops Agent הותקן באמצעות מדיניות של תוסף. ‫VM Extension Manager לא יכול לנהל גרסאות קודמות של סוכן תפעול, מכונות של סוכן תפעול שהותקנו באמצעים אחרים, או את סוכן Monitoring או סוכן Logging המדור קודם.

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

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

המסוף

כדי ליצור מדיניות אזורית, אפשר להשתמש במסוף Google Cloud .

  1. במסוף Google Cloud , נכנסים לדף Extension policies:

    עוברים אל כללי מדיניות של תוספים.

    אם משתמשים בשורת החיפוש כדי למצוא את הדף, בוחרים בתוצאה שכותרת המשנה שלה היא Compute Engine.

  2. לוחצים על + יצירה.
  3. בשדה Name, מזינים שם למדיניות.
  4. אופציונלי: בשדה Description, מזינים תיאור למדיניות.
  5. בשדה Priority, מציינים מספר עדיפות כדי לפתור סתירות בין כללי מדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1,000.
  6. ברשימה Zone, בוחרים את האזור שבו רוצים להחיל את המדיניות.
  7. בקטע ניהול תוספים, לוחצים על הוספת תוסף ומבצעים את הפעולות הבאות:
    1. ברשימה Extension, בוחרים באפשרות Google Cloud's Extension for Ops Agent.
    2. משאירים את השדה Version ריק.
  8. לוחצים על יצירה.

gcloud

כדי ליצור מדיניות ברמת האזור או ברמה הגלובלית, אתם יכולים להשתמש ב-CLI של gcloud.

אזורי

כדי ליצור את המדיניות, משתמשים בפקודה הבאה של gcloud compute zone-vm-extension-policies create:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent

מחליפים את המשתנים הבאים בפקודה:

  • ‫POLICY_NAME: שם למדיניות התוספים של ה-VM.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫ZONE: אזור היעד, לדוגמה us-central1-f.

הפקודה gcloud compute zone-vm-extension-policies create מקבלת את האפשרות --version. אם לא תציינו את האפשרות --version, המדיניות תתקין את הגרסה העדכנית ותעדכן את סוכן התפעול כשגרסה חדשה תפורסם.

עולמי

כדי ליצור את המדיניות, משתמשים בפקודה הבאה של gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout

מחליפים את המשתנים הבאים בפקודה:

  • ‫POLICY_NAME: שם למדיניות התוספים של ה-VM.
  • ‫PROJECT_ID: מזהה הפרויקט.

הפקודה gcloud compute global-vm-extension-policies create מקבלת את האפשרות --version. אם לא תציינו את האפשרות --version, המדיניות תתקין את הגרסה העדכנית ותעדכן את סוכן התפעול כשגרסה חדשה תפורסם.

הצמדת סוכן תפעול לגרסה ספציפית בכל המכונות הווירטואליות

כדי ליצור מדיניות שמתקינה גרסה ספציפית של Ops Agent בכל המכונות הווירטואליות באזור או באופן גלובלי, מבצעים את הפעולות הבאות:

המסוף

כדי ליצור מדיניות אזורית, אפשר להשתמש במסוף Google Cloud .

  1. במסוף Google Cloud , נכנסים לדף Extension policies:

    עוברים אל כללי מדיניות של תוספים.

    אם משתמשים בשורת החיפוש כדי למצוא את הדף, בוחרים בתוצאה שכותרת המשנה שלה היא Compute Engine.

  2. לוחצים על + יצירה.
  3. בשדה Name, מזינים שם למדיניות.
  4. אופציונלי: בשדה Description, מזינים תיאור למדיניות.
  5. בשדה Priority, מציינים מספר עדיפות כדי לפתור סתירות בין כללי מדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1,000.
  6. ברשימה Zone, בוחרים את האזור שבו רוצים להחיל את המדיניות.
  7. בקטע ניהול תוספים, לוחצים על הוספת תוסף ומבצעים את הפעולות הבאות:
    1. ברשימה Extension, בוחרים באפשרות Google Cloud's Extension for Ops Agent.
    2. ברשימה Version, בוחרים את הגרסה שרוצים להתקין. צריך להשתמש בגרסה 2.58.0 ואילך.
  8. לוחצים על יצירה.

gcloud

כדי ליצור מדיניות ברמת האזור או ברמה הגלובלית, אתם יכולים להשתמש ב-CLI של gcloud.

אזורי

כדי ליצור את המדיניות, משתמשים בפקודה הבאה של gcloud compute zone-vm-extension-policies create:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --version=ops-agent=VERSION

מחליפים את המשתנים הבאים בפקודה:

  • ‫POLICY_NAME: שם למדיניות התוספים של ה-VM.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫ZONE: אזור היעד, לדוגמה us-central1-f.
  • ‫VERSION: גרסת סוכן התפעול שרוצים להתקין. צריך להשתמש בגרסה 2.58.0 ואילך.

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

עולמי

כדי ליצור את המדיניות, משתמשים בפקודה הבאה של gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

מחליפים את המשתנים הבאים בפקודה:

  • ‫POLICY_NAME: שם למדיניות התוספים של ה-VM.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫VERSION: גרסת סוכן התפעול שרוצים להתקין. צריך להשתמש בגרסה 2.58.0 ואילך.

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

לרשימה של גרסאות סוכן תפעול, עיינו בדף הגרסאות של סוכן תפעול ב-GitHub.

התקנת סוכן תפעול במכונות וירטואליות עם תווית ספציפית

כדי ליצור מדיניות שמתקינה את הגרסה העדכנית של Ops Agent במכונות הווירטואליות באזור מסוים או באופן גלובלי, עם תווית ספציפית:

המסוף

כדי ליצור מדיניות אזורית, אפשר להשתמש במסוף Google Cloud .

  1. במסוף Google Cloud , נכנסים לדף Extension policies:

    עוברים אל כללי מדיניות של תוספים.

    אם משתמשים בשורת החיפוש כדי למצוא את הדף, בוחרים בתוצאה שכותרת המשנה שלה היא Compute Engine.

  2. לוחצים על + יצירה.
  3. בשדה Name, מזינים שם למדיניות.
  4. אופציונלי: בשדה Description, מזינים תיאור למדיניות.
  5. בשדה Priority, מציינים מספר עדיפות כדי לפתור סתירות בין כללי מדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1,000.
  6. ברשימה Zone, בוחרים את האזור שבו רוצים להחיל את המדיניות.
  7. בקטע ניהול תוספים, לוחצים על הוספת תוסף ומבצעים את הפעולות הבאות:
    1. ברשימה Extension, בוחרים באפשרות Google Cloud's Extension for Ops Agent.
    2. משאירים את השדה Version ריק.
  8. בקטע Target VM instances, בוחרים את המכונות הווירטואליות שעליהן רוצים להחיל את המדיניות. כדי לבחור מכונות וירטואליות עם תוויות ספציפיות, לוחצים על Add labels ומוסיפים את צמד המפתח/ערך.
  9. לוחצים על יצירה.

gcloud

כדי ליצור מדיניות ברמת האזור או ברמה הגלובלית, אתם יכולים להשתמש ב-CLI של gcloud.

אזורי

משתמשים באפשרות --inclusion-labels בפקודה gcloud compute zone-vm-extension-policies create כדי לציין רשימה מופרדת בפסיקים של צמדי מפתח/ערך:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

מחליפים את המשתנים הבאים בפקודה:

  • ‫POLICY_NAME: שם למדיניות התוספים של ה-VM.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫ZONE: אזור היעד, לדוגמה us-central1-f.
  • ‫KEY1=VALUE1,KEY2=VALUE2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות ייכללו, הן צריכות להכיל את כל התוויות שצוינו בבורר (AND לוגי). אם מציינים את האפשרות --inclusion_labels כמה פעמים, המדיניות מטרגטת את המכונות הווירטואליות שתואמות לכל התוויות בכל אחד מהבוררים (OR לוגי). אם לא תבחרו באפשרות הזו, המדיניות תטרגט את כל המכונות הווירטואליות באזור שצוין.

עולמי

משתמשים באפשרות --inclusion-labels בפקודה gcloud compute global-vm-extension-policies create כדי לציין רשימה מופרדת בפסיקים של צמדי מפתח/ערך:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

מחליפים את המשתנים הבאים בפקודה:

  • ‫POLICY_NAME: שם למדיניות התוספים של ה-VM.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫KEY1=VALUE1,KEY2=VALUE2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות ייכללו, הן צריכות להכיל את כל התוויות שצוינו בבורר (AND לוגי). אם מציינים את האפשרות --inclusion_labels כמה פעמים, המדיניות מטרגטת את המכונות הווירטואליות שתואמות לכל התוויות בכל אחד מהבוררים (OR לוגי). אם לא תבחרו באפשרות הזו, המדיניות תטרגט את כל המכונות הווירטואליות באזור שצוין.

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

כדי ליצור מדיניות שמתקינה את הגרסה העדכנית של Ops Agent בכל המכונות הווירטואליות באזור או באופן גלובלי, ומספקת הגדרה מותאמת אישית ל-Ops Agent, מבצעים את הפעולות הבאות:

המסוף

כדי ליצור מדיניות אזורית, אפשר להשתמש במסוף Google Cloud .

  1. במסוף Google Cloud , נכנסים לדף Extension policies:

    עוברים אל כללי מדיניות של תוספים.

    אם משתמשים בשורת החיפוש כדי למצוא את הדף, בוחרים בתוצאה שכותרת המשנה שלה היא Compute Engine.

  2. לוחצים על + יצירה.
  3. בשדה Name, מזינים שם למדיניות.
  4. אופציונלי: בשדה Description, מזינים תיאור למדיניות.
  5. בשדה Priority, מציינים מספר עדיפות כדי לפתור סתירות בין כללי מדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1,000.
  6. ברשימה Zone, בוחרים את האזור שבו רוצים להחיל את המדיניות.
  7. בקטע ניהול תוספים, לוחצים על הוספת תוסף ומבצעים את הפעולות הבאות:
    1. ברשימה Extension, בוחרים באפשרות Google Cloud's Extension for Ops Agent.
    2. משאירים את השדה Version ריק.
    3. בשדה Config file content, מזינים את מחרוזת ההגדרות של YAML ל-Ops Agent.
  8. לוחצים על יצירה.

gcloud

כדי ליצור מדיניות ברמת האזור או ברמה הגלובלית, אתם יכולים להשתמש ב-CLI של gcloud.

אזורי

משתמשים באפשרות --config-from-file בפקודה gcloud compute zone-vm-extension-policies create כדי לציין קובץ תצורה:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

מחליפים את המשתנים הבאים בפקודה:

  • ‫POLICY_NAME: שם למדיניות התוספים של ה-VM.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫ZONE: אזור היעד, לדוגמה us-central1-f.
  • OPS_AGENT_CONFIG_PATH: הנתיב לקובץ שמכיל את מחרוזת ההגדרות של YAML ל-סוכן תפעול. הקובץ הזה חייב להיות בסביבה שבה מריצים את הפקודה gcloud.

    קובץ ה-YAML של הגדרות סוכן התפעול יכול להיות ארוך. הוספת ההגדרות לקובץ והעברת הקובץ ל-CLI של gcloud מפחיתה את הסיכוי לשגיאות, בהשוואה להזנה של YAML בפורמט תקין בשורת הפקודה. שינוי הקובץ הזה אחרי יצירת המדיניות לא מעדכן את המדיניות. כדי לעדכן מדיניות, צריך להשתמש בפקודה gcloud compute zone-vm-extension-policies update.

עולמי

משתמשים באפשרות --config-from-file בפקודה gcloud compute global-vm-extension-policies create כדי לציין קובץ תצורה:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

מחליפים את המשתנים הבאים בפקודה:

  • ‫POLICY_NAME: שם למדיניות התוספים של ה-VM.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • OPS_AGENT_CONFIG_PATH: הנתיב לקובץ שמכיל את מחרוזת ההגדרות של YAML ל-סוכן תפעול. הקובץ הזה חייב להיות בסביבה שבה מריצים את הפקודה gcloud.

    קובץ ה-YAML של הגדרות סוכן התפעול יכול להיות ארוך. הוספת ההגדרות לקובץ והעברת הקובץ ל-CLI של gcloud מפחיתה את הסיכוי לשגיאות, בהשוואה להזנה של YAML בפורמט תקין בשורת הפקודה. שינוי הקובץ הזה אחרי יצירת המדיניות לא מעדכן את המדיניות. כדי לעדכן מדיניות, צריך להשתמש בפקודה gcloud compute global-vm-extension-policies update.

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

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

כשאתם מספקים הגדרה מותאמת אישית לסוכן תפעול, VM Extension Manager מעתיק את ההגדרה למיקום שבו סוכן תפעול משתמש ל קובצי תצורה שצוינו על ידי המשתמש ב-VM המטורגט:

  • ‫Linux: ‏ /etc/google-cloud-ops-agent/config.yaml
  • ב-Windows:‏ C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml‎

אם יש קובץ config.yaml ב-VM, מדיניות התוסף מחליפה אותו.

מידע כללי על השימוש במסוףGoogle Cloud וב-ה-CLI של gcloud כדי ליצור כללי מדיניות של תוספים למכונות וירטואליות, מופיע במאמר התקנת תוספים למכונות וירטואליות באמצעות כללי מדיניות של תוספים .

התקנת סוכן התפעול באמצעות תוכנית השקה מהירה בעדיפות גבוהה יותר (גלובלית בלבד)

כדי ליצור מדיניות גלובלית שמתקינה את הגרסה העדכנית של סוכן תפעול באמצעות עדיפות גבוהה יותר מברירת המחדל ותוכנית ההשקה המהירה, משתמשים בפקודה הבאה של gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=fast_rollout \
  --priority=500

מחליפים את המשתנים הבאים בפקודה:

  • ‫POLICY_NAME: שם למדיניות התוספים של ה-VM.
  • ‫PROJECT_ID: מזהה הפרויקט.

התקנת סוכן תפעול בקבוצת משנה של אזורים בפרויקט ב- Google Cloud (גלובלי בלבד)

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

כדי ליצור מדיניות של תוסף שמשתמשת בתוכנית השקה בהתאמה אישית, משתמשים בפקודה הבאה של gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/CUSTOM_PLAN_NAME

מחליפים את המשתנים הבאים בפקודה:

  • ‫POLICY_NAME: שם למדיניות התוספים של ה-VM.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫CUSTOM_PLAN_NAME: השם שמשויך לתוכנית ההשקה בהתאמה אישית.

אימות ההתקנה של סוכן התפעול

בקטע הזה מוסבר איך לבצע את הפעולות הבאות:

איך בודקים את הסטטוס או הגרסה של סוכן התפעול שהותקן

כדי לבדוק את הסטטוס או הגרסה של סוכן תפעול, משתמשים באחד מהדפים הבאים במסוףGoogle Cloud :

Compute Engine

  1. נכנסים לדף VM instances במסוף Google Cloud :

    נכנסים לדף VM instances.

    אם אתם משתמשים בשורת החיפוש כדי למצוא את הדף הזה, בחרו בתוצאה שכותרת המשנה שלה היא Compute Engine.

  2. בוחרים מכונה וירטואלית מהרשימה.
  3. לוחצים על הכרטיסייה Observability.

Cloud Monitoring

  1. נכנסים לדף VM Instances במסוף Google Cloud :

    נכנסים לדף VM Instances.

    אם אתם משתמשים בשורת החיפוש כדי למצוא את הדף הזה, בחרו בתוצאה שכותרת המשנה שלה היא Monitoring.

  2. בוחרים בתצוגת רשימה.

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

כדי לזהות את גרסת סוכן התפעול המותקן, מעבירים את העכבר מעל התווית Ops Agent בלוח הבקרה של Compute Engine או של Monitoring.

איך מוודאים ש-Ops Agent אוסף נתוני טלמטריה

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

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