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

תצוגה מקדימה

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

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

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

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

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

   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 ‏(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 אחרי שם החבילה.

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

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

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

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

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

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

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