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

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

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

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

אופציונלי: הגדרת ברירות מחדל לפקודות 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, אפשר להשתמש בערך הגיבוב או בתג (tag) של קובצי אימג' של 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, אפשר להשתמש בדגל --oci-version-name ואחריו בשם הגרסה המלא של הקובץ המצורף או ב-URI של Artifact Registry, במקום לספק את ATTACHMENT. אפשר להשתמש בערך הגיבוב או בתג – לדוגמה, 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 שלהם. הכללים האלה חלים גם על מחיקה ידנית של ארטיפקטים וגם על מחיקות שנגרמות בגלל מדיניות ניקוי.

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