ניהול חבילות Conda

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

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

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

1. מתקינים ומפעילים את Google Cloud CLI.

   כדי להריץ פקודות למאגרי Conda, צריך להשתמש בגרסה 354.0.0 של Google Cloud CLI או בגרסה חדשה יותר. אפשר לבדוק את הגרסה באמצעות הפקודה:

   gcloud version
   

2. כדי להשתמש ב-Conda CLI בסביבת Google Cloud , צריך להתקין אחד ממנהלי החבילות הבאים של Conda:

   • Conda
   • Mamba
   • Micromamba
   • Miniforge

3. אם אין לכם מאגר Conda ב-Artifact Registry, צריך ליצור מאגר חבילות Conda.

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

‫Artifact Registry תומך במאגרי Conda רגילים ומרוחקים. אפשר להשתמש בכל אחת מהכתובות הבאות למאגרי המידע המרוחקים.

• https://repo.anaconda.com/pkgs/main
• https://repo.anaconda.com/pkgs/r
• https://repo.anaconda.com/pkgs/msys2
• https://conda.anaconda.org/conda-forge
• https://conda.anaconda.org/bioconda

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

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

• כדי לצפות בחבילות או בקבצים בחבילות: קורא של Artifact Registry (roles/artifactregistry.reader)
• הורדה או התקנה של חבילות: קורא של Artifact Registry (roles/artifactregistry.reader)
• הוספת חבילות למאגר: Artifact Registry Writer (roles/artifactregistry.writer)
• מחיקת חבילות: אדמין של מאגר Artifact Registry (roles/artifactregistry.repoAdmin)

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

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

ניהול חבילות Conda

אחרי שמוסיפים חבילת Conda למאגר של Artifact Registry, אפשר להתקין את החבילה בסביבת Conda ולראות את הפרטים שלה באמצעות Google Cloud.

הוספת חבילות למאגר Artifact Registry

כדי להוסיף חבילת Conda למאגר Artifact Registry, מריצים את הפקודה הבאה:

gcloud artifacts files upload \
    --source=PACKAGE_NAME \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

כאשר:

• ‫REPO_NAME הוא המזהה של המאגר.
• ‫PROJECT הוא מזהה הפרויקט שמכיל את המאגר.
• ‫LOCATION הוא המיקום האזורי או המיקום במספר אזורים של המאגר.

כדי להוסיף כמה חבילות בבת אחת:

gcloud artifacts files upload \
    --source-directory=DIRECTORY \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

כאשר:

• ‫DIRECTORY היא הכתובת של תיקייה מקומית שמכילה את חבילות ה-Conda.

התקנת חבילות

מצבי מאגר: רגיל, מרוחק

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

Conda

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

Miniforge

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

Mamba

mamba install -n ENVIRONMENT_NAME PACKAGE_NAME

Micromamba

micromamba install -n ENVIRONMENT_NAME PACKAGE_NAME

כאשר:

• ‫ENVIRONMENT_NAME הוא השם של סביבת Conda. אם כבר הפעלתם סביבה ואתם מתקינים את החבילה ישירות בסביבה, אתם יכולים להשמיט את -n ENVIRONMENT_NAME.

• ‫PACKAGE_NAME הוא השם של חבילת Conda.

  כדי להתקין גרסה ספציפית של חבילה בסביבת Conda, צריך לכלול את VERSION אחרי שם החבילה.

במאגרי מידע רגילים, מורידים חבילה ישירות ממאגר המידע.

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

הצגת חבילות וגרסאות

מצבי מאגר: רגיל, מרוחק

כדי לראות את החבילות ואת גרסאות החבילות באמצעות Google Cloud המסוף או gcloud:

המסוף

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

   פתיחת הדף Repositories

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

   בדף Packages (חבילות) מופיעה רשימת החבילות במאגר.

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

gcloud

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

gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]

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

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

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

gcloud artifacts versions list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

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

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

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

רשימת קבצים

מצבי מאגר: רגיל, מרוחק

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

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

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

דוגמאות

כדאי לעיין בפרטי החבילה הבאים:

• פרויקט: my-project
• מאגר: my-repo
• מיקום המאגר: us-west1
• חבילה: my-app

הפקודה הבאה מציגה רשימה של כל הקבצים במאגר my-repo במיקום us-west1 בתוך פרויקט ברירת המחדל:

‫

gcloud artifacts files list \
    --location=us-west1 \
    --repository=my-repo

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

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --version=1.0

מחיקת חבילות וגרסאות

מצבי מאגר: רגיל, מרוחק

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

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

כדי למחוק חבילה:

המסוף

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

   פתיחת הדף Repositories

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

   בדף Packages (חבילות) מופיעה רשימת החבילות במאגר.

3. בוחרים את החבילה שרוצים למחוק.

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

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

gcloud

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

gcloud artifacts packages delete PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] [--async]

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

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

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

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

המסוף

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

   פתיחת הדף Repositories

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

   בדף Packages (חבילות) מופיעה רשימת החבילות במאגר.

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

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

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

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

gcloud

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

gcloud artifacts versions delete VERSION \
    --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] \
    [--async]

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

• ‫VERSION הוא שם הגרסה שרוצים למחוק.
• ‫PACKAGE הוא שם החבילה במאגר.
• ‫REPOSITORY הוא שם המאגר. אם הגדרתם מאגר ברירת מחדל, תוכלו להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
• ‫ LOCATION הוא המיקום האזורי או המיקום במספר אזורים של המאגר. ‫ אפשר להשתמש בדגל הזה כדי להציג מאגרי מידע במיקום ספציפי. אם הגדרתם מיקום ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.

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

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

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

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