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

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

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

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

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

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

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

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

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

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

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

בדיקת מערכות הפעלה נתמכות

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

‫VM Extension Manager תומך בכל מערכות ההפעלה שנתמכות על ידי סוכן תפעול, למעט SUSE Linux Enterprise Server ‏ (SLES) ו-Ubuntu. מידע נוסף על מערכות ההפעלה שנתמכות על ידי סוכן תפעול זמין במאמר בנושא מערכות הפעלה.

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

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

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

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

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

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

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

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

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

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

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

הענקת התפקידים הנדרשים לשימוש ב-VM Extension Manager

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

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

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

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

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

  • כדי ליצור כללי מדיניות לתוספים: compute.vmExtensionPolicies.create
  • כדי להציג את כללי המדיניות של התוספים: compute.vmExtensionPolicies.list
  • כדי לראות את הפרטים של מדיניות תוספים: compute.vmExtensionPolicies.get
  • כדי לשנות את כללי המדיניות של התוספים: compute.vmExtensionPolicies.update
  • כדי למחוק כללי מדיניות של תוספים: compute.vmExtensionPolicies.delete

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

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

התקנת Google Cloud CLI

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

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

gcloud components list

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

gcloud components update

הסרת סוכני observability

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

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

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

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

יוצרים מדיניות של תוספים למכונות וירטואליות כדי להתקין ולנהל באופן אוטומטי את סוכן תפעול בצי של מכונות וירטואליות (VM) ב-Compute Engine. הגדרת מדיניות מאפשרת לוודא שתוספים ספציפיים, כמו סוכן תפעול, מותקנים ומתעדכנים בכל המכונות הווירטואליות שתואמות לקריטריונים שאתם מציינים, כמו תוויות של מכונות וירטואליות.

קונפליקטים ועדיפויות במדיניות

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 של Compute Engine API‏ rolloutPlans.insert.

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

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

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

המסוף

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

  1. במסוף Google Cloud , עוברים לדף Extension policies (מדיניות הרשאות לתוספים):

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

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

  2. לוחצים על + יצירה.
  3. בשדה Name, מזינים שם למדיניות.
  4. אופציונלי: בשדה תיאור, מזינים תיאור למדיניות.
  5. בשדה עדיפות, מציינים מספר עדיפות כדי לפתור סתירות בין כללי מדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 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 בכל מכונות ה-VM באזור או באופן גלובלי, מבצעים את הפעולות הבאות:

המסוף

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

  1. במסוף Google Cloud , עוברים לדף Extension policies (מדיניות הרשאות לתוספים):

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

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

  2. לוחצים על + יצירה.
  3. בשדה Name, מזינים שם למדיניות.
  4. אופציונלי: בשדה תיאור, מזינים תיאור למדיניות.
  5. בשדה עדיפות, מציינים מספר עדיפות כדי לפתור סתירות בין כללי מדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 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. אופציונלי: בשדה תיאור, מזינים תיאור למדיניות.
  5. בשדה עדיפות, מציינים מספר עדיפות כדי לפתור סתירות בין כללי מדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1,000.
  6. ברשימה Zone, בוחרים את האזור שבו רוצים להחיל את המדיניות הזו.
  7. בקטע ניהול תוספים, לוחצים על הוספת תוסף ומבצעים את הפעולות הבאות:
    1. ברשימה Extension, בוחרים באפשרות Google Cloud's Extension for Ops Agent.
    2. משאירים את השדה Version (גרסה) ריק.
  8. בקטע Target VM instances (מכונות וירטואליות ליעד), בוחרים את המכונות הווירטואליות שאליהן רוצים להחיל את המדיניות. כדי לבחור מכונות וירטואליות עם תוויות ספציפיות, לוחצים על הוספת תוויות ומוסיפים את צמד המפתח/ערך.
  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 לוגי). אם לא מציינים את האפשרות הזו, המדיניות מטרגטת את כל מכונות ה-VM באזור שצוין.

עולמי

משתמשים באפשרות --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 לוגי). אם לא מציינים את האפשרות הזו, המדיניות מטרגטת את כל מכונות ה-VM באזור שצוין.

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

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

המסוף

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

  1. במסוף Google Cloud , עוברים לדף Extension policies (מדיניות הרשאות לתוספים):

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

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

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

ההגדרה מאוחסנת במדיניות התוסף, לכן אל תכללו בה נתונים רגישים כמו סיסמאות. ההגדרה מאוחסנת במדיניות התוסף, ולכן שינוי קובץ ההגדרה לא משנה את ההגדרה של הסוכן. צריך לעדכן את ההגדרה שמאוחסנת במדיניות באמצעות הפקודה המתאימה 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: השם שמשויך לתוכנית הפריסה המותאמת אישית.

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

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

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

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

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

המסוף

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

  1. במסוף Google Cloud , עוברים לדף Extension policies (מדיניות הרשאות לתוספים):

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

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

  2. בוחרים את המדיניות שרוצים לעדכן.
  3. לוחצים על Edit.
  4. בקטע Manage extensions (ניהול תוספים), מבצעים את הפעולות הבאות:
    1. ברשימה Extension, בוחרים באפשרות Google Cloud's Extension for Ops Agent.
    2. משנים את השדה Version (גרסה). משתמשים בגרסה 2.58.0 ואילך.
    3. לוחצים על סיום.
  5. לוחצים על Save.

gcloud

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

אזורי

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

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

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

gcloud compute zone-vm-extension-policies update 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 ואילך. רשימת הגרסאות זמינה בדף הגרסאות של סוכן תפעול ב-GitHub.

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

עולמי

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

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

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

gcloud compute global-vm-extension-policies update 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 ואילך. רשימת הגרסאות זמינה בדף הגרסאות של סוכן תפעול ב-GitHub.

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

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

כדי לשנות את ההגדרה של סוכן תפעול:

המסוף

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

  1. במסוף Google Cloud , עוברים לדף Extension policies (מדיניות הרשאות לתוספים):

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

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

  2. בוחרים את המדיניות שרוצים לעדכן.
  3. לוחצים על Edit.
  4. בקטע Manage extensions (ניהול תוספים), מבצעים את הפעולות הבאות:
    1. ברשימה Extension, בוחרים באפשרות Google Cloud's Extension for Ops Agent.
    2. בשדה Config file content (תוכן קובץ התצורה), מזינים את מחרוזת ההגדרות ב-YAML של סוכן תפעול.
    3. לוחצים על סיום.
  5. לוחצים על Save.

gcloud

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

אזורי

משתמשים בפקודה gcloud compute zone-vm-extension-policies update עם האפשרות --config-from-file או האפשרות --config כדי לציין הגדרה חדשה.

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

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

gcloud compute zone-vm-extension-policies update 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 global-vm-extension-policies update עם האפשרות --config-from-file או האפשרות --config כדי לציין הגדרה חדשה.

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

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

gcloud compute global-vm-extension-policies update 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 בפורמט תקין בשורת הפקודה.

אם מספקים הגדרה בהתאמה אישית ל-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 לניהול מדיניות של תוספים למכונות וירטואליות זמין במאמר שינוי תוספים על ידי עדכון מדיניות של תוספים למכונות וירטואליות.

הרחבת מדיניות גלובלית קיימת כך שתכלול אזורים חדשים (גלובלי בלבד)

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

כדי להפעיל מחדש את הפריסה של מדיניות גלובלית, משתמשים בפקודה gcloud compute global-vm-extension-policies update ומספקים את האפשרות --rollout-retry-uuid=UUID.

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

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml"

כדי להרחיב את המדיניות ל-VM שנוצרו באזורים שלא נעשה בהם שימוש בעבר, מפעילים מחדש את ההשקה באמצעות הפקודה הבאה:

gcloud compute global-vm-extension-policies update test-policy POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --rollout-retry-uuid=UUID

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

  • ‫POLICY_NAME: שם למדיניות של תוסף ה-VM.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫UUID: מזהה ייחודי אוניברסלי (UUID) שמזהה את בקשת הניסיון החוזר. אפשר להשתמש בכל מחולל UUID כדי ליצור אחד. מידע נוסף זמין במאמר ניסיון חוזר להפעלת תכונה .

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

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

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

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
  --rollout-retry-uuid=UUID

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

  • ‫POLICY_NAME: שם למדיניות של תוסף ה-VM.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫NEW_CUSTOM_PLAN_NAME: השם שמשויך לתוכנית הפריסה המותאמת אישית המעודכנת.
  • ‫UUID: מזהה ייחודי אוניברסלי (UUID) שמזהה את בקשת הניסיון החוזר. אפשר להשתמש בכל מחולל UUID כדי ליצור אחד. מידע נוסף זמין במאמר ניסיון חוזר להפעלת תכונה .

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

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

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

המסוף

  1. במסוף Google Cloud , עוברים לדף Extension policies (מדיניות הרשאות לתוספים):

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

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

  2. בוחרים את המדיניות שרוצים למחוק.
  3. לוחצים על Delete.
  4. בתיבת הדו-שיח לאישור, לוחצים על מחיקה.

gcloud

אזורי

כדי למחוק את מדיניות התוסף של מכונת ה-VM שמנהלת את סוכן תפעול, משתמשים בפקודה gcloud compute zone-vm-extension-policies delete:

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

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

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

עולמי

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

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=slow_rollout

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

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

כדי להאיץ את ההשקה של מחיקה שכבר התחילה, צריך להנפיק פקודת מחיקה חדשה שמשתמשת בתוכנית fast_rollout. צריך לציין גם את האפשרות ‎--rollout-retry-uuid=UUID:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=fast_rollout \
  --rollout-retry-uuid=UUID

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

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

  • ‫UUID: מזהה ייחודי אוניברסלי (UUID) שמזהה את בקשת הניסיון החוזר. אפשר להשתמש בכל מחולל UUID כדי ליצור אחד. מידע נוסף מופיע במאמר בנושא ניסיון חוזר להפעלת תכונה .

אחזור מידע על מדיניות של תוספים למכונות וירטואליות

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

  • רשימה של כל כללי המדיניות בפרויקט Google Cloud .
  • פרטי ההגדרה של מדיניות ספציפית.

המסוף

  1. במסוף Google Cloud , עוברים לדף Extension policies (מדיניות הרשאות לתוספים):

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

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

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

gcloud

אזורי

רשימת כללי מדיניות של תוספים למכונות וירטואליות

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

gcloud compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE_INTEGER

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

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫ZONE: אזור היעד, לדוגמה, us-central1-f.
  • ‫PAGE_SIZE_INTEGER: מספר המדיניות שיוצג בכל דף. לדוגמה, 2. מידע נוסף על אפשרויות המיון והסינון זמין במאמר בנושא gcloud compute zone-vm-extension-policies list.

תיאור מדיניות של תוסף למכונה וירטואלית עם שם

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

gcloud compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

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

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

עולמי

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

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

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE_INTEGER

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

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫PAGE_SIZE_INTEGER: מספר המדיניות שיוצג בכל דף. לדוגמה, 2. מידע נוסף על אפשרויות המיון והסינון זמין במאמר בנושא gcloud compute global-vm-extension-policies list.

תיאור של מדיניות הרחבות גלובלית למכונות וירטואליות עם שם

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

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

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

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

מידע כללי על השימוש במסוףGoogle Cloud וב-CLI של gcloud כדי לאחזר מידע על מדיניות הרחבות של מכונות וירטואליות זמין במאמר הצגת מדיניות הרחבות.

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

בקטע הזה מוסבר איך:

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

כדי לראות את הסטטוס או הגרסה של סוכן תפעול, אפשר להשתמש באחד מהדפים הבאים במסוף: 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. בוחרים בתצוגה רשימה.

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

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

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

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

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

כש-Ops Agent מותקן ומנוהל על ידי VM Extension Manager, הוא לא מנוהל על ידי שירות ניהול המערכת של מערכת ההפעלה, כלומר systemd ב-Linux או Windows Service Manager ב-Windows. לכן, פקודות Linux systemctl ופקודות Windows *-Service לא פועלות עם Ops Agent שהותקן באמצעות מדיניות הרחבות.

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

  • יוצרים מחדש את המדיניות.

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

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

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

    לדוגמה, אם מדיניות עם עדיפות 1000 נכשלה בהפעלת סוכן התפעול במכונה וירטואלית, אפשר להוסיף למכונה הווירטואלית תווית כמו status=failed. לאחר מכן יוצרים מדיניות חדשה עם עדיפות גבוהה יותר, כמו 500. לדוגמה, פקודה ב-CLI של Google Cloud יכולה להיראות כך:

    אזורי 

    gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml

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

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

    עולמי 

    gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml \
  --rollout-predefined-plan=fast_rollout

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

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

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

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

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

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

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

מידע על פתרון בעיות ב-Ops Agent זמין במאמר פתרון בעיות ב-Ops Agent.

פקודות gcloud compute zone-vm-extension-policies נכשלות

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

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

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

יצרתם מדיניות תוספים בהצלחה, אבל ב-Ops Agent מוצג סטטוס של "לא זוהה" במכונה הווירטואלית.

יכול להיות שסוכן תפעול יופיע כ'לא זוהה' אם אחד מהמקרים הבאים מתרחש:

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

בקטעים הבאים מוסבר איך לאבחן את המקרים האלה.

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

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

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

Logs Explorer

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

    כניסה אל Logs Explorer

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

  2. מזינים את השאילתה הבאה ולוחצים על Run query:

    log_id("GCEGuestAgentManager")

Linux

מריצים את הפקודה הבאה במכונה הווירטואלית ב-Compute Engine:

journalctl -u google-guest-agent-manager

Windows

מריצים את הפקודה הבאה במכונה הווירטואלית ב-Compute Engine:

Get-Eventlog -Source google_guest_agent_manager -LogName Application

אם אתם רואים יומנים שמכילים מחרוזת כמו Failed to install plugin "ops-agent-plugin" ..., או אם השאילתה לא מחזירה יומנים, סימן שמדיניות התוסף לא הצליחה להתקין את סוכן תפעול. לשלבים הבאים, ראו מדיניות התוספים לא מאפשרת להתקין את סוכן תפעול.

אם רואים יומנים שמכילים מחרוזת כמו Successfully installed plugin "ops-agent_nnnnnnnn", סימן שמדיניות התוסף התקינה את סוכן תפעול בהצלחה. השלבים הבאים מפורטים במאמר סוכן תפעול שהותקן לא מזוהה.

מדיניות התוסף נכשלת בהתקנת סוכן התפעול

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

הסטטוס של סוכן תפעול שהותקן הוא 'לא זוהה'

הסטטוס של סוכן תפעול יכול להיות 'לא זוהה' אם מתקיים אחד מהתנאים הבאים:

אימות התצורה של סוכן תפעול

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

הפעלת רישום מפורט (verbose) של סוכן האורח ביומן ניפוי באגים

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

בדיקת יומני ניפוי באגים

Logs Explorer

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

    כניסה אל Logs Explorer

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

  2. מזינים את השאילתה הבאה ולוחצים על Run query:

    severity>=DEBUG log_id("GCEGuestAgentManager") "The agent config file is not valid"

Linux

מריצים את הפקודה הבאה במכונה וירטואלית של Linux Compute Engine:

journalctl -u google-guest-agent-manager | grep "The agent config file is not valid"

Windows

מריצים את הפקודה הבאה במכונה הווירטואלית של Windows Compute Engine:

Get-Eventlog -Source google_guest_agent_manager -LogName Application | Where-Object {$_.Message -like "*The agent config file is not valid*"}

אם אתם רואים יומנים שמכילים את המחרוזת The agent config file is not valid, סימן שההגדרה בהתאמה אישית של סוכן תפעול שסיפקתם כשנוצר או עודכן מדיניות התוסף לא תקינה.

כדי לפתור את הבעיה:

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

  • מעדכנים את מדיניות התוספים עם ההגדרה המתוקנת.

פקודות Linux systemctl status ו-Windows Get-Service לא פועלות עם סוכן תפעול

מריצים פקודה כמו sudo systemctl status google-cloud-ops-agent"*" אבל לא מקבלים מידע.

כש-Ops Agent מותקן ומנוהל על ידי VM Extension Manager, הוא לא מנוהל על ידי שירות ניהול המערכת של מערכת ההפעלה, כלומר systemd ב-Linux או Windows Service Manager ב-Windows.

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

פקודות Linux systemctl restart ו-Windows Restart-Service לא פועלות עם סוכן תפעול

מריצים פקודה כמו sudo systemctl restart google-cloud-ops-agent אבל סוכן תפעול לא מופעל מחדש.

כש-Ops Agent מותקן ומנוהל על ידי VM Extension Manager, הוא לא מנוהל על ידי שירות ניהול המערכת של מערכת ההפעלה, כלומר systemd ב-Linux או Windows Service Manager ב-Windows. לכן, אי אפשר להפעיל או להפסיק את סוכן תפעול באופן ידני, ופקודות כמו הבאות לא פועלות עם סוכן תפעול:

  • ‫Linux: ‏ sudo systemctl [stop|start|restart]
  • ‫Windows: ‏ Stop-Service, ‏ Start-Service, ‏ Restart-Service

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

מידע נוסף לפתרון בעיות

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

מידע נוסף על פתרון בעיות ב-Ops Agent זמין במאמר פתרון בעיות ב-Ops Agent.

מכסה

במאמר בנושא Quota מוסבר כמה כללי מדיניות לתוספים אפשר ליצור בפרויקט Google Cloud .

תמחור

מידע על העלויות שקשורות לשימוש ב-VM Extension Manager זמין במאמר בנושא תמחור.

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

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