‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

מגבלות על ניהול המדיניות

כדי לעדכן ולמחוק כללי מדיניות של תוספי VM ברמת התיקייה וברמת הארגון, צריך להשתמש ב-Google Cloud CLI או ב-Compute Engine REST API. אי אפשר לנהל כללי מדיניות ברמת התיקייה או ברמת הארגון במסוףGoogle Cloud .

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

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

שינוי תוספי VM בכל האזורים בארגון

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

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

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

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

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

gcloud

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

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

gcloud preview compute global-vm-extension-policies update POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

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

‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים לעדכן.
‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
‫DESCRIPTION: תיאור אופציונלי של המדיניות.
‫EXTENSION_NAME_1,EXTENSION_NAME_2: רשימה מופרדת בפסיקים של תוספים שצריך להוסיף למדיניות. צריך לציין לפחות תוסף אחד. אפשר לציין כל אחת מהסיומות הנתמכות הבאות:
- ops-agent
- google-cloud-sap-extension
- google-cloud-workload-extension
‫EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך, שבה המפתח הוא שם התוסף והערך הוא גרסת התוסף. אם לא מציינים גרסה לתוסף, VM Extension Manager משתמש בגרסה הזמינה האחרונה ומשדרג אותה באופן אוטומטי כשגרסאות חדשות זמינות.
הערה: ב-ops-agent, אפשר להתקין באמצעות VM Extension Manager את גרסה 2.58.0 או גרסאות חדשות יותר. ב-google-cloud-sap-extension וב-google-cloud-workload-extension, VM Extension Manager תומך רק בגרסה העדכנית.
‫EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך, שבה המפתח הוא שם התוסף והערך הוא הנתיב לקובץ התצורה של התוסף הזה. הקובץ הזה נמצא ב-VM שבו מריצים את הפקודה gcloud, ולא ב-VM שבו מתקינים את התוסף.
לחלופין, כדי לספק את ההגדרות כמחרוזת מוטבעת, משתמשים בדגל --config במקום בדגל --config-from-file – לדוגמה, EXTENSION_NAME_1="CONFIG_1". אפשר להשתמש ב---config-from-file או ב---config, אבל לא בשניהם באותה פקודה.
‫KEY_1=VALUE_1: רשימה מופרדת בפסיקים של צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות יטורגטו, הן צריכות לכלול את כל התוויות שצוינו בבורר. אם מציינים את --inclusion-labels כמה פעמים, המדיניות מטרגטת מכונות וירטואליות שתואמות לכל אחד מהבוררים שצוינו (OR לוגי). אם לא תציינו את הדגל הזה, המדיניות תטרגט את כל המכונות הווירטואליות בכל הפרויקטים והאזורים הצאצאים בארגון.
‫PRIORITY: מספר שלם מ-0 עד 65535 שמגדיר את העדיפות של המדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1000. אם לכמה כללי מדיניות יש אותה עדיפות, VM Extension Manager מחיל על המכונות הווירטואליות את המדיניות שעודכנה לאחרונה.
‫ROLLOUT_PLAN: מציינים slow_rollout או fast_rollout. אם אתם צריכים להשתמש בתוכנית השקה בהתאמה אישית, ציינו את הדגל --rollout-custom-plan במקום --rollout-predefined-plan בפורמט הבא:
```
--rollout-custom-plan=organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫ORGANIZATION_ID: הארגון שבו מוגדרת תוכנית ההשקה.
- ‫ROLLOUT_PLAN_NAME: השם של תוכנית ההשקה בהתאמה אישית שהגדרתם.
אם לא מציינים דגל של תוכנית השקה, VM Extension Manager משתמש ב-slow_rollout.
‫ROLLOUT_CONFLICT_BEHAVIOR: קובע את ההתנהגות כש-VM Extension Manager מזהה התנגשות בין מדיניות אזורית למדיניות גלובלית. אפשר לציין אחת מההתנהגויות הבאות במקרה של התנגשות:
- "" (מחרוזת ריקה): המדיניות הגלובלית לא מחליפה כללי מדיניות אזוריים עם אותו שם שמתנגשים איתה. ההתנהגות הזו במקרה של התנגשות היא ברירת המחדל.
- ‫overwrite: המדיניות הגלובלית מחליפה כל מדיניות אזורית עם אותו שם, ואז המדיניות הגלובלית מנהלת את השקות המדיניות באזור.
מידע נוסף זמין בקטע הדגל --rollout-conflict-behavior.
RETRY_UUID: מזהה UUID שמזהה ניסיון חוזר להשקת עדכון מדיניות. ה-UUID הזה מאפשר לכם לנסות שוב לבצע עדכון בלי שינויים. אם מגדירים את הדגל הזה ומשנים את המדיניות, תופיע שגיאה. מידע נוסף זמין במאמר ניסיון חוזר של השקה.

דוגמה: עדכון מדיניות גלובלית ברמת הארגון

הפקודה הבאה מעדכנת את המדיניות prod-frontend-policy בארגון 123456789 כדי להוסיף את התוסף google-cloud-workload-extension ולבטל את ההצמדה של ops-agent, כך שהיא תעקוב אחרי הגרסה האחרונה באמצעות תוכנית השקה מהירה:

gcloud preview compute global-vm-extension-policies update prod-frontend-policy \
  --organization=organizations/123456789 \
  --description="Updated policy: ops-agent + workload extension, unpinned" \
  --extensions=ops-agent,google-cloud-workload-extension \
  --config=ops-agent="updated-monitoring-config" \
  --inclusion-labels="env=prod,workload=frontend" \
  --priority=100 \
  --rollout-predefined-plan=fast_rollout

REST

כדי לעדכן מדיניות הרחבה גלובלית ברמת הארגון, שולחים בקשת PATCH ל-method‏ organizationGlobalVmExtensionPolicies.update. כשמעדכנים מדיניות באמצעות REST, צריך לספק רק את השדות שרוצים לעדכן. כל השדות שתשמיטו ישמרו על הערכים הקיימים שלהם.

PATCH https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

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

‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים לעדכן.
‫DESCRIPTION: תיאור של מדיניות התוספים של המכונה הווירטואלית.
‫EXTENSION_NAME: שם התוסף שצריך לעדכן, שמשמש כמפתח במפה extensionPolicies. כדי לעדכן כמה תוספים, צריך לכלול כמה רשומות במפה extensionPolicies.
‫EXTENSION_NAME_VERSION: הגרסה של תוסף ה-VM.
‫EXTENSION_NAME_CONFIG: הגדרות התצורה של התוסף ל-VM, כמחרוזת בתוך השורה.
‫KEY_1:VALUE_1,‏ KEY_2:VALUE_2: צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות יטורגטו, הן צריכות לכלול את כל התוויות שצוינו בבורר. כדי לציין כמה סלקטורים, צריך לכלול כמה אובייקטים במערך instanceSelectors, כל אחד עם שדה labelSelector. במקרה כזה, VM Extension Manager מטרגט מכונות וירטואליות שתואמות לכל אחד מהבוררים שצוינו (OR לוגי). אם לא מציינים את instanceSelectors, המדיניות מטרגטת את כל המכונות הווירטואליות בכל הפרויקטים והאזורים הצאצאים בארגון.
‫PRIORITY: מספר שלם מ-0 עד 65535 שמגדיר את העדיפות של המדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1000. אם לכמה כללי מדיניות יש אותה עדיפות, VM Extension Manager מחיל על המכונות הווירטואליות את המדיניות שעודכנה לאחרונה.
‫ROLLOUT_CONFLICT_BEHAVIOR: קובע את ההתנהגות כש-VM Extension Manager מזהה התנגשות בין מדיניות אזורית למדיניות גלובלית. אפשר לציין אחת מההתנהגויות הבאות במקרה של התנגשות:
- "" (מחרוזת ריקה): המדיניות הגלובלית לא מחליפה כללי מדיניות אזוריים עם אותו שם שמתנגשים איתה. ההתנהגות הזו במקרה של התנגשות היא ברירת המחדל.
- ‫overwrite: המדיניות הגלובלית מחליפה כל מדיניות אזורית עם אותו שם, ואז המדיניות הגלובלית מנהלת את השקות המדיניות באזור.
מידע נוסף זמין בקטע הדגל --rollout-conflict-behavior.
‫ROLLOUT_PLAN_NAME: השם של תוכנית ההשקה בהתאמה אישית שהגדרתם. כדי להשתמש בתוכנית השקה מוגדרת מראש, מחליפים את השדה name ב-predefinedRolloutPlan ומציינים את אחד מהערכים הבאים:
- ‫SLOW_ROLLOUT: המדיניות תושק תוך חמישה ימים. תוכנית ההשקה הזו מוגדרת מראש כברירת מחדל אם לא מציינים תוכנית אחרת.
- ‫FAST_ROLLOUT: השקת המדיניות באופן מיידי בכל האזורים.
RETRY_UUID: מזהה UUID שמזהה ניסיון חוזר להשקת עדכון מדיניות.

שינוי תוספי VM בכל האזורים בתיקייה

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

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

התפקיד המוגדר מראש הזה מכיל את ההרשאה compute.folderVmExtensionPolicies.update, שנדרשת כדי לעדכן מדיניות הרחבה ברמת התיקייה.

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

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

gcloud

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

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

gcloud preview compute global-vm-extension-policies update POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

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

‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים לעדכן.
‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
‫DESCRIPTION: תיאור אופציונלי של המדיניות.
‫EXTENSION_NAME_1,EXTENSION_NAME_2: רשימה מופרדת בפסיקים של תוספים שצריך להוסיף למדיניות. צריך לציין לפחות תוסף אחד. אפשר לציין כל אחת מהסיומות הנתמכות הבאות:
- ops-agent
- google-cloud-sap-extension
- google-cloud-workload-extension
‫EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך, שבה המפתח הוא שם התוסף והערך הוא גרסת התוסף. אם לא מציינים גרסה לתוסף, VM Extension Manager משתמש בגרסה הזמינה האחרונה ומשדרג אותה באופן אוטומטי כשגרסאות חדשות זמינות.
הערה: ב-ops-agent, אפשר להתקין באמצעות VM Extension Manager את גרסה 2.58.0 או גרסאות חדשות יותר. ב-google-cloud-sap-extension וב-google-cloud-workload-extension, VM Extension Manager תומך רק בגרסה העדכנית.
‫EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך, שבה המפתח הוא שם התוסף והערך הוא הנתיב לקובץ התצורה של התוסף הזה. הקובץ הזה נמצא ב-VM שבו מריצים את הפקודה gcloud, ולא ב-VM שבו מתקינים את התוסף.
לחלופין, כדי לספק את ההגדרות כמחרוזת מוטבעת, משתמשים בדגל --config במקום בדגל --config-from-file – לדוגמה, EXTENSION_NAME_1="CONFIG_1". אפשר להשתמש ב---config-from-file או ב---config, אבל לא בשניהם באותה פקודה.
‫KEY_1=VALUE_1: רשימה מופרדת בפסיקים של צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות יטורגטו, הן צריכות לכלול את כל התוויות שצוינו בבורר. אם מציינים את --inclusion-labels כמה פעמים, המדיניות מטרגטת מכונות וירטואליות שתואמות לכל אחד מהבוררים שצוינו (OR לוגי). אם לא מציינים את הדגל הזה, המדיניות מטרגטת את כל המכונות הווירטואליות בכל הפרויקטים והאזורים הצאצאים שבתיקייה.
‫PRIORITY: מספר שלם מ-0 עד 65535 שמגדיר את העדיפות של המדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1000. אם לכמה כללי מדיניות יש אותה עדיפות, VM Extension Manager מחיל על המכונות הווירטואליות את המדיניות שעודכנה לאחרונה.
‫ROLLOUT_PLAN: מציינים slow_rollout או fast_rollout. אם אתם צריכים להשתמש בתוכנית השקה בהתאמה אישית, ציינו את הדגל --rollout-custom-plan במקום --rollout-predefined-plan בפורמט הבא:
```
--rollout-custom-plan=folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫FOLDER_ID: התיקייה שבה מוגדרת תוכנית ההשקה.
- ‫ROLLOUT_PLAN_NAME: השם של תוכנית ההשקה בהתאמה אישית שהגדרתם.
אם לא מציינים דגל של תוכנית השקה, VM Extension Manager משתמש ב-slow_rollout.
‫ROLLOUT_CONFLICT_BEHAVIOR: קובע את ההתנהגות כש-VM Extension Manager מזהה התנגשות בין מדיניות אזורית למדיניות גלובלית. אפשר לציין אחת מההתנהגויות הבאות במקרה של התנגשות:
- "" (מחרוזת ריקה): המדיניות הגלובלית לא מחליפה כללי מדיניות אזוריים עם אותו שם שמתנגשים איתה. ההתנהגות הזו במקרה של התנגשות היא ברירת המחדל.
- ‫overwrite: המדיניות הגלובלית מחליפה כל מדיניות אזורית עם אותו שם, ואז המדיניות הגלובלית מנהלת את השקות המדיניות באזור.
מידע נוסף זמין בקטע הדגל --rollout-conflict-behavior.
RETRY_UUID: מזהה UUID שמזהה ניסיון חוזר להשקת עדכון מדיניות. ה-UUID הזה מאפשר לכם לנסות שוב לבצע עדכון בלי שינויים. אם מגדירים את הדגל הזה ומשנים את המדיניות, תופיע שגיאה. מידע נוסף זמין במאמר ניסיון חוזר של השקה.

REST

כדי לעדכן מדיניות הרחבה גלובלית ברמת התיקייה, צריך לשלוח בקשת PATCH ל-method‏ folderGlobalVmExtensionPolicies.update. כשמעדכנים מדיניות באמצעות REST, צריך לספק רק את השדות שרוצים לעדכן. כל השדות שתשמיטו ישמרו על הערכים הקיימים שלהם.

PATCH https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

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

‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים לעדכן.
‫DESCRIPTION: תיאור של מדיניות התוספים של המכונה הווירטואלית.
‫EXTENSION_NAME: שם התוסף שצריך לעדכן, שמשמש כמפתח במפה extensionPolicies. כדי לעדכן כמה תוספים, צריך לכלול כמה רשומות במפה extensionPolicies.
‫EXTENSION_NAME_VERSION: הגרסה של תוסף ה-VM.
‫EXTENSION_NAME_CONFIG: הגדרות התצורה של התוסף ל-VM, כמחרוזת בתוך השורה.
‫KEY_1:VALUE_1,‏ KEY_2:VALUE_2: צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות יטורגטו, הן צריכות לכלול את כל התוויות שצוינו בבורר. כדי לציין כמה סלקטורים, צריך לכלול כמה אובייקטים במערך instanceSelectors, כל אחד עם שדה labelSelector. במקרה כזה, VM Extension Manager מטרגט מכונות וירטואליות שתואמות לכל אחד מהבוררים שצוינו (OR לוגי). אם משמיטים את instanceSelectors, המדיניות מטרגטת את כל המכונות הווירטואליות בכל הפרויקטים והאזורים הצאצאים בתיקייה.
‫PRIORITY: מספר שלם מ-0 עד 65535 שמגדיר את העדיפות של המדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1000. אם לכמה כללי מדיניות יש אותה עדיפות, VM Extension Manager מחיל על המכונות הווירטואליות את המדיניות שעודכנה לאחרונה.
‫ROLLOUT_CONFLICT_BEHAVIOR: קובע את ההתנהגות כש-VM Extension Manager מזהה התנגשות בין מדיניות אזורית למדיניות גלובלית. אפשר לציין אחת מההתנהגויות הבאות במקרה של התנגשות:
- "" (מחרוזת ריקה): המדיניות הגלובלית לא מחליפה כללי מדיניות אזוריים עם אותו שם שמתנגשים איתה. ההתנהגות הזו במקרה של התנגשות היא ברירת המחדל.
- ‫overwrite: המדיניות הגלובלית מחליפה כל מדיניות אזורית עם אותו שם, ואז המדיניות הגלובלית מנהלת את השקות המדיניות באזור.
מידע נוסף זמין בקטע הדגל --rollout-conflict-behavior.
‫ROLLOUT_PLAN_NAME: השם של תוכנית ההשקה בהתאמה אישית שהגדרתם. כדי להשתמש בתוכנית השקה מוגדרת מראש, מחליפים את השדה name ב-predefinedRolloutPlan ומציינים את אחד מהערכים הבאים:
- ‫SLOW_ROLLOUT: המדיניות תושק תוך חמישה ימים. תוכנית ההשקה הזו מוגדרת מראש כברירת מחדל אם לא מציינים תוכנית אחרת.
- ‫FAST_ROLLOUT: השקת המדיניות באופן מיידי בכל האזורים.
RETRY_UUID: מזהה UUID שמזהה ניסיון חוזר להשקת עדכון מדיניות.

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

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

כדי לקבל את ההרשאה שנדרשת לעדכון מדיניות של תוספים ברמת הפרויקט, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין של מדיניות תוספים ל-VM ב-Compute ‏(roles/compute.vmExtensionPolicyAdmin) ב-IAM בפרויקט. להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה מכיל את ההרשאה compute.vmExtensionPolicies.update, שנדרשת כדי לעדכן מדיניות של תוסף ברמת הפרויקט.

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

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

המסוף

כדי לעדכן מדיניות גלובלית של תוספי VM ברמת הפרויקט במסוף Google Cloud :

נכנסים לדף VM extension policies במסוף Google Cloud .
לדף VM extension policies
לוחצים על מדיניות גלובלית ובוחרים את המדיניות שרוצים לערוך.
לוחצים על Edit.
בשדה Priority, מציינים מספר עדיפות כדי לפתור התנגשויות בין כללי מדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1,000.
בקטע ניהול תוספים, מבצעים את הפעולות הבאות:
- כדי להוסיף עוד תוספים, לוחצים על הוספת תוסף ובוחרים את התוסף והגרסה.
- כדי למחוק תוסף שמנוהל על ידי המדיניות הזו, לוחצים על הכפתור מחיקה לצד שם התוסף.
אם רוצים להחיל תוויות, מוסיפים תוויות למכונות היעד הווירטואליות בקטע Target VM instances.
לוחצים על Save.

gcloud

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

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

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

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

‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים לעדכן.
‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫DESCRIPTION: תיאור אופציונלי של המדיניות.
‫EXTENSION_NAME_1,EXTENSION_NAME_2: רשימה מופרדת בפסיקים של תוספים שצריך להוסיף למדיניות. צריך לציין לפחות תוסף אחד. אפשר לציין כל אחת מהסיומות הנתמכות הבאות:
- ops-agent
- google-cloud-sap-extension
- google-cloud-workload-extension
‫EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך, שבה המפתח הוא שם התוסף והערך הוא גרסת התוסף. אם לא מציינים גרסה לתוסף, VM Extension Manager משתמש בגרסה הזמינה האחרונה ומשדרג אותה באופן אוטומטי כשגרסאות חדשות זמינות.
הערה: ב-ops-agent, אפשר להתקין באמצעות VM Extension Manager את גרסה 2.58.0 או גרסאות חדשות יותר. ב-google-cloud-sap-extension וב-google-cloud-workload-extension, VM Extension Manager תומך רק בגרסה העדכנית.
‫EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך, שבה המפתח הוא שם התוסף והערך הוא הנתיב לקובץ התצורה של התוסף הזה. הקובץ הזה נמצא ב-VM שבו מריצים את הפקודה gcloud, ולא ב-VM שבו מתקינים את התוסף.
לחלופין, כדי לספק את ההגדרות כמחרוזת מוטבעת, משתמשים בדגל --config במקום בדגל --config-from-file – לדוגמה, EXTENSION_NAME_1="CONFIG_1". אפשר להשתמש ב---config-from-file או ב---config, אבל לא בשניהם באותה פקודה.
‫KEY_1=VALUE_1: רשימה מופרדת בפסיקים של צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות יטורגטו, הן צריכות לכלול את כל התוויות שצוינו בבורר. אם מציינים את --inclusion-labels כמה פעמים, המדיניות מטרגטת מכונות וירטואליות שתואמות לכל אחד מהבוררים שצוינו (OR לוגי). אם לא מציינים את הדגל הזה, המדיניות מטרגטת את כל המכונות הווירטואליות בכל האזורים בפרויקט.
‫PRIORITY: מספר שלם מ-0 עד 65535 שמגדיר את העדיפות של המדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1000. אם לכמה כללי מדיניות יש אותה עדיפות, VM Extension Manager מחיל על המכונות הווירטואליות את המדיניות שעודכנה לאחרונה.
‫ROLLOUT_PLAN: מציינים slow_rollout או fast_rollout. אם אתם צריכים להשתמש בתוכנית השקה בהתאמה אישית, ציינו את הדגל --rollout-custom-plan במקום --rollout-predefined-plan בפורמט הבא:
```
--rollout-custom-plan=projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_NUMBER: הפרויקט שבו מוגדרת תוכנית ההשקה.
- ‫ROLLOUT_PLAN_NAME: השם של תוכנית ההשקה בהתאמה אישית שהגדרתם.
אם לא מציינים דגל של תוכנית השקה, VM Extension Manager משתמש ב-slow_rollout.
‫ROLLOUT_CONFLICT_BEHAVIOR: קובע את ההתנהגות כש-VM Extension Manager מזהה התנגשות בין מדיניות אזורית למדיניות גלובלית. אפשר לציין אחת מההתנהגויות הבאות במקרה של התנגשות:
- "" (מחרוזת ריקה): המדיניות הגלובלית לא מחליפה כללי מדיניות אזוריים עם אותו שם שמתנגשים איתה. ההתנהגות הזו במקרה של התנגשות היא ברירת המחדל.
- ‫overwrite: המדיניות הגלובלית מחליפה כל מדיניות אזורית עם אותו שם, ואז המדיניות הגלובלית מנהלת את השקות המדיניות באזור.
מידע נוסף זמין בקטע הדגל --rollout-conflict-behavior.
RETRY_UUID: מזהה UUID שמזהה ניסיון חוזר להשקת עדכון מדיניות. ה-UUID הזה מאפשר לכם לנסות שוב לבצע עדכון בלי שינויים. אם מגדירים את הדגל הזה ומשנים את המדיניות, תופיע שגיאה. מידע נוסף זמין במאמר ניסיון חוזר של השקה.

REST

כדי לעדכן מדיניות גלובלית של תוספים ברמת הפרויקט, שולחים בקשת PATCH ל-method‏ globalVmExtensionPolicies.update. כשמעדכנים מדיניות באמצעות REST, צריך לספק רק את השדות שרוצים לעדכן. כל השדות שתשמיטו ישמרו על הערכים הקיימים שלהם.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

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

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים לעדכן.
‫DESCRIPTION: תיאור של מדיניות התוספים של המכונה הווירטואלית.
‫EXTENSION_NAME: שם התוסף שצריך לעדכן, שמשמש כמפתח במפה extensionPolicies. כדי לעדכן כמה תוספים, צריך לכלול כמה רשומות במפה extensionPolicies.
‫EXTENSION_NAME_VERSION: הגרסה של תוסף ה-VM.
‫EXTENSION_NAME_CONFIG: הגדרות התצורה של התוסף ל-VM, כמחרוזת בתוך השורה.
‫KEY_1:VALUE_1,‏ KEY_2:VALUE_2: צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות יטורגטו, הן צריכות לכלול את כל התוויות שצוינו בבורר. כדי לציין כמה סלקטורים, צריך לכלול כמה אובייקטים במערך instanceSelectors, כל אחד עם שדה labelSelector. במקרה כזה, VM Extension Manager מטרגט מכונות וירטואליות שתואמות לכל אחד מהבוררים שצוינו (OR לוגי). אם לא מציינים את instanceSelectors, המדיניות מטרגטת את כל המכונות הווירטואליות בכל האזורים בפרויקט.
‫PRIORITY: מספר שלם מ-0 עד 65535 שמגדיר את העדיפות של המדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1000. אם לכמה כללי מדיניות יש אותה עדיפות, VM Extension Manager מחיל על המכונות הווירטואליות את המדיניות שעודכנה לאחרונה.
‫ROLLOUT_CONFLICT_BEHAVIOR: קובע את ההתנהגות כש-VM Extension Manager מזהה התנגשות בין מדיניות אזורית למדיניות גלובלית. אפשר לציין אחת מההתנהגויות הבאות במקרה של התנגשות:
- "" (מחרוזת ריקה): המדיניות הגלובלית לא מחליפה כללי מדיניות אזוריים עם אותו שם שמתנגשים איתה. ההתנהגות הזו במקרה של התנגשות היא ברירת המחדל.
- ‫overwrite: המדיניות הגלובלית מחליפה כל מדיניות אזורית עם אותו שם, ואז המדיניות הגלובלית מנהלת את השקות המדיניות באזור.
מידע נוסף זמין בקטע הדגל --rollout-conflict-behavior.
‫PROJECT_NUMBER: הפרויקט שבו מוגדרת תוכנית ההשקה בהתאמה אישית.
‫ROLLOUT_PLAN_NAME: השם של תוכנית ההשקה בהתאמה אישית שהגדרתם. כדי להשתמש בתוכנית השקה מוגדרת מראש, מחליפים את השדה name ב-predefinedRolloutPlan ומציינים את אחד מהערכים הבאים:
- ‫SLOW_ROLLOUT: המדיניות תושק תוך חמישה ימים. תוכנית ההשקה הזו מוגדרת מראש כברירת מחדל אם לא מציינים תוכנית אחרת.
- ‫FAST_ROLLOUT: השקת המדיניות באופן מיידי בכל האזורים.
RETRY_UUID: מזהה UUID שמזהה ניסיון חוזר להשקת עדכון מדיניות.

שינוי תוספי VM באזור מסוים בארגון

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

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

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

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

gcloud

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

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

gcloud preview compute zone-vm-extension-policies update POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

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

‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים לעדכן.
‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
‫ZONE: האזור Google Cloud שבו המדיניות חלה.
‫DESCRIPTION: תיאור אופציונלי של המדיניות.
‫EXTENSION_NAME_1,EXTENSION_NAME_2: רשימה מופרדת בפסיקים של תוספים שצריך להוסיף למדיניות. צריך לציין לפחות תוסף אחד. אפשר לציין כל אחת מהסיומות הנתמכות הבאות:
- ops-agent
- google-cloud-sap-extension
- google-cloud-workload-extension
‫EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך, שבה המפתח הוא שם התוסף והערך הוא גרסת התוסף. אם לא מציינים גרסה לתוסף, VM Extension Manager משתמש בגרסה הזמינה האחרונה ומשדרג אותה באופן אוטומטי כשגרסאות חדשות זמינות.
הערה: ב-ops-agent, אפשר להתקין באמצעות VM Extension Manager את גרסה 2.58.0 או גרסאות חדשות יותר. ב-google-cloud-sap-extension וב-google-cloud-workload-extension, VM Extension Manager תומך רק בגרסה העדכנית.
‫EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך, שבה המפתח הוא שם התוסף והערך הוא הנתיב לקובץ התצורה של התוסף הזה. הקובץ הזה נמצא ב-VM שבו מריצים את הפקודה gcloud, ולא ב-VM שבו מתקינים את התוסף.
לחלופין, כדי לספק את ההגדרות כמחרוזת מוטבעת, משתמשים בדגל --config במקום בדגל --config-from-file – לדוגמה, EXTENSION_NAME_1="CONFIG_1". אפשר להשתמש ב---config-from-file או ב---config, אבל לא בשניהם באותה פקודה.
‫KEY_1=VALUE_1: רשימה מופרדת בפסיקים של צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות יטורגטו, הן צריכות לכלול את כל התוויות שצוינו בבורר. אם מציינים את --inclusion-labels כמה פעמים, המדיניות מטרגטת מכונות וירטואליות שתואמות לכל אחד מהבוררים שצוינו (OR לוגי). אם לא תציינו את הדגל הזה, המדיניות תטרגט את כל המכונות הווירטואליות באזור שצוין בכל הפרויקטים הצאצאים בארגון.
‫PRIORITY: מספר שלם מ-0 עד 65535 שמגדיר את העדיפות של המדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1000. אם לכמה כללי מדיניות יש אותה עדיפות, VM Extension Manager מחיל על המכונות הווירטואליות את המדיניות שעודכנה לאחרונה.

REST

כדי לעדכן מדיניות של הרחבה אזורית ברמת הארגון, שולחים בקשת PATCH ל-method‏ organizationZoneVmExtensionPolicies.update. כשמעדכנים מדיניות באמצעות REST, צריך לספק רק את השדות שרוצים לעדכן. כל השדות שתשמיטו ישמרו על הערכים הקיימים שלהם.

PATCH https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

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

‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
‫ZONE: האזור Google Cloud שבו נמצאת מדיניות התוספים של המכונה הווירטואלית.
‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים לעדכן.
‫DESCRIPTION: תיאור של מדיניות התוספים של המכונה הווירטואלית.
‫EXTENSION_NAME: שם התוסף שצריך לעדכן, שמשמש כמפתח במפה extensionPolicies. כדי לעדכן כמה תוספים, צריך לכלול כמה רשומות במפה extensionPolicies.
‫EXTENSION_NAME_VERSION: הגרסה של תוסף ה-VM.
‫EXTENSION_NAME_CONFIG: הגדרות התצורה של התוסף ל-VM, כמחרוזת בתוך השורה.
‫KEY_1:VALUE_1,‏ KEY_2:VALUE_2: צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות יטורגטו, הן צריכות לכלול את כל התוויות שצוינו בבורר. כדי לציין כמה סלקטורים, צריך לכלול כמה אובייקטים במערך instanceSelectors, כל אחד עם שדה labelSelector. במקרה כזה, VM Extension Manager מטרגט מכונות וירטואליות שתואמות לכל אחד מהבוררים שצוינו (OR לוגי). אם לא מציינים את instanceSelectors, המדיניות חלה על כל המכונות הווירטואליות באזור שצוין בכל הפרויקטים הצאצאים בארגון.
‫PRIORITY: מספר שלם מ-0 עד 65535 שמגדיר את העדיפות של המדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1000. אם לכמה כללי מדיניות יש אותה עדיפות, VM Extension Manager מחיל על המכונות הווירטואליות את המדיניות שעודכנה לאחרונה.

שינוי תוספי VM באזור מסוים בתיקייה

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

התפקיד המוגדר מראש הזה מכיל את ההרשאה compute.folderVmExtensionPolicies.update, שנדרשת כדי לעדכן מדיניות הרחבה ברמת התיקייה.

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

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

gcloud

כדי לשנות מדיניות קיימת של תוסף VM ברמת האזור ובהיקף התיקייה, משתמשים בפקודה gcloud preview compute zone-vm-extension-policies update עם הדגל --folder. כשמעדכנים מדיניות באמצעות gcloud, הבקשה פועלת כהחלפה מלאה. כל השדות האופציונליים שתשמיטו יחזרו לערכי ברירת המחדל שלהם, במקום לשמור על הערכים הקיימים מהמדיניות ששונתה.

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

gcloud preview compute zone-vm-extension-policies update POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

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

‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים לעדכן.
‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
‫ZONE: האזור Google Cloud שבו המדיניות חלה.
‫DESCRIPTION: תיאור אופציונלי של המדיניות.
‫EXTENSION_NAME_1,EXTENSION_NAME_2: רשימה מופרדת בפסיקים של תוספים שצריך להוסיף למדיניות. צריך לציין לפחות תוסף אחד. אפשר לציין כל אחת מהסיומות הנתמכות הבאות:
- ops-agent
- google-cloud-sap-extension
- google-cloud-workload-extension
‫EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך, שבה המפתח הוא שם התוסף והערך הוא גרסת התוסף. אם לא מציינים גרסה לתוסף, VM Extension Manager משתמש בגרסה הזמינה האחרונה ומשדרג אותה באופן אוטומטי כשגרסאות חדשות זמינות.
הערה: ב-ops-agent, אפשר להתקין באמצעות VM Extension Manager את גרסה 2.58.0 או גרסאות חדשות יותר. ב-google-cloud-sap-extension וב-google-cloud-workload-extension, VM Extension Manager תומך רק בגרסה העדכנית.
‫EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך, שבה המפתח הוא שם התוסף והערך הוא הנתיב לקובץ התצורה של התוסף הזה. הקובץ הזה נמצא ב-VM שבו מריצים את הפקודה gcloud, ולא ב-VM שבו מתקינים את התוסף.
לחלופין, כדי לספק את ההגדרות כמחרוזת מוטבעת, משתמשים בדגל --config במקום בדגל --config-from-file – לדוגמה, EXTENSION_NAME_1="CONFIG_1". אפשר להשתמש ב---config-from-file או ב---config, אבל לא בשניהם באותה פקודה.
‫KEY_1=VALUE_1: רשימה מופרדת בפסיקים של צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות יטורגטו, הן צריכות לכלול את כל התוויות שצוינו בבורר. אם מציינים את --inclusion-labels כמה פעמים, המדיניות מטרגטת מכונות וירטואליות שתואמות לכל אחד מהבוררים שצוינו (OR לוגי). אם לא תציינו את הדגל הזה, המדיניות תטרגט את כל המכונות הווירטואליות באזור שצוין בכל הפרויקטים הצאצאים בתיקייה.
‫PRIORITY: מספר שלם מ-0 עד 65535 שמגדיר את העדיפות של המדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1000. אם לכמה כללי מדיניות יש אותה עדיפות, VM Extension Manager מחיל על המכונות הווירטואליות את המדיניות שעודכנה לאחרונה.

REST

כדי לעדכן מדיניות הרחבה אזורית ברמת התיקייה, צריך לשלוח בקשת PATCH ל-method‏ folderZoneVmExtensionPolicies.update. כשמעדכנים מדיניות באמצעות REST, צריך לספק רק את השדות שרוצים לעדכן. כל השדות שתשמיטו ישמרו על הערכים הקיימים שלהם.

PATCH https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

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

‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
‫ZONE: האזור Google Cloud שבו נמצאת מדיניות התוספים של המכונה הווירטואלית.
‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים לעדכן.
‫DESCRIPTION: תיאור של מדיניות התוספים של המכונה הווירטואלית.
‫EXTENSION_NAME: שם התוסף שצריך לעדכן, שמשמש כמפתח במפה extensionPolicies. כדי לעדכן כמה תוספים, צריך לכלול כמה רשומות במפה extensionPolicies.
‫EXTENSION_NAME_VERSION: הגרסה של תוסף ה-VM.
‫EXTENSION_NAME_CONFIG: הגדרות התצורה של התוסף ל-VM, כמחרוזת בתוך השורה.
‫KEY_1:VALUE_1,‏ KEY_2:VALUE_2: צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות יטורגטו, הן צריכות לכלול את כל התוויות שצוינו בבורר. כדי לציין כמה סלקטורים, צריך לכלול כמה אובייקטים במערך instanceSelectors, כל אחד עם שדה labelSelector. במקרה כזה, VM Extension Manager מטרגט מכונות וירטואליות שתואמות לכל אחד מהבוררים שצוינו (OR לוגי). אם משמיטים את instanceSelectors, המדיניות מטרגטת את כל המכונות הווירטואליות באזור שצוין בכל הפרויקטים הצאצאים בתיקייה.
‫PRIORITY: מספר שלם מ-0 עד 65535 שמגדיר את העדיפות של המדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1000. אם לכמה כללי מדיניות יש אותה עדיפות, VM Extension Manager מחיל על המכונות הווירטואליות את המדיניות שעודכנה לאחרונה.

שינוי תוספים של מכונות וירטואליות באזור בפרויקט

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

התפקיד המוגדר מראש הזה מכיל את ההרשאה compute.vmExtensionPolicies.update, שנדרשת כדי לעדכן מדיניות של תוסף ברמת הפרויקט.

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

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

המסוף

כדי לעדכן מדיניות של תוסף למכונות וירטואליות ברמת האזור ובהיקף הפרויקט באמצעות מסוף Google Cloud :

נכנסים לדף VM extension policies במסוף Google Cloud .
לדף VM extension policies
בוחרים את המדיניות שרוצים לעדכן.
לוחצים על Edit.
משנים את הערכים של Description,‏ Priority,‏ Extensions או Target VM instances.
לוחצים על Save.

gcloud

כדי לשנות מדיניות קיימת של תוספי VM ברמת האזור ובהיקף הפרויקט, משתמשים בפקודה gcloud compute zone-vm-extension-policies update. כשמעדכנים מדיניות באמצעות gcloud, הבקשה פועלת כהחלפה מלאה. כל השדות האופציונליים שתשמיטו יחזרו לערכי ברירת המחדל שלהם, במקום לשמור על הערכים הקיימים מהמדיניות ששונתה.

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

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

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

‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים לעדכן.
‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫ZONE: האזור Google Cloud שבו המדיניות חלה.
‫DESCRIPTION: תיאור אופציונלי של המדיניות.
‫EXTENSION_NAME_1,EXTENSION_NAME_2: רשימה מופרדת בפסיקים של תוספים שצריך להוסיף למדיניות. צריך לציין לפחות תוסף אחד. אפשר לציין כל אחת מהסיומות הנתמכות הבאות:
- ops-agent
- google-cloud-sap-extension
- google-cloud-workload-extension
‫EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך, שבה המפתח הוא שם התוסף והערך הוא גרסת התוסף. אם לא מציינים גרסה לתוסף, VM Extension Manager משתמש בגרסה הזמינה האחרונה ומשדרג אותה באופן אוטומטי כשגרסאות חדשות זמינות.
הערה: ב-ops-agent, אפשר להתקין באמצעות VM Extension Manager את גרסה 2.58.0 או גרסאות חדשות יותר. ב-google-cloud-sap-extension וב-google-cloud-workload-extension, VM Extension Manager תומך רק בגרסה העדכנית.
‫EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: רשימה מופרדת בפסיקים של צמדי מפתח/ערך, שבה המפתח הוא שם התוסף והערך הוא הנתיב לקובץ התצורה של התוסף הזה. הקובץ הזה נמצא ב-VM שבו מריצים את הפקודה gcloud, ולא ב-VM שבו מתקינים את התוסף.
לחלופין, כדי לספק את ההגדרות כמחרוזת מוטבעת, משתמשים בדגל --config במקום בדגל --config-from-file – לדוגמה, EXTENSION_NAME_1="CONFIG_1". אפשר להשתמש ב---config-from-file או ב---config, אבל לא בשניהם באותה פקודה.
‫KEY_1=VALUE_1: רשימה מופרדת בפסיקים של צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות יטורגטו, הן צריכות לכלול את כל התוויות שצוינו בבורר. אם מציינים את --inclusion-labels כמה פעמים, המדיניות מטרגטת מכונות וירטואליות שתואמות לכל אחד מהבוררים שצוינו (OR לוגי). אם לא מציינים את הדגל הזה, המדיניות מטרגטת את כל המכונות הווירטואליות באזור שצוין בפרויקט.
‫PRIORITY: מספר שלם מ-0 עד 65535 שמגדיר את העדיפות של המדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1000. אם לכמה כללי מדיניות יש אותה עדיפות, VM Extension Manager מחיל על המכונות הווירטואליות את המדיניות שעודכנה לאחרונה.

REST

כדי לעדכן מדיניות הרחבה ברמת האזור בהיקף הפרויקט, שולחים בקשת PATCH ל-method‏ zoneVmExtensionPolicies.update. כשמעדכנים מדיניות באמצעות REST, צריך לספק רק את השדות שרוצים לעדכן. כל השדות שתשמיטו ישמרו על הערכים הקיימים שלהם.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

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

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫ZONE: האזור Google Cloud שבו נמצאת מדיניות התוספים של המכונה הווירטואלית.
‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים לעדכן.
‫DESCRIPTION: תיאור של מדיניות התוספים של המכונה הווירטואלית.
‫EXTENSION_NAME: שם התוסף שצריך לעדכן, שמשמש כמפתח במפה extensionPolicies. כדי לעדכן כמה תוספים, צריך לכלול כמה רשומות במפה extensionPolicies.
‫EXTENSION_NAME_VERSION: הגרסה של תוסף ה-VM.
‫EXTENSION_NAME_CONFIG: הגדרות התצורה של התוסף ל-VM, כמחרוזת בתוך השורה.
‫KEY_1:VALUE_1,‏ KEY_2:VALUE_2: צמדי מפתח/ערך שמגדירים תוויות הכללה לבורר. כדי שהמכונות הווירטואליות יטורגטו, הן צריכות לכלול את כל התוויות שצוינו בבורר. כדי לציין כמה סלקטורים, צריך לכלול כמה אובייקטים במערך instanceSelectors, כל אחד עם שדה labelSelector. במקרה כזה, VM Extension Manager מטרגט מכונות וירטואליות שתואמות לכל אחד מהבוררים שצוינו (OR לוגי). אם לא מציינים את instanceSelectors, המדיניות מטרגטת את כל המכונות הווירטואליות באזור שצוין בפרויקט.
‫PRIORITY: מספר שלם מ-0 עד 65535 שמגדיר את העדיפות של המדיניות. מספרים נמוכים יותר מציינים עדיפות גבוהה יותר. ערך ברירת המחדל הוא 1000. אם לכמה כללי מדיניות יש אותה עדיפות, VM Extension Manager מחיל על המכונות הווירטואליות את המדיניות שעודכנה לאחרונה.

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

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

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

הסרת תוספי VM בכל האזורים בארגון

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

כדי לקבל את ההרשאה שנדרשת למחיקת מדיניות של תוספים ברמת הארגון, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין של מדיניות תוספים למכונות וירטואליות ב-Compute ברמת הארגון (roles/compute.orgVmExtensionPolicyAdmin) ב-IAM בארגון. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה מכיל את ההרשאה compute.orgVmExtensionPolicies.delete, שנדרשת כדי למחוק מדיניות של תוסף ברמת הארגון.

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

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

gcloud

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

gcloud preview compute global-vm-extension-policies delete POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

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

‫POLICY_NAME: השם של מדיניות התוספים למכונות וירטואליות שרוצים למחוק.
‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
‫ROLLOUT_PLAN: מציינים slow_rollout או fast_rollout. אם אתם צריכים להשתמש בתוכנית השקה בהתאמה אישית, ציינו את הדגל --rollout-custom-plan במקום --rollout-predefined-plan בפורמט הבא:
```
--rollout-custom-plan=organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫ORGANIZATION_ID: הארגון שבו מוגדרת תוכנית ההשקה.
- ‫ROLLOUT_PLAN_NAME: השם של תוכנית ההשקה בהתאמה אישית שהגדרתם.
אם לא מציינים דגל של תוכנית השקה, VM Extension Manager משתמש ב-slow_rollout.
‫RETRY_UUID: מזהה UUID כדי לנסות שוב למחוק מדיניות של תוסף. צריך להגדיר את השדה הזה רק כשמנסים שוב לשלוח בקשת מחיקה של מדיניות קיימת שנמצאת במצב DELETING. אם מגדירים את השדה הזה כשהמדיניות לא במצב DELETING, תופיע שגיאה. מידע נוסף זמין במאמר ניסיון חוזר של השקה.

REST

כדי למחוק מדיניות הרחבה גלובלית ברמת הארגון, שולחים בקשת POST אל ה-method‏ organizationGlobalVmExtensionPolicies.delete.

POST https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies/POLICY_NAME/delete

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

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

‫POLICY_NAME: השם של מדיניות התוספים למכונות וירטואליות שרוצים למחוק.
‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
‫ROLLOUT_PLAN: מציינים SLOW_ROLLOUT או FAST_ROLLOUT. כדי להשתמש בתוכנית השקה בהתאמה אישית, מחליפים את predefinedRolloutPlan ב-"name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
‫RETRY_UUID: מזהה UUID כדי לנסות שוב למחוק מדיניות של תוסף. צריך להגדיר את השדה הזה רק כשמנסים שוב לשלוח בקשת מחיקה של מדיניות קיימת שנמצאת במצב DELETING. אם מגדירים את השדה הזה כשהמדיניות לא במצב DELETING, תופיע שגיאה. מידע נוסף זמין במאמר ניסיון חוזר של השקה.

הסרת ההתקנה של תוספי VM בכל האזורים בתיקייה

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

כדי לקבל את ההרשאה שנדרשת למחיקת מדיניות הרחבה ברמת התיקייה, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין של מדיניות הרחבה של VM ב-Compute ברמת התיקייה (roles/compute.folderVmExtensionPolicyAdmin) ב-IAM בתיקייה. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאה compute.folderVmExtensionPolicies.delete, שנדרשת כדי למחוק מדיניות הרחבה ברמת התיקייה.

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

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

gcloud

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

gcloud preview compute global-vm-extension-policies delete POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

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

‫POLICY_NAME: השם של מדיניות התוספים למכונות וירטואליות שרוצים למחוק.
‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
‫ROLLOUT_PLAN: מציינים slow_rollout או fast_rollout. אם אתם צריכים להשתמש בתוכנית השקה בהתאמה אישית, ציינו את הדגל --rollout-custom-plan במקום --rollout-predefined-plan בפורמט הבא:
```
--rollout-custom-plan=folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫FOLDER_ID: התיקייה שבה מוגדרת תוכנית ההשקה.
- ‫ROLLOUT_PLAN_NAME: השם של תוכנית ההשקה בהתאמה אישית שהגדרתם.
אם לא מציינים דגל של תוכנית השקה, VM Extension Manager משתמש ב-slow_rollout.
‫RETRY_UUID: מזהה UUID כדי לנסות שוב למחוק מדיניות של תוסף. צריך להגדיר את השדה הזה רק כשמנסים שוב לשלוח בקשת מחיקה של מדיניות קיימת שנמצאת במצב DELETING. אם מגדירים את השדה הזה כשהמדיניות לא במצב DELETING, תופיע שגיאה. מידע נוסף זמין במאמר ניסיון חוזר של השקה.

REST

כדי למחוק מדיניות הרחבה גלובלית ברמת התיקייה, צריך לשלוח בקשת POST ל-method‏ folderGlobalVmExtensionPolicies.delete.

POST https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies/POLICY_NAME/delete

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

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

‫POLICY_NAME: השם של מדיניות התוספים למכונות וירטואליות שרוצים למחוק.
‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
‫ROLLOUT_PLAN: מציינים SLOW_ROLLOUT או FAST_ROLLOUT. כדי להשתמש בתוכנית השקה בהתאמה אישית, מחליפים את predefinedRolloutPlan ב-"name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
‫RETRY_UUID: מזהה UUID כדי לנסות שוב למחוק מדיניות של תוסף. צריך להגדיר את השדה הזה רק כשמנסים שוב לשלוח בקשת מחיקה של מדיניות קיימת שנמצאת במצב DELETING. אם מגדירים את השדה הזה כשהמדיניות לא במצב DELETING, תופיע שגיאה. מידע נוסף זמין במאמר ניסיון חוזר של השקה.

הסרת תוספי VM בכל האזורים בפרויקט

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

כדי לקבל את ההרשאה שנדרשת למחיקת מדיניות של תוספים ברמת הפרויקט, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין של מדיניות תוספים למכונות וירטואליות ב-Compute ‏(roles/compute.vmExtensionPolicyAdmin) ב-IAM בפרויקט. להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאה compute.vmExtensionPolicies.delete, שנדרשת כדי למחוק מדיניות הרחבה ברמת הפרויקט.

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

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

המסוף

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

נכנסים לדף VM extension policies במסוף Google Cloud .
לדף VM extension policies
לוחצים על מדיניות גלובלית ובוחרים את המדיניות שרוצים למחוק.
לוחצים על Delete.
בתיבת הדו-שיח לאישור, מזינים את שם המדיניות ולוחצים על מחיקה.

gcloud

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

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

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

‫POLICY_NAME: השם של מדיניות התוספים למכונות וירטואליות שרוצים למחוק.
‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫ROLLOUT_PLAN: מציינים slow_rollout או fast_rollout. אם אתם צריכים להשתמש בתוכנית השקה בהתאמה אישית, ציינו את הדגל --rollout-custom-plan במקום --rollout-predefined-plan בפורמט הבא:
```
--rollout-custom-plan=projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_NUMBER: הפרויקט שבו מוגדרת תוכנית ההשקה.
- ‫ROLLOUT_PLAN_NAME: השם של תוכנית ההשקה בהתאמה אישית שהגדרתם.
אם לא מציינים דגל של תוכנית השקה, VM Extension Manager משתמש ב-slow_rollout.
‫RETRY_UUID: מזהה UUID כדי לנסות שוב למחוק מדיניות של תוסף. צריך להגדיר את השדה הזה רק כשמנסים שוב לשלוח בקשת מחיקה של מדיניות קיימת שנמצאת במצב DELETING. אם מגדירים את השדה הזה כשהמדיניות לא במצב DELETING, תופיע שגיאה. מידע נוסף זמין במאמר ניסיון חוזר של השקה.

REST

כדי למחוק מדיניות גלובלית של תוספים ברמת הפרויקט, שולחים בקשת POST ל-method‏ globalVmExtensionPolicies.delete.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies/POLICY_NAME/delete

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

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

‫POLICY_NAME: השם של מדיניות התוספים למכונות וירטואליות שרוצים למחוק.
‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫ROLLOUT_PLAN: מציינים SLOW_ROLLOUT או FAST_ROLLOUT. כדי להשתמש בתוכנית השקה בהתאמה אישית, מחליפים את predefinedRolloutPlan ב-"name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
‫RETRY_UUID: מזהה UUID כדי לנסות שוב למחוק מדיניות של תוסף. צריך להגדיר את השדה הזה רק כשמנסים שוב לשלוח בקשת מחיקה של מדיניות קיימת שנמצאת במצב DELETING. אם מגדירים את השדה הזה כשהמדיניות לא במצב DELETING, תופיע שגיאה. מידע נוסף זמין במאמר ניסיון חוזר של השקה.

הסרת תוספי VM באזור מסוים בכל הארגון

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

התפקיד המוגדר מראש הזה מכיל את ההרשאה compute.orgVmExtensionPolicies.delete, שנדרשת כדי למחוק מדיניות של תוסף ברמת הארגון.

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

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

gcloud

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

gcloud preview compute zone-vm-extension-policies delete POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

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

‫POLICY_NAME: השם של מדיניות התוספים למכונות וירטואליות שרוצים למחוק.
‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
‫ZONE: האזור Google Cloud שבו נמצאת המדיניות.

REST

כדי למחוק מדיניות של תוסף אזורי ברמת הארגון, שולחים בקשת DELETE ל-method‏ organizationZoneVmExtensionPolicies.delete.

DELETE https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

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

‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים למחוק.
‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
‫ZONE: האזור Google Cloud שבו נמצאת המדיניות.

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

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

התפקיד המוגדר מראש הזה כולל את ההרשאה compute.folderVmExtensionPolicies.delete, שנדרשת כדי למחוק מדיניות הרחבה ברמת התיקייה.

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

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

gcloud

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

gcloud preview compute zone-vm-extension-policies delete POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

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

‫POLICY_NAME: השם של מדיניות התוספים למכונות וירטואליות שרוצים למחוק.
‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
‫ZONE: האזור Google Cloud שבו נמצאת המדיניות.

REST

כדי למחוק מדיניות של תוסף אזורי ברמת התיקייה, שולחים בקשת DELETE ל-method‏ folderZoneVmExtensionPolicies.delete.

DELETE https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

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

‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים למחוק.
‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
‫ZONE: האזור Google Cloud שבו נמצאת המדיניות.

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

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

התפקיד המוגדר מראש הזה כולל את ההרשאה compute.vmExtensionPolicies.delete, שנדרשת כדי למחוק מדיניות הרחבה ברמת הפרויקט.

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

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

המסוף

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

נכנסים לדף VM extension policies במסוף Google Cloud .
לדף VM extension policies
בוחרים את המדיניות שרוצים למחוק.
לוחצים על Delete.
בתיבת הדו-שיח לאישור, לוחצים על מחיקה.

gcloud

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

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

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

‫POLICY_NAME: השם של מדיניות התוספים למכונות וירטואליות שרוצים למחוק.
‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫ZONE: האזור Google Cloud שבו נמצאת המדיניות.

REST

כדי למחוק מדיניות הרחבה אזורית ברמת הפרויקט, שולחים בקשת DELETE ל-method‏ zoneVmExtensionPolicies.delete.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

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

‫POLICY_NAME: השם של מדיניות התוספים של ה-VM שרוצים למחוק.
‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫ZONE: האזור Google Cloud שבו נמצאת המדיניות.

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

כדי לבדוק את התקדמות ההשקה ואת סטטוס התקינות של התוסף, קראו את המאמר הצגת הפרטים והסטטוס של תוסף למכונה וירטואלית.
כדי לאבחן השקות שנכשלו, לבדוק תהליכים שפועלים במכונות האורחות או לבחון את יומני ניפוי הבאגים של הסוכנים במכונות האורחות, קראו את המאמר פתרון בעיות בתוספים של מכונות וירטואליות.
כדי ליצור לוחות בקרה של Cloud Monitoring ולהגדיר התראות על תקינות הסוכן, המעבד (CPU) והשימוש בזיכרון, קראו את המאמר מעקב אחרי תוספים של מכונות וירטואליות.
כדי לשלוח שאילתות לגבי אירועי אכיפה היסטוריים ולבדוק רשומות של התקנות או קריסות ב-Cloud Logging, קראו את המאמר הצגת יומנים של תוספי VM.

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

מגבלות על ניהול המדיניות

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

שינוי תוספי VM בכל האזורים בארגון

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

gcloud

דוגמה: עדכון מדיניות גלובלית ברמת הארגון

REST

שינוי תוספי VM בכל האזורים בתיקייה

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

gcloud

REST

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

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

המסוף

gcloud

REST

שינוי תוספי VM באזור מסוים בארגון

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

gcloud

REST

שינוי תוספי VM באזור מסוים בתיקייה

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

gcloud

REST

שינוי תוספים של מכונות וירטואליות באזור בפרויקט

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

המסוף

gcloud

REST

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

הסרת תוספי VM בכל האזורים בארגון

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

gcloud

REST

הסרת ההתקנה של תוספי VM בכל האזורים בתיקייה

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

gcloud

REST

הסרת תוספי VM בכל האזורים בפרויקט

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

המסוף

gcloud

REST

הסרת תוספי VM באזור מסוים בכל הארגון

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

gcloud

REST

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

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

gcloud

REST

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

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

המסוף

gcloud

REST

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

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