הוספת תוויות למשאבים של Cloud Workstations

בדף הזה מוסבר איך להשתמש בתוויות במשאבי Cloud Workstations.

מהן תוויות?

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

הדרישות לגבי תוויות

התוויות שמוחלות על משאב צריכות לעמוד בדרישות הבאות:

  • אפשר להוסיף עד 64 תוויות לכל משאב.
  • כל תווית צריכה להיות צמד מפתח/ערך.
  • האורך המינימלי של המפתחות הוא תו אחד, והאורך המקסימלי הוא 63 תווים. המפתחות לא יכולים להיות ריקים. הערכים יכולים להיות ריקים, והאורך המקסימלי שלהם הוא 63 תווים.
  • המפתחות והערכים יכולים להכיל רק אותיות קטנות, ספרות, קווים תחתונים ומקפים. כל התווים צריכים להיות בקידוד UTF-8, ומותר להשתמש בתווים בינלאומיים. המפתחות צריכים להתחיל באות קטנה או בתו בינלאומי.
  • החלק של המפתח בתווית חייב להיות ייחודי בתוך משאב יחיד. עם זאת, אפשר להשתמש באותו מפתח עם כמה משאבים.

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

שימושים נפוצים בתוויות

ריכזנו כאן כמה תרחישי שימוש נפוצים בתוויות:

  • תוויות של צוותים או מרכזי עלות: אפשר להוסיף תוויות שמבוססות על צוות או על מרכז עלות כדי להבחין בין מקרים ששייכים לצוותים שונים (לדוגמה, team:research ו-team:analytics). אפשר להשתמש בסוג הזה של תוויות לניהול חשבונות או לתקצוב.

  • תוויות רכיבים: לדוגמה, component:redis,‏ component:frontend,‏ component:ingest ו-component:dashboard.

  • תוויות של סביבה או שלב: לדוגמה, environment:production ו-environment:test.

  • תוויות של מדינות: לדוגמה, state:active,‏ state:readytodelete ו-state:archive.

  • תוויות בעלות: משמשות לזיהוי הצוותים שאחראים על הפעולות, לדוגמה: team:shopping-cart.

‫+ תוויות של מכונות וירטואליות: אפשר לצרף תווית למכונה וירטואלית. תגים של מכונות וירטואליות שהגדרתם בעבר מופיעים כתווית ללא ערך.

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

תוויות ותגים

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

מידע נוסף על תוויות זמין במאמר ארגון משאבים באמצעות תוויות. Google Cloud

מידע נוסף על תיוג משאבים של Cloud Workstations זמין במאמר תיוג משאבים של Cloud Workstations.

תוויות משאבים ב-Cloud Workstations

‫Cloud Workstations מחיל אוטומטית את התוויות הבאות על כל המשאבים:

  • workstation_cluster_id
  • workstation_config_id
  • workstation_id
  • workstation_location
  • goog-drz-workstation-location
  • goog-drz-workstation-uuid
  • goog-workstations

תוויות מותאמות אישית של Cloud Workstations

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

משתמשים בשדה labels כשמפעילים את Cloud Workstations API.

לדוגמה, בקובץ config.json לדוגמה שמופיע בהמשך, webserver הוא מפתח ו-backend הוא הערך התואם. באופן דומה, media הוא מפתח ו-images הוא הערך התואם.

    {
      "idleTimeout": "7200s",
      "host": {
        "gce_instance": {
          "machine_type": "e2-standard-8",
          "pool_size": 1
        }
      },
      "persistentDirectories": [
        {
        "mountPath": "/home",
        "gcePd": {
          "sizeGb": 200,
          "fsType": "ext4"
        }
      }
      ],
      "labels": {
        "webserver": "backend",
        "media": "images"
      }
    }