הגדרה של מדיניות ניקוי

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

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות להחלה או להסרה של מדיניות ניקוי, בקשו מהאדמין להקצות לכם את התפקיד אדמין של Artifact Registry (roles/artifactregistry.admin) ב-IAM בפרויקט של המאגר. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

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

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

  • artifactregistry.repositories.update
  • כדי למחוק פריטי מידע שנוצר שעומדים בקריטריונים של מדיניות הניקוי: artifactregistry.versions.delete

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

תפקיד ברירת המחדל של סוכן השירות של Artifact Registry כולל את ההרשאה artifactregistry.versions.delete, שנדרשת כדי למחוק קובצי אימג' שעומדים בקריטריונים של מדיניות הניקוי.

יצירת קובץ מדיניות

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

יצירת מדיניות מחיקה

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

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

console

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

כדי להוסיף מדיניות מחיקה למאגר קיים:

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

    פתיחת הדף Repositories

  2. ברשימת המאגרים, בוחרים את המאגר ולוחצים על Edit Repository.

  3. בקטע Cleanup policies, בוחרים באפשרות Dry run כדי לבדוק את המדיניות החדשה לפני שמוחקים פריטי מידע שנוצרו בתהליך פיתוח התוכנה. למידע נוסף על הצגת תוצאות הבדיקה, ראו הרצה ללא שמירת נתונים.

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

  4. לוחצים על Add a cleanup policy ומוסיפים את הפרטים הבאים:

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

      • Any tag state: המערכת מתעלמת ממצב התג ומחילה את המדיניות גם על פריטי מידע שנוצרו בתהליך הפיתוח עם תגים וגם על פריטי מידע שנוצרו בתהליך הפיתוח בלי תגים.
      • מתויג: חל רק על פריטי מידע שנוצרו בעזרת AI ומתויגים.
      • Untagged: חל רק על פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) ללא תיוג.

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

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

  5. אפשר להגדיר את המדיניות בנושא מחיקת נתונים בדרכים הבאות:

    • ‫Tag prefixes: רשימה מופרדת בפסיקים של תחיליות של תגים. לדוגמה, התחיליות test ו-staging יתאימו לתמונות עם התגים testenv ו-staging-1.5. כדי להשתמש בתחיליות של תגים, צריך להגדיר את tagState ל-TAGGED.
    • ‫Version prefixes: רשימה מופרדת בפסיקים של קידומות של גרסאות פריטים. לדוגמה, v1, v2 יתאימו לגרסאות v1.5, v2.0alpha ו-v10.2.
    • קידומות של חבילות: רשימה של קידומות לשמות של פריטי מידע שנוצרו בתהליך פיתוח התוכנה. כדי להזין כמה קידומות, לוחצים על Enter או על , בין הקידומות. לדוגמה, red, blue ייצור שתי קידומות, red ו-blue, ויתאים לשמות פריטי המידע שנוצרו red-team,‏ redis ו-bluebird.
    • ‫Older than: הזמן המינימלי שחלף מאז שנוצרה גרסת פריט המידע במאגר, שצוין כמשך זמן. לדוגמה, 30d הוא 30 ימים. אפשר לציין משך זמן בשניות, דקות, שעות או ימים על ידי הוספת s, m, h או d, בהתאמה.
    • ‫Newer than: הזמן המקסימלי שחלף מאז שנוצרה גרסת פריט המידע במאגר, שצוין כמשך זמן. לדוגמה, 30d הוא 30 ימים.
  6. כדי להוסיף עוד כללי מדיניות ניקוי, לוחצים על הוספת מדיניות ניקוי.

  7. לוחצים על עדכון.

    מדיניות הניקוי מופעלת על המאגר. כדי לראות את כללי מדיניות הניקוי, לוחצים על Show more בקטע Repository details.

JSON

{
  "name": "DELETE_POLICY_NAME",
  "action": {"type": "Delete"},
  "condition": {
    "tagState": "TAG_STATUS",
    "tagPrefixes": ["TAG_PREFIXES"],
    "versionNamePrefixes": ["VERSION_PREFIXES"],
    "packageNamePrefixes": ["PACKAGE_PREFIXES"],
    "olderThan": "OLDER_THAN_DURATION",
    "newerThan": "NEWER_THAN_DURATION"
  }
}

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

name
בקטע הקוד למחיקת המדיניות, DELETE_POLICY_NAME הוא שם המדיניות. השם חייב להיות ייחודי בקבוצת כללי המדיניות שאתם מחילים על מאגר.
action
עבור המדיניות בנושא מחיקת נתונים הערך הוא {"type": "Delete"}.
condition
מציינים לפחות אחד מהתנאים הבאים:
  • ‫tagState: TAG_STATUS מציין אם המדיניות צריכה לבדוק פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) עם תגים או בלי תגים. פריטי המידע מתויגים כששולחים או מושכים קובץ אימג' למאגר או ממנו. הערכים הנתמכים הם:

    • ‫tagged: חל רק על פריטי מידע שנוצר בתהליך הפיתוח (Artifact) מתויגים.
    • ‫untagged: חל רק על פריטי מידע שנוצרו בעקבות תהליך פיתוח התוכנה (Artifact) ללא תגים.
    • ‫any: המערכת מתעלמת ממצב התג ומחילה את המדיניות גם על פריטי מידע שנוצרו בעקבות ניתוח (Artifact) מתויגים וגם על כאלה שלא מתויגים.

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

    למידע נוסף על תגי Docker, קראו את המאמר מושגים של קונטיינרים.

  • ‫tagPrefixes: TAG_PREFIXES היא רשימה מופרדת בפסיקים של קידומות תגים. לדוגמה, "test", "staging" יתאים לתמונות עם התגים "testenv" ו-"staging-1.5". כדי להשתמש בתחיליות של תגים, צריך להגדיר את tagState ל-TAGGED.

  • ‫versionNamePrefixes: VERSION_PREFIXES היא רשימה מופרדת בפסיקים של קידומות של גרסאות פריטים. לדוגמה, "v1", "v2" תואם לגרסאות "v1.5",‏ "v2.0alpha" ו-"v10.2".

  • ‫packageNamePrefixes: PACKAGE_PREFIXES היא רשימה מופרדת בפסיקים של קידומות של שמות פריטי מידע שנוצרו בתהליך הפיתוח (Artifact). לדוגמה, "red", "blue" יתאים לשמות פריטי המידע שנוצר "red-team",‏ "redis" ו-"bluebird".

  • ‫olderThan: הערך OLDER_THAN_DURATION הוא משך הזמן המינימלי שחלף מאז שנוצרה גרסת פריט המידע במאגר. לדוגמה, 30d הוא 30 ימים. אפשר לציין משך זמן בשניות, דקות, שעות או ימים על ידי הוספת s, m, h או d, בהתאמה.

  • ‫newerThan: הערך NEWER_THAN_DURATION הוא משך הזמן המקסימלי מאז שנוצרה גרסת פריט המידע במאגר. לדוגמה, 30d הוא 30 ימים.

‫Artifact Registry מבצע הרצות ללא שינוי והרצות פעילות של כללי מדיניות הניקוי באמצעות משימה ברקע שפועלת מדי פעם. השינויים נכנסים לתוקף תוך יום בערך.

יצירת מדיניות שמירה מותנית

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

console

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

כדי להוסיף מדיניות שמירה למאגר קיים:

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

    פתיחת הדף Repositories

  2. ברשימת המאגרים, בוחרים את המאגר ולוחצים על Edit Repository.

  3. בקטע Cleanup policies, בוחרים באפשרות Dry run כדי לבדוק את המדיניות החדשה לפני שמוחקים פריטי מידע שנוצרו בתהליך פיתוח התוכנה. כדי לראות את התוצאות של מדיניות השמירה, צריך להגדיר לפחות המדיניות בנושא מחיקת נתונים אחת. למידע נוסף על הצגת תוצאות הבדיקה, ראו הרצה (dry run).

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

  4. לוחצים על Add a cleanup policy ומוסיפים את הפרטים הבאים:

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

      • Any tag state: המערכת מתעלמת ממצב התג ומחילה את המדיניות גם על פריטי מידע שנוצרו בתהליך הפיתוח עם תגים וגם על פריטי מידע שנוצרו בתהליך הפיתוח בלי תגים.
      • מתויג: חל רק על פריטי מידע שנוצרו בעזרת AI ומתויגים.
      • Untagged: חל רק על פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) ללא תיוג.

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

  5. אפשר להגדיר את מדיניות השמירה בדרכים הבאות:

    • ‫Tag prefixes: רשימה מופרדת בפסיקים של תחיליות של תגים. לדוגמה, התחיליות test ו-staging יתאימו לתמונות עם התגים testenv ו-staging-1.5. כדי להשתמש בתחיליות של תגים, צריך להגדיר את tagState ל-TAGGED.
    • ‫Version prefixes: רשימה מופרדת בפסיקים של קידומות של גרסאות פריטים. לדוגמה, v1, v2 יתאימו לגרסאות v1.5, v2.0alpha ו-v10.2.
    • קידומות של חבילות: רשימה מופרדת בפסיקים של קידומות של שמות פריטי מידע שנוצרו בתהליך הפיתוח. לדוגמה, red, blue יתאים לשמות פריטי המידע שנוצר red-team, redis ו-bluebird.
    • ‫Older than: הזמן המינימלי שחלף מאז שנוצרה גרסת פריט המידע במאגר, שצוין כמשך זמן. לדוגמה, 30d הוא 30 ימים. אפשר לציין משך זמן בשניות, דקות, שעות או ימים על ידי הוספת s, m, h או d, בהתאמה.
    • ‫Newer than: הזמן המקסימלי שחלף מאז שנוצרה גרסת פריט המידע במאגר, שצוין כמשך זמן. לדוגמה, 30d הוא 30 ימים.
  6. כדי להוסיף עוד כללי מדיניות ניקוי, לוחצים על הוספת מדיניות ניקוי.

  7. לוחצים על עדכון.

    מדיניות הניקוי מופעלת על המאגר.

JSON

הפורמט דומה להמדיניות בנושא מחיקת נתונים. במדיניות שמירה, הערך של action הוא {"type": "Keep"}.

{
  "name": "KEEP_POLICY_NAME",
  "action": {"type": "Keep"},
  "condition": {
    "tagState": "TAG_STATUS",
    "tagPrefixes": ["TAG_PREFIXES"],
    "versionNamePrefixes": ["VERSION_PREFIXES"],
    "packageNamePrefixes": ["PACKAGE_PREFIXES"],
    "olderThan": "OLDER_THAN_DURATION",
    "newerThan": "NEWER_THAN_DURATION"
  }
}

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

  • ‫KEEP_POLICY_NAME עם שם למדיניות הניקוי. השם צריך להיות ייחודי בקבוצת כללי המדיניות שאתם מחילים על מאגר.
  • ‫TAG_STATUS עם מצב התג, שמציין אם המדיניות צריכה לבדוק פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) מתויגים או לא מתויגים. פריטי המידע מתויגים כשדוחפים או מושכים קובץ אימג' למאגר או ממנו. למידע נוסף על תגי Docker, קראו את המאמר מושגים של קונטיינרים.

    האפשרויות הן:

    • ‫tagged: חל רק על פריטי מידע שנוצר בתהליך הפיתוח (Artifact) מתויגים.
    • ‫untagged: חל רק על פריטי מידע שנוצרו בעקבות תהליך פיתוח התוכנה (Artifact) ללא תגים.
    • ‫any: חלה על כל הגרסאות

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

  • ‫TAG_PREFIXES ברשימה מופרדת בפסיקים של קידומות של תגים. לדוגמה, התחיליות test ו-staging יתאימו לתמונות עם התגים testenv ו-staging-1.5. כדי להשתמש בתחיליות של תגים, צריך להגדיר את tagState ל-TAGGED.

  • ‫VERSION_PREFIXES ברשימה מופרדת בפסיקים של קידומות של גרסאות פריטים. לדוגמה, v1, v2 יתאים לגרסאות v1.5, v2.0alpha ו-v10.2.

  • ‫PACKAGE_PREFIXES ברשימה מופרדת בפסיקים של תחיליות של שמות פריטי מידע שנוצרו בתהליך הפיתוח (Artifacts). לדוגמה, red, blue יתאים לשמות פריטי המידע שנוצר red-team, redis ו-bluebird.

  • ‫OLDER_THAN_DURATION עם משך הזמן המינימלי מאז שנוצרה גרסת פריט המידע במאגר, שצוין כמשך זמן. לדוגמה, 30d הוא 30 ימים. אפשר לציין משך זמן בשניות, דקות, שעות או ימים על ידי הוספת s, m, h או d, בהתאמה.
  • ‫NEWER_THAN_DURATION עם משך הזמן המקסימלי שחלף מאז שנוצרה גרסת פריט המידע במאגר. לדוגמה, 30d הוא 30 ימים.

‫Artifact Registry מבצע הרצות ללא שינוי והרצות פעילות של כללי מדיניות הניקוי באמצעות משימה ברקע שפועלת מדי פעם. השינויים נכנסים לתוקף תוך יום בערך.

יצירת מדיניות שמירה לגרסאות האחרונות

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

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

console

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

כדי להוסיף מדיניות של שמירת הגרסאות האחרונות למאגר קיים:

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

    פתיחת הדף Repositories

  2. ברשימת המאגרים, בוחרים את המאגר ולוחצים על Edit Repository.

  3. בקטע Cleanup policies, בוחרים באפשרות Dry run כדי לבדוק את המדיניות החדשה לפני שמוחקים פריטי מידע שנוצרו בתהליך פיתוח התוכנה. כדי לראות את התוצאות של מדיניות השמירה, צריך להגדיר לפחות המדיניות בנושא מחיקת נתונים אחת. למידע נוסף על הצגת תוצאות הבדיקה, ראו הרצה (dry run).

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

  4. לוחצים על Add a cleanup policy ומוסיפים את הפרטים הבאים:

    • Name: נותנים שם למדיניות הניקוי. השם צריך להיות ייחודי בקבוצת כללי המדיניות שאתם מחילים על מאגר.
    • סוג המדיניות: בוחרים באפשרות שמירת הגרסאות העדכניות ביותר.
  5. בשדה Keep count, מזינים את מספר הגרסאות של פריט המידע שרוצים לשמור במאגר.

  6. אופציונלי: בוחרים באפשרות Package prefixes כדי לציין את הקידומות של החבילות שעליהן רוצים להחיל את מדיניות השמירה. לדוגמה, red, blue יתאים לשמות פריטי המידע שנוצר red-team, redis ו-bluebird.

  7. כדי להוסיף עוד כללי מדיניות ניקוי, לוחצים על הוספת מדיניות ניקוי.

  8. לוחצים על עדכון.

    מדיניות הניקוי מופעלת על המאגר. כדי לראות את כללי מדיניות הניקוי, לוחצים על Show more בקטע Repository details.

JSON

הפורמט דומה להמדיניות בנושא מחיקת נתונים. במדיניות שמירה, הערך של action הוא {"type": "Keep"}.

במדיניות שמירה של מספר ספציפי של גרסאות יש קטע mostRecentVersions במקום קטע condition.

{
  "name": "KEEP_POLICY_NAME",
  "action": {"type": "Keep"},
  "mostRecentVersions": {
    "packageNamePrefixes": ["PACKAGE_PREFIXES"],
    "keepCount": MINIMUM_NUMBER
  }
}

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

  • KEEP_POLICY_NAME בשם של מדיניות השמירה. השם צריך להיות ייחודי בקבוצת כללי המדיניות שאתם מחילים על מאגר.
  • ‫PACKAGE_PREFIXES עם הקידומות האופציונליות של החבילות שעליהן רוצים להחיל את מדיניות השמירה. לדוגמה, red, blue יתאים לשמות פריטי המידע שנוצר red-team,‏ redis ו-bluebird.
  • ‫MINIMUM_NUMBER במספר הגרסאות של פריט המידע שרוצים לשמור במאגר.

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

‫Artifact Registry מבצע הרצות ללא שינוי והרצות פעילות של כללי מדיניות הניקוי באמצעות משימה ברקע שפועלת מדי פעם. השינויים נכנסים לתוקף תוך יום בערך.

קובץ מדיניות לדוגמה

בדוגמה הבאה של קובץ מדיניות יש המדיניות בנושא מחיקת נתונים אחת ושתי כללי מדיניות שמירה.

  • המדיניות delete-prerelease מסירה גרסאות של פריטי מידע שנוצרו בתהליך הפיתוח 30 ימים אחרי ההעלאה, אם פריט המידע מתחיל במחרוזת alpha או v0.
  • המדיניות keep-tagged-release שומרת פריטי מידע שמתויגים בקידומת release, ששם הקובץ שלהם מתחיל ב-webapp או ב-mobile.
  • המדיניות keep-minimum-versions שומרת את חמש הגרסאות האחרונות של פריטי המידע ששם הקובץ שלהם מתחיל ב-webapp, ב-mobile או ב-sandbox.
[
  {
    "name": "delete-prerelease",
    "action": {"type": "Delete"},
    "condition": {
      "tagState": "tagged",
      "tagPrefixes": ["alpha", "v0"],
      "olderThan": "30d"
    }
  },
  {
    "name": "keep-tagged-release",
    "action": {"type": "Keep"},
    "condition": {
      "tagState": "tagged",
      "tagPrefixes": ["release"],
      "packageNamePrefixes": ["webapp", "mobile"]
    }
  },
  {
    "name": "keep-minimum-versions",
    "action": {"type": "Keep"},
    "mostRecentVersions": {
      "packageNamePrefixes": ["webapp", "mobile", "sandbox"],
      "keepCount": 5
    }
  }
]

בדיקת כללי המדיניות באמצעות הרצת בדיקה

כדי לבדוק את מדיניות הניקוי, אתם יכולים להגדיר את מדיניות הניקוי להרצה יבשה במסוף, או להריץ את הפקודה gcloud artifacts set-cleanup-policies עם הדגל --dry-run.

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

console

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

    פתיחת הדף Repositories

  2. ברשימת המאגרים, בוחרים את המאגר ולוחצים על Edit Repository.

  3. בקטע Cleanup policies, בוחרים באפשרות הרצת בדיקה.

  4. לוחצים על Add a cleanup policy ומגדירים את האפשרויות למדיניות Conditional delete,‏ Conditional keep או Keep most recent versions.

  5. לוחצים על עדכון.

כשמדיניות מחיקה גורמת לפעולת BatchDeleteVersions, הפרמטר validateOnly מקבל את הערך "true".

‫Artifact Registry מבצע הרצות ללא שינוי והרצות פעילות של כללי מדיניות הניקוי באמצעות משימה ברקע שפועלת מדי פעם. השינויים נכנסים לתוקף תוך יום בערך.

צריך להמתין לפחות יום אחד לפני ששולחים שאילתות ליומני הביקורת של ההרצה היבשה.

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

gcloud logging read 'protoPayload.serviceName="artifactregistry.googleapis.com" AND protoPayload.request.parent="projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY/packages/-" AND protoPayload.request.validateOnly=true' \
    --resource-names="projects/PROJECT_ID" \
    --project=PROJECT_ID

הפלט אמור להיראות כך:

insertId: qwe123ty3
logName: projects/my-project/logs/cloudaudit.googleapis.com%2Fdata_access
operation:
  first: true
  id: projects/my-project/locations/us-west1/operations/12345abc-fb9b-4b6f-b02c-9a397ee807d4
  producer: artifactregistry.googleapis.com
protoPayload:
  '@type': type.googleapis.com/google.cloud.audit.AuditLog
  authenticationInfo:
    principalEmail: service-774919394028@gcp-sa-staging-artreg.iam.gserviceaccount.com
  authorizationInfo:
  - granted: true
    permission: artifactregistry.versions.delete
    resource: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
    resourceAttributes: {}
  methodName: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
  request:
    '@type': type.googleapis.com/google.devtools.artifactregistry.v1.BatchDeleteVersionsRequest
    names:
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:4bb3756e4e75dfbc3ced87521ed62b26d16fb4e17993ae6877165f2b6551fb55
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:e8185538b50df953529b300be4963b2c21158808becac7aa0d610f61de8ba701
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:7f7fb0a9453da49f831fe92eb8b1751be13acefe1bbd44cc3f0d63d41c422246
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:84ac871a34560b39dd7bde57b4d333f18a7e8c1b61c8d350c1fefeb1fcd2b3ac
parent: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
    validateOnly: true
  requestMetadata:
    callerIp: private
    callerSuppliedUserAgent: stubby_client
    destinationAttributes: {}
    requestAttributes:
      auth: {}
      time: '2023-05-26T04:31:21.909465579Z'
  resourceName: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
  serviceName: artifactregistry.googleapis.com
receiveTimestamp: '2023-05-26T04:31:22.641338594Z'
resource:
  labels:
    method: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
    project_id: my-project
    service: artifactregistry.googleapis.com
  type: audited_resource
severity: INFO
timestamp: '2023-05-26T04:31:21.909004200Z'

gcloud

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

gcloud artifacts repositories set-cleanup-policies REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --policy=POLICY_FILE \
    --dry-run

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

  • ‫REPOSITORY בשם המאגר.
  • ‫PROJECT_ID במזהה הפרויקט ב- Google Cloud .
  • ‫ LOCATION הוא המיקום של המאגר, באזור אחד או במספר אזורים. ‫

כשמדיניות מחיקה גורמת לפעולת BatchDeleteVersions, הפרמטר validateOnly מקבל את הערך "true".

‫Artifact Registry מבצע הרצות ללא שינוי והרצות פעילות של כללי מדיניות הניקוי באמצעות משימה ברקע שפועלת מדי פעם. השינויים נכנסים לתוקף תוך יום בערך.

צריך להמתין לפחות יום אחד לפני ששולחים שאילתות ליומני הביקורת של ההרצה היבשה.

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

gcloud logging read 'protoPayload.serviceName="artifactregistry.googleapis.com" AND protoPayload.request.parent="projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY/packages/-" AND protoPayload.request.validateOnly=true' \
    --resource-names="projects/PROJECT_ID" \
    --project=PROJECT_ID

הפלט אמור להיראות כך:

insertId: qwe123ty3
logName: projects/my-project/logs/cloudaudit.googleapis.com%2Fdata_access
operation:
  first: true
  id: projects/my-project/locations/us-west1/operations/12345abc-fb9b-4b6f-b02c-9a397ee807d4
  producer: artifactregistry.googleapis.com
protoPayload:
  '@type': type.googleapis.com/google.cloud.audit.AuditLog
  authenticationInfo:
    principalEmail: service-774919394028@gcp-sa-staging-artreg.iam.gserviceaccount.com
  authorizationInfo:
  - granted: true
    permission: artifactregistry.versions.delete
    resource: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
    resourceAttributes: {}
  methodName: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
  request:
    '@type': type.googleapis.com/google.devtools.artifactregistry.v1.BatchDeleteVersionsRequest
    names:
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:4bb3756e4e75dfbc3ced87521ed62b26d16fb4e17993ae6877165f2b6551fb55
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:e8185538b50df953529b300be4963b2c21158808becac7aa0d610f61de8ba701
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:7f7fb0a9453da49f831fe92eb8b1751be13acefe1bbd44cc3f0d63d41c422246
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:84ac871a34560b39dd7bde57b4d333f18a7e8c1b61c8d350c1fefeb1fcd2b3ac
parent: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
    validateOnly: true
  requestMetadata:
    callerIp: private
    callerSuppliedUserAgent: stubby_client
    destinationAttributes: {}
    requestAttributes:
      auth: {}
      time: '2023-05-26T04:31:21.909465579Z'
  resourceName: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
  serviceName: artifactregistry.googleapis.com
receiveTimestamp: '2023-05-26T04:31:22.641338594Z'
resource:
  labels:
    method: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
    project_id: my-project
    service: artifactregistry.googleapis.com
  type: audited_resource
severity: INFO
timestamp: '2023-05-26T04:31:21.909004200Z'

החלת כללי מדיניות על מאגר

כדי להשתמש בכללי מדיניות הניקוי שהגדרתם בקובץ JSON מקומי, אתם צריכים להחיל אותם על מאגרים שבהם אתם רוצים ש-Artifact Registry יטפל במחיקה אוטומטית של גרסאות פריטים באמצעות ה-CLI של gcloud.

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

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

  • פרויקט Google Cloud .

console

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

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

    פתיחת הדף Repositories

  2. ברשימת המאגרים, בוחרים את המאגר ולוחצים על Edit Repository.

  3. בקטע Cleanup policies, בוחרים באפשרות Delete artifacts.

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

gcloud

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

gcloud artifacts repositories set-cleanup-policies REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --policy=POLICY_FILE \
    --no-dry-run

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

  • ‫REPOSITORY בשם המאגר.
  • ‫PROJECT_ID במזהה הפרויקט ב- Google Cloud .
  • ‫ LOCATION הוא המיקום של המאגר, באזור אחד או במספר אזורים. ‫
  • ‫POLICY_FILE הוא שם הקובץ עם מדיניות הניקוי.

הדגל --no-dry-run משבית את הפונקציונליות של הרצת בדיקה במאגר.

לדוגמה, הפקודה הבאה מחילה את כללי המדיניות שבקובץ policy.json על המאגר my-repo באזור us-west1 בפרויקט my-project.

gcloud artifacts repositories set-cleanup-policies my-repo \
    --project=my-project \
    --location=us-west1 \
    --policy=policy.json

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

עדכון מדיניות

console

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

    פתיחת הדף Repositories

  2. ברשימת המאגרים, בוחרים את המאגר ולוחצים על Edit Repository.

  3. בקטע Cleanup policies, לוחצים על שם המדיניות שרוצים לשנות.

  4. עורכים את מדיניות הניקוי ולוחצים על Update.

    מדיניות הניקוי מופעלת על המאגר.

gcloud

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

gcloud artifacts repositories set-cleanup-policies REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --policy=POLICY_FILE \
    --no-dry-run

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

  • ‫REPOSITORY בשם המאגר.
  • ‫PROJECT_ID במזהה הפרויקט ב- Google Cloud .
  • ‫ LOCATION הוא המיקום של המאגר, באזור אחד או במספר אזורים. ‫
  • ‫POLICY_FILE הוא שם הקובץ עם מדיניות הניקוי.

הדגל --no-dry-run משבית את הפונקציונליות של הרצת בדיקה במאגר.

הצגת רשימה של כללי מדיניות לניקוי מאגרים

אתם יכולים לראות את כללי מדיניות הניקוי שמשויכים למאגר.

console

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

    פתיחת הדף Repositories

  2. ברשימת המאגרים, בוחרים את המאגר שרוצים לראות.

  3. בקטע Repository details, לוחצים על Show more.

    שמות כללי המדיניות לניקוי מוצגים.

  4. כדי לראות או לערוך את הפרטים של מדיניות הניקוי של המאגר, לוחצים על Edit Repository.

    הפרטים של מדיניות הניקוי הקיימת מופיעים בקטע Cleanup policies.

gcloud

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

gcloud artifacts repositories list-cleanup-policies REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION

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

  • ‫REPOSITORY בשם המאגר.
  • ‫PROJECT_ID במזהה הפרויקט ב- Google Cloud .
  • ‫ LOCATION הוא המיקום של המאגר, באזור אחד או במספר אזורים. ‫

הסרת מדיניות ממאגר

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

console

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

    פתיחת הדף Repositories

  2. ברשימת המאגרים, בוחרים את המאגר ולוחצים על Edit Repository.

  3. בקטע Cleanup policies, מעבירים את העכבר מעל שם המדיניות שרוצים למחוק.

  4. לוחצים על סמל המחיקה.

  5. לוחצים על עדכון.

    מדיניות הניקוי נמחקת.

gcloud

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

gcloud artifacts repositories delete-cleanup-policies REPOSITORY \
    --policynames=POLICY_NAMES \
    --project=PROJECT_ID \
    --location=LOCATION

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

  • ‫REPOSITORY הוא שם המאגר.
  • ‫PROJECT_ID הוא המזהה של הפרויקט ב- Google Cloud .
  • ‫ LOCATION הוא המיקום של המאגר, באזור אחד או במספר אזורים. ‫
  • ‫POLICY_NAMES היא רשימה מופרדת בפסיקים של שמות כללי המדיניות שרוצים להסיר.

לדוגמה, הפקודה הבאה מסירה מדיניות בשם delete-test מהמאגר my-repo באזור us-west1 בפרויקט my-project:

gcloud artifacts repositories delete-cleanup-policies my-repo \
    --policynames=delete-test \
    --project=my-project \
    --location=us-west1

רשומות ביומן הביקורת של כללי מדיניות הניקוי

כדי לראות את הרשומות ביומן של מדיניות הניקוי ב-Cloud Logging, צריך להפעיל את הרישום ביומן של DATA_WRITE.

כשמגדירים מדיניות ניקוי במאגר, הפעולה מתועדת ביומן כעדכון של המאגר (פעולת UpdateRepository).

כש-Artifact Registry מוחק גרסה של פריט מידע שנוצר, הוא מתעד את האירוע ביומני הגישה לנתונים של Cloud Logging. ברשומות ביומן אפשר לראות שחשבון השירות של Artifact Registry ביצע את המחיקה. מזהה חשבון השירות של Artifact Registry הוא בפורמט service-PROJECT-NUMBER@gcp-sa-artifactregistry.iam.gserviceaccount.com