מתן תוויות למאגרי קוד

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

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

תוויות ותגים

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

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

אפשר להוסיף מאפיין אחד או יותר למאגר. אפשר גם לערוך את הערך של תווית קיימת.

כדי להוסיף תווית למאגר:

המסוף

  1. פותחים את הדף Repositories במסוף Google Cloud .

    פתיחת הדף Repositories

  2. בוחרים מאגר.

  3. אם חלונית המידע לצד רשימת המאגרים לא פתוחה, לוחצים על Show Info Panel.

  4. בחלונית המידע, לוחצים על הכרטיסייה תוויות.

  5. להוסיף או לערוך תוויות:

    1. כדי להוסיף תווית, לוחצים על הוספת תווית. מציינים את צמד המפתח והערך של התווית ולוחצים על שמירה.
    2. כדי לערוך תווית קיימת, משנים את הערך של התווית ולוחצים על שמירה.

gcloud

אפשר לציין תווית אחת או יותר שרוצים להוסיף או לערוך.

  • אם התווית קיימת, הערך המתאים מתעדכן.
  • אם התווית לא קיימת, היא נוצרת.
  • אם הפקודה כוללת גם את הדגל --clear-labels, כל התוויות הקיימות יוסרו לפני הוספת תוויות חדשות.

מריצים את הפקודה הבאה:

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --update-labels="KEY=VALUE,..."

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

  • ‫REPOSITORY הוא שם המאגר. אם הגדרתם מאגר ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
  • ‫PROJECT הוא מזהה הפרויקט. Google Cloud אם לא מציינים את הדגל הזה, המערכת משתמשת בפרויקט הנוכחי או בפרויקט ברירת המחדל.
  • ‫ LOCATION הוא המיקום האזורי או המיקום במספר אזורים של המאגר. ‫ אפשר להשמיט את הדגל ‎ `--location` ‎ כדי להשתמש בברירת המחדל.
  • ‫KEY=VALUE,... היא רשימה של תוויות שמופרדות בפסיקים ומצוינות כצמדי מפתח/ערך. לדוגמה: team=team-1,product=example_product,stage=development.

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

gcloud artifacts repositories update --help

סינון מאגרי מידע לפי תווית

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

המסוף

  1. פותחים את הדף Repositories במסוף Google Cloud .

    פתיחת הדף Repositories

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

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

    • מזינים את המפתח: env
    • מזינים את הערך: dev
    • מזינים את צמד המפתח/ערך: env:dev

gcloud

כדי לסנן לפי תוויות, משתמשים בדגל --filter עם הפקודה gcloud artifacts repositories list.

הערך של הדגל --filter חייב להיות בפורמט labels.KEY=VALUE. לדוגמה, אם רוצים לסנן מאגרי מידע בפרויקט הפעיל לפי תווית עם env כמפתח ו-dev כערך, אפשר להריץ את הפקודה הבאה:

gcloud artifacts repositories list --filter labels.env=dev

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

מחיקת תוויות

כדי למחוק תוויות:

המסוף

  1. פותחים את הדף Repositories במסוף Google Cloud .

    פתיחת הדף Repositories

  2. לוחצים על Select a repository (בחירת מאגר).

  3. אם חלונית המידע לצד רשימת המאגרים לא פתוחה, לוחצים על Show Info Panel.

  4. בחלונית המידע, לוחצים על הכרטיסייה תוויות.

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

gcloud

אתם יכולים למחוק תוויות ספציפיות או להסיר את כל התוויות ממאגר.

כדי להסיר תוויות ספציפיות, מריצים את הפקודה הבאה:

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --remove-labels="LABEL,..."

כדי להסיר את כל התוויות, מריצים את הפקודה הבאה:

gcloud artifacts repositories update REPOSITORY \
[--project=PROJECT] [--location=LOCATION] --clear-labels

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

  • ‫REPOSITORY הוא שם המאגר. אם הגדרתם מאגר ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
  • ‫PROJECT הוא מזהה הפרויקט. Google Cloud אם לא מציינים את הדגל הזה, המערכת משתמשת בפרויקט הנוכחי או בפרויקט ברירת המחדל.
  • ‫ LOCATION הוא המיקום האזורי או המיקום במספר אזורים של המאגר. ‫ אפשר להשתמש בדגל הזה כדי להציג מאגרי מידע במיקום ספציפי. אם הגדרתם מיקום ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
  • ‫LABEL,... היא רשימה של תוויות מופרדות בפסיקים, המפתחות מכל זוג KEY=VALUE. לדוגמה: team,product.

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

   gcloud artifacts repositories update --help