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

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

מידע על הפרטים והסטטוס של התוספים

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

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

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

אתם יכולים להשתמש ב-Google Cloud CLI או ב-Compute Engine API כדי לראות את הפרטים של התוספים המותקנים למכונות וירטואליות. במאמר הזה מוסבר איך משתמשים ב-gcloud. במאמר הצגת מצבי התוספים של מכונה וירטואלית במכונה מוסבר איך משתמשים ב-Compute Engine API כדי לראות את מצבי התוספים.

הרשאות IAM שנדרשות כדי לראות את פרטי התוסף

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

פרויקט

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

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

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

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

  • תיאור של תוסף ספציפי למכונה וירטואלית במכונה: compute.vmExtensions.get
  • הצגת רשימה של כל התוספים של המכונה הווירטואלית במכונה: compute.vmExtensions.list

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

תיקייה

כללי מדיניות של תוספים ברמת התיקייה זמינים בגרסת טרום-השקה (Preview).

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

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

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

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

  • תיאור של תוסף ספציפי למכונה וירטואלית במכונה: compute.folderVmExtensions.get
  • הצגת רשימה של כל התוספים של המכונה הווירטואלית במכונה: compute.folderVmExtensions.list

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

ארגון

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

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

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

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

כדי לראות את כללי המדיניות של תוספי ה-VM ברמת הארגון, ברמה הגלובלית או ברמת האזור, נדרשות ההרשאות הבאות:

  • תיאור של תוסף ספציפי למכונה וירטואלית במכונה: compute.orgVmExtensions.get
  • הצגת רשימה של כל התוספים של המכונה הווירטואלית במכונה: compute.orgVmExtensions.list

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

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

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

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

אזורי

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

ברמת הפרויקט

gcloud preview compute zone-vm-extension-policies extensions list \
  --project=PROJECT_ID \
  --zone=ZONE

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

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

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

  • כדי לקבל מידע ברמת התיקייה, מחליפים את האפשרות --project=PROJECT_ID באפשרות --folder=folders/FOLDER_ID, כאשר FOLDER_ID הוא המזהה המספרי של התיקייה.
  • כדי לקבל מידע ברמת הארגון, מחליפים את האפשרות --project=PROJECT_ID באפשרות --organization=organizations/ORGANIZATION_ID, כאשר ORGANIZATION_ID הוא המזהה המספרי של הארגון.

עולמי

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

ברמת הפרויקט

gcloud preview compute global-vm-extension-policies extensions list \
  --project=PROJECT_ID

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

  • ‫PROJECT_ID: מזהה הפרויקט.
רמות של תיקיות וארגונים

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

  • כדי לקבל מידע ברמת התיקייה, מחליפים את האפשרות --project=PROJECT_ID באפשרות --folder=folders/FOLDER_ID, כאשר FOLDER_ID הוא המזהה המספרי של התיקייה.
  • כדי לקבל מידע ברמת הארגון, מחליפים את האפשרות --project=PROJECT_ID באפשרות --organization=organizations/ORGANIZATION_ID, כאשר ORGANIZATION_ID הוא המזהה המספרי של הארגון.

הצגת מידע על תוסף ספציפי של VM

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

אזורי

כדי לראות את הפרטים של תוסף VM ספציפי באזור בפרויקט, בתיקייה או בארגון, משתמשים בפקודה gcloud preview compute zone-vm-extension-policies extensions describe:

ברמת הפרויקט

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

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

  • ‫EXTENSION_NAME: אחד מהתוספים שנתמכים ב-VM Extension Manager, לדוגמה ops-agent.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫ZONE: אזור היעד, לדוגמה us-central1-f.
רמות של תיקיות וארגונים

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

  • כדי לקבל מידע ברמת התיקייה, מחליפים את האפשרות --project=PROJECT_ID באפשרות --folder=folders/FOLDER_ID, כאשר FOLDER_ID הוא המזהה המספרי של התיקייה.
  • כדי לקבל מידע ברמת הארגון, מחליפים את האפשרות --project=PROJECT_ID באפשרות --organization=organizations/ORGANIZATION_ID, כאשר ORGANIZATION_ID הוא המזהה המספרי של הארגון.

עולמי

כדי לראות את הפרטים של תוסף ספציפי ל-VM בכל האזורים בפרויקט, בתיקייה או בארגון, משתמשים בפקודה gcloud preview compute global-vm-extension-policies extensions describe:

ברמת הפרויקט

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID

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

  • ‫EXTENSION_NAME: אחד מהתוספים שנתמכים ב-VM Extension Manager, לדוגמה ops-agent.
  • ‫PROJECT_ID: מזהה הפרויקט.
רמות של תיקיות וארגונים

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

  • כדי לקבל מידע ברמת התיקייה, מחליפים את האפשרות --project=PROJECT_ID באפשרות --folder=folders/FOLDER_ID, כאשר FOLDER_ID הוא המזהה המספרי של התיקייה.
  • כדי לקבל מידע ברמת הארגון, מחליפים את האפשרות --project=PROJECT_ID באפשרות --organization=organizations/ORGANIZATION_ID, כאשר ORGANIZATION_ID הוא המזהה המספרי של הארגון.

הצגת המצבים של תוספי VM במכונה

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

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

אתם יכולים להשתמש ב-Google Cloud CLI או ב-Compute Engine API כדי לראות את הסטטוס של התוספים שמותקנים במכונות הווירטואליות. במאמר הזה מוסבר איך משתמשים ב-gcloud. במאמר הצגת מצבי התוספים של מכונה וירטואלית במכונה מוסבר איך משתמשים ב-Compute Engine API כדי לראות את מצבי התוספים.

הרשאות IAM שנדרשות כדי לראות את מצב התוסף

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

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

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

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

  • הצגת רשימה של המצבים של כל התוספים של המכונה הווירטואלית במכונה: compute.instances.listVmExtensionStates
  • כדי לקבל את המצב של תוסף ספציפי למכונה וירטואלית במכונה: compute.instances.getVmExtensionState

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

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

כדי להציג את כל התוספים של ה-VM שמותקנים במכונה ולראות את המצב הנוכחי שלהם באמצעות gcloud, מריצים את הפקודה gcloud beta compute instances list-vm-extension-states:

gcloud beta compute instances list-vm-extension-states INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

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

  • ‫INSTANCE_NAME: השם של המכונה הווירטואלית.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫ZONE: האזור שבו נמצאת המכונה, לדוגמה us-central1-f.

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

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

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

כדי לקבל מידע על הסטטוס של תוסף ספציפי שמותקן ב-VM באמצעות gcloud, מריצים את הפקודה ‎gcloud beta compute instances get-vm-extension-state‎:

gcloud beta compute instances get-vm-extension-state INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE \
    --extension-name=EXTENSION_NAME

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

  • ‫INSTANCE_NAME: השם של המכונה הווירטואלית.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫ZONE: האזור שבו נמצאת המכונה, לדוגמה us-central1-f.
  • ‫EXTENSION_NAME: אחד מהתוספים שנתמכים ב-VM Extension Manager, לדוגמה ops-agent.

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

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

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