תהליכי עבודה עם תוויות

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

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

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

מהן תוויות?

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

תוויות ותגים

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

הוספה או עדכון של תוויות

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

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

סינון תהליכי עבודה לפי תווית

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

המסוף

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

    כניסה לדף Workflows

  2. בשדה Filter, בוחרים באפשרות Labels כקריטריון הסינון, וברשימה Values בוחרים צמד מפתח/ערך.

gcloud

משתמשים בדגל --filter עם הפקודה gcloud workflows list:

gcloud workflows list \
    --filter labels.KEY=VALUE

מחליפים את KEY ואת VALUE בצמד מפתח/ערך של תווית.

למידע נוסף על תחביר המסננים ב-Google Cloud CLI, אפשר לעיין במאמר gcloud topic filters.

התוויות של תהליך העבודה עוברות בירושה לביצועים של תהליך העבודה. כדי להציג תוויות של ביצועים, משתמשים בשיטה workflows.executions.list כדי לסנן ולרשום ביצועים של תהליכי עבודה.

מחיקת תוויות

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

המסוף

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

    כניסה לדף Workflows

  2. לוחצים על השם של תהליך העבודה שרוצים לעדכן.

    יופיע הדף פרטי תהליך העבודה.

  3. לוחצים על עריכה.

    מופיע הדף עריכת תהליך העבודה.

  4. לצד התווית שרוצים להסיר, לוחצים על מחיקת הפריט.

  5. לוחצים על הבא.

  6. כדי לפרוס מחדש את תהליך העבודה, לוחצים על פריסה.

gcloud

משתמשים בדגל --labels עם ערך ריק ובפקודה gcloud workflows deploy:

gcloud workflows deploy WORKFLOW_NAME \
    --labels="" \
    --source=YAML_OR_JSON_SOURCE_FILE

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

  • ‫WORKFLOW_NAME: השם של תהליך העבודה.

  • ‫YAML_OR_JSON_SOURCE_FILE: קובץ המקור של זרימת העבודה בפורמט YAML או JSON. לדוגמה: myFirstWorkflow.yaml.