פתרון בעיות ב-Cloud Workstations

בדף הזה מופיע מידע שיעזור לכם לפתור בעיות ב-Cloud Workstations.

משיכת קובצי אימג' של המערכת למכונות וירטואליות

כשיוצרים סביבות עבודה באמצעות ההגדרות האישיות של סביבת העבודה, Cloud Workstations שולף קובצי אימג' של המערכת למכונה הווירטואלית (VM) מ-Artifact Registry (או מ-Container Registry). הודעת השגיאה שמופיעה דומה לזו:

System images cannot be pulled onto workstation VMs using this configuration.
Ensure that you have set up Cloud NAT or enabled Private Google Access for
Artifact Registry (and Container Registry).

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

הזמן הקצוב להקצאת ה-VM הסתיים

כשיוצרים סביבות עבודה באמצעות ההגדרות של סביבת העבודה, Cloud Workstations יוצרת מכונה של Compute Engine כדי לגבות את סביבת העבודה. אם יש שגיאה בהקצאת ה-VM, הודעת השגיאה שמופיעה דומה לזו:

Workstations using this configuration cannot be provisioned due to an unknown error.

הנה כמה המלצות:

הגדרת Cloud NAT או הפעלת גישה פרטית ל-Google

אם השבתתם את כתובות ה-IP הציבוריות בהגדרות, אתם יכולים להשתמש באחת מהאפשרויות הבאות:

  • מגדירים את Cloud NAT כדי לאפשר ל-Cloud Workstations לשלוף קובצי אימג' למכונות הווירטואליות של תחנות העבודה.
  • מפעילים את גישה פרטית ל-Google בתת-הרשת. אם אתם משתמשים בשמות הדומיינים private.googleapis.com או restricted.googleapis.com, אתם צריכים ליצור רשומות DNS כדי להפנות את התנועה לכתובות ה-IP שמשויכות לדומיינים האלה. באופן ספציפי, צריך לוודא שמאפשרים גישה לדומיינים של Artifact Registry ו-Container Registry, שתואמים בהתאמה ל-*.pkg.dev ול-*.gcr.io.

מידע נוסף זמין במאמר הגדרת גישה פרטית ל-Google‏ > הגדרת רשת מתקדמת.

מוודאים שממשקי ה-API מופעלים ושיש גישה ל-VPC

אם הפרויקט נמצא בתוך גבולות גזרה של VPC Service Controls, ודאו ש-Cloud Storage API,‏ Container Registry API ו-Artifact Registry API נגישים לענן וירטואלי פרטי (VPC) בתוך גבולות הגזרה לשירות.

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

חשוב לוודא שאתם מאפשרים תעבורת נתונים יוצאת (egress) של TCP ברשת שלכם ביציאות 80 ו-443, כדי לאפשר ל-Cloud Workstations לשלוף קובצי אימג' לתחנת העבודה.

בדיקת יומני ההפעלה של ה-VM ב-Compute Engine לאיתור שגיאות אפשריות

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

SEARCH("workstations-")
sourceLocation.function="main.setupAndRunScript"

אם לא מופיעים יומנים עם המסנן הזה, צריך לוודא שהפעלתם את רישום יומן היציאה הטורית בפרויקט. אם ציינתם חשבון שירות בהגדרות של תחנת העבודה, ודאו שיש לו את ההרשאה logging.logEntries.create בפרויקט כדי שיוכל לכתוב יומנים ב-Cloud Logging. כדי לוודא שהסקריפט לטעינה בזמן ההפעלה של ה-VM ב-Compute Engine יופעל שוב וייצור את היומנים, נסו להפעיל מחדש את תחנת העבודה אחרי שתפעילו את הרישום ביומן של היציאה הטורית ותוסיפו את ההרשאות הנדרשות.

בודקים את יומני ה-API של Compute Engine כדי לראות אם יש שגיאות אפשריות

משתמשים במסנן הבא ביומני Stackdriver:

protoPayload.serviceName="compute.googleapis.com"
severity>=ERROR

יכול להיות ששגיאות ב-Compute Engine API מונעות את היצירה של המכונות הווירטואליות של תחנות העבודה.

הפעלת מאפייני אורח בפרויקט

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

שגיאות העברה לסירוגין בקצה העורפי

אם מדי פעם מופיעה השגיאה "Unable to forward your request to a backend" כשמפעילים תחנת עבודה, יכול להיות ששרת האינטרנט של תחנת העבודה עדיין לא הופעל באופן מלא.

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

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

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

כיבוי בו-זמני של תחנות עבודה כשמשתמשים ב-CMEK

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

באופן ספציפי, צריך לוודא שלסוכן השירות של Compute Engine (service-PROJECT_NUMBER@compute-system.iam.gserviceaccount.com) יש את התפקיד Cloud Key Management Service CryptoKey Encrypter/Decrypter (roles/cloudkms.cryptoKeyEncrypterDecrypter) ב-CMEK. אם לסוכן השירות של Compute Engine אין את ההרשאות הנדרשות כדי לגשת למפתחות, המכונות הווירטואליות הבסיסיות של Compute Engine מושבתות באופן אוטומטי. מידע נוסף זמין במאמר הצפנת משאבים של תחנות עבודה באמצעות CMEK.