הורדת קבצים

בדף הזה מוסבר איך להוריד קבצים בודדים ממאגרי standard וממאגרי remote של Artifact Registry. המאגר יכול להיות בכל פורמט של ארטיפקט.

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

קבצים שאפשר להוריד

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

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

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

• (אופציונלי) הגדרת ברירות מחדל לפקודות של ה-CLI של gcloud.

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

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

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

רשימת קבצים

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

console

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

   פתיחת הדף Repositories

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

3. לוחצים על שם החבילה.

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

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

gcloud

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

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

gcloud artifacts files list

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

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

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

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

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

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

מחליפים את הערכים הבאים:

• ‫LOCATION: המיקום האזורי או הרב-אזורי של המאגר.
• ‫PROJECT: Google Cloud מזהה הפרויקט. אם מזהה הפרויקט מכיל נקודתיים (:), כדאי לעיין במאמר בנושא פרויקטים בהיקף הדומיין.
• ‫REPOSITORY: השם של המאגר שבו התמונה מאוחסנת.
• ‫PACKAGE: שם החבילה.
• ‫VERSION: הגרסה של החבילה.

במאגרי Docker, אפשר להוסיף את הדגל --tag לפקודה כדי להציג רשימה של קבצים לתג ספציפי של קובץ אימג' של קונטיינר.

מידע נוסף זמין במאמר בנושא רשימת קבצים של gcloud artifacts.

הורדת קבצים

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

gcloud

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

• ‫PROJECT: מזהה הפרויקט ב- Google Cloud. אם מזהה הפרויקט מכיל נקודתיים (:), אפשר לעיין במאמר בנושא פרויקטים בהיקף הדומיין.
• ‫LOCATION: המיקום האזורי או הרב-אזורי של המאגר.
• ‫REPOSITORY: השם של המאגר שבו מאוחסן הארטיפקט.
• ‫DESTINATION: הנתיב לתיקיית היעד במערכת הקבצים המקומית. תיקיית היעד צריכה להתקיים כבר, אחרת הפקודה תיכשל.
• ‫FILE: שם הקובץ המלא. כדי למצוא את הערך הזה, מריצים את הפקודה gcloud artifacts files list ומעתיקים את הערך של FILE.

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

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud artifacts files download \
    --project=PROJECT \
    --location=LOCATION \
    --repository=REPOSITORY \
    --destination=DESTINATION \
    FILE

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud artifacts files download `
    --project=PROJECT `
    --location=LOCATION `
    --repository=REPOSITORY `
    --destination=DESTINATION `
    FILE

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud artifacts files download ^
    --project=PROJECT ^
    --location=LOCATION ^
    --repository=REPOSITORY ^
    --destination=DESTINATION ^
    FILE

ההורדה אמורה להתחיל באופן מיידי.

API

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

• ‫PROJECT: מזהה הפרויקט ב- Google Cloud. אם מזהה הפרויקט מכיל נקודתיים (:), אפשר לעיין במאמר בנושא פרויקטים בהיקף הדומיין.
• ‫LOCATION: המיקום האזורי או הרב-אזורי של המאגר.
• ‫REPOSITORY: השם של המאגר שבו מאוחסן הארטיפקט.
• ‫DESTINATION: הנתיב לתיקיית היעד במערכת הקבצים המקומית. תיקיית היעד צריכה להתקיים כבר, אחרת הפקודה תיכשל.
• ‫FILE: שם הקובץ בקידוד כתובת ה-URL. כדי למצוא את הערך הזה, מריצים את הפקודה gcloud artifacts files list ומעתיקים את הערך של FILE. צריך להמיר אותו לפורמט של קידוד כתובות URL עבור הפקודה הזו – לדוגמה, path/to/file.jar צריך להיות מוזן כ-path%2Fto%2Ffile.jar.

ה-method של ה-HTTP וכתובת ה-URL:

GET https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media

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

‏Curl (Linux,‏ macOS או Cloud Shell)

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     --output DESTINATION \
     "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"

‎PowerShell (Windows)

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -OutFile DESTINATION `
    -Uri "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"

ההורדה אמורה להתחיל באופן מיידי.

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

• הצגה ורישום של מאגרי מידע
• Label repositories
• מאגרי תגים
• מחיקת מאגרי מידע