ניהול מטא-נתונים של פריט מידע שנוצר בתהליך פיתוח (Artifact)

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

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

לפני שמתחילים

אופציונלי: הגדרת ברירות מחדל לפקודות Google Cloud CLI.

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

כדי לקבל את ההרשאות שדרושות לניהול קבצים מצורפים, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים במאגר:

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

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

הצגת רשימה של קבצים מצורפים

לכל ארטיפקט ב-Artifact Registry יכולים להיות כמה קבצים מצורפים שמתייחסים אליו. אפשר להציג את רשימת הקבצים המצורפים באמצעות מסוף Google Cloud , ה-CLI של gcloud או Oras (רק לתמונות קונטיינר בפורמט Docker).

המסוף

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

    פתיחת הדף Repositories

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

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

  4. לוחצים על גרסת התמונה המתאימה.

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

gcloud

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

  • ‫TARGET: שם הגרסה המלא. רק לגבי קובצי אימג' של Docker, אפשר גם להשתמש ב-URI של Artifact Registry של הארטיפקט שאליו מתייחס הקובץ המצורף. ב-URI, אפשר להשתמש בערך הגיבוב או בתג של קובץ האימג' של Docker. לדוגמה: us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1.

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

‫Linux,‏ macOS או Cloud Shell

gcloud artifacts attachments list \
    --target=TARGET

‏Windows (PowerShell)

gcloud artifacts attachments list `
    --target=TARGET

Windows‏ (cmd.exe)

gcloud artifacts attachments list ^
    --target=TARGET
 מידע נוסף זמין בפקודה gcloud artifacts attachments list.

‫Oras (Docker בלבד)

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

  • ‫IMAGE_URI: ה-URI של תמונת היעד שאליה מתייחסים קבצים מצורפים שמופיעים ברשימה.
oras discover --distribution-spec v1.1-referrers-api IMAGE_URI

בדוגמה הבאה מפורטים קבצים מצורפים לקובץ אימג' של קונטיינר, my-image, שמזוהה באמצעות ה-URI והתג שלה:

oras discover --distribution-spec v1.1-referrers-api \
us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1

כאשר:

  • ‫v1.1-referrers-api הוא ה-Referrer API שבו נעשה שימוש. מידע נוסף זמין במפרט ההפצה.

  • ‫us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1 הוא ה-URI שכולל את התג של גרסת קובץ האימג' בקונטיינר שרוצים להציג את הקבצים המצורפים שלו.

מדריך מלא ודוגמאות נוספות זמינים במאמרי העזרה בנושא oras discover.

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

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

  • ‫ATTACHMENT: השם המוגדר במלואו של הקובץ המצורף, למשל projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. אפשרות אחרת היא לציין רק את מזהה הקובץ המצורף ולהשתמש בדגלים --location ו---repository.

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

‫Linux,‏ macOS או Cloud Shell

gcloud artifacts attachments describe ATTACHMENT

‏Windows (PowerShell)

gcloud artifacts attachments describe ATTACHMENT

Windows‏ (cmd.exe)

gcloud artifacts attachments describe ATTACHMENT
 מידע נוסף זמין בפקודה gcloud artifacts attachments describe.

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

אפשר להוריד קבצים מצורפים באמצעות ה-CLI של gcloud או Oras (רק לתמונות קונטיינר בפורמט Docker).

gcloud

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

  • ‫ATTACHMENT: השם המוגדר במלואו של הקובץ המצורף, למשל projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. אפשרות אחרת היא לציין רק את מזהה הקובץ המצורף ולהשתמש בדגלים --location ו---repository.
  • ‫DESTINATION: הנתיב במערכת הקבצים המקומית שאליו רוצים להוריד את הקובץ המצורף.

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

‫Linux,‏ macOS או Cloud Shell

gcloud artifacts attachments download ATTACHMENT \
    --destination=DESTINATION

‏Windows (PowerShell)

gcloud artifacts attachments download ATTACHMENT `
    --destination=DESTINATION

Windows‏ (cmd.exe)

gcloud artifacts attachments download ATTACHMENT ^
    --destination=DESTINATION
 לגבי קבצים מצורפים במאגרי Docker, במקום לספק את ATTACHMENT, אפשר לספק את הדגל --oci-version-name ואחריו את שם הגרסה המלא של הקובץ המצורף או את ה-URI של Artifact Registry. אפשר להשתמש בערך ה-digest או בתג. לדוגמה, projects/my-project/locations/us-west1/repositories/my-repo/packages/my-package/versions/sha256:abc123.

מידע נוסף זמין בפקודה gcloud artifacts attachments download.

‫Oras (Docker בלבד)

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

  • ‫DESTINATION: ספריית היעד של הקובץ המצורף.

  • ‫ATTACHMENT_URI: ה-URI של הקובץ המצורף להורדה. זהו ה-URI של מאגר התמונות שאליו מתייחס הקובץ המצורף, ואחריו ה-SHA הייחודי של הקובץ המצורף.

oras pull -o DESTINATION ATTACHMENT_URI

בדוגמה הבאה מורידים קובץ מצורף שמזוהה על ידי ה-URI והתקציר שלו:

oras pull -o . us-west1-docker.pkg.dev/my-project/my-repo/my-image@sha256:xxxx

כאשר:

  • ‫-o . מציין את הספרייה הנוכחית כיעד ההורדה.

  • ‫us-west1-docker.pkg.dev/my-project/my-repo/my-image@sha256:xxxx הוא ה-URI של התמונה, כולל הגיבוב של הקובץ המצורף להורדה.

מדריך מלא ודוגמאות נוספות זמינים במאמרי העזרה בנושא oras pull.

מחיקת קבצים מצורפים

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

מחיקת קבצים מצורפים ישירות

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

מסוף (Docker בלבד)

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

    פתיחת הדף Repositories

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

  3. לוחצים על שם התמונה כדי לראות את הגרסאות שלה.

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

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

  6. לוחצים על התקציר של הקובץ המצורף שרוצים למחוק.

  7. לוחצים על מחיקה.

  8. בתיבת הדו-שיח לאישור, לוחצים על מחיקה.

gcloud

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

  • ‫ATTACHMENT: השם המוגדר במלואו של הקובץ המצורף, למשל projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. אפשרות אחרת היא לציין רק את מזהה הקובץ המצורף ולהשתמש בדגלים --location ו---repository.

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

‫Linux,‏ macOS או Cloud Shell

gcloud artifacts attachments delete ATTACHMENT

‏Windows (PowerShell)

gcloud artifacts attachments delete ATTACHMENT

Windows‏ (cmd.exe)

gcloud artifacts attachments delete ATTACHMENT
 מידע נוסף זמין בפקודה gcloud artifacts attachments delete.

מחיקת קבצים מצורפים באופן עקיף

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

המאמרים הבאים