אחסון פורמטים אחרים ב-Artifact Registry

אחסון פורמטים אחרים ב-Artifact Registry

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

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

נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

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

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

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

הפעלת Cloud Shell

במסוף Google Cloud , מפעילים את Cloud Shell.

הפעלת Cloud Shell

בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

במדריך למתחילים הזה תשתמשו ב-Cloud Shell כדי להריץ פקודות gcloud.

יצירת מאגר כללי

1. כדי ליצור מאגר בפורמט גנרי בשם quickstart-generic-repo במיקום us-central1 עם התיאור Generic repository, מריצים את הפקודה הבאה:

   gcloud artifacts repositories create quickstart-generic-repo \
       --repository-format=generic \
       --location=us-central1 \
       --description="Generic repository"
   

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

   gcloud artifacts repositories list
   

3. כדי לפשט את הפקודות של gcloud, מריצים את הפקודות הבאות כדי להגדיר את מאגר ברירת המחדל ל-quickstart-generic-repo ואת מיקום ברירת המחדל ל-us-central1.

   1. כדי להגדיר את מאגר ברירת המחדל ל-quickstart-generic-repo, מריצים את הפקודה הבאה:

      gcloud config set artifacts/repository quickstart-generic-repo
      

   2. כדי להגדיר את מיקום ברירת המחדל ל-us-central1, מריצים את הפקודה הבאה:

      gcloud config set artifacts/location us-central1
      

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

העלאת ארטיפקט למאגר

1. בספריית הבית, יוצרים קובץ להעלאה למאגר:

   echo "hello world" > hello.yaml
   

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

   gcloud artifacts generic upload \
       --source=hello.yaml \
       --package=my-package \
       --version=1.0.0
   

   כאשר:

   • ‫hello.yaml הוא הנתיב של הקובץ שרוצים להעלות.
   • ‫my-package היא החבילה שרוצים להעלות.
   • ‫1.0.0 היא הגרסה של פריט המידע שנוצר בתהליך הפיתוח (Artifact). אי אפשר להחליף גרסה קיימת במאגר.

הצגת ארטיפקטים במאגר

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

gcloud artifacts files list

התשובה כוללת את פרטי הקובץ בפורמט PACKAGE:VERSION:FILE_NAME.

בדוגמה הבאה, hello.yaml הוא FILE_NAME:

FILE: my-package:1.0.0:hello.yaml
CREATE_TIME: 2023-03-09T20:55:07
UPDATE_TIME: 2023-03-09T20:55:07
SIZE (MB): 0.000
OWNER: projects/my-project/locations/us-central1/repositories/quickstart-generic-repo/packages/my-package/versions/1.0.0

הורדת ארטיפקט גנרי

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

gcloud artifacts generic download \
    --name=hello.yaml \
    --package=my-package \
    --version=1.0.0 \
    --destination=DESTINATION

כאשר:

• ‫hello.yaml הוא שם הקובץ שרוצים להוריד.
• ‫my-package היא החבילה להורדה.
• ‫1.0.0 היא הגרסה של פריט המידע שנוצר בתהליך הפיתוח (Artifact).

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

הסרת המשאבים

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

מחיקת הפרויקט

זהירות: כשמוחקים פרויקט:

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

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

כדי למחוק Google Cloud פרויקט:

gcloud projects delete PROJECT_ID

מחיקת המאגר

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

1. כדי למחוק את מאגר quickstart-generic-repo, מריצים את הפקודה הבאה:

   gcloud artifacts repositories delete quickstart-generic-repo
   

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

   gcloud config unset artifacts/repository
   gcloud config unset artifacts/location
   

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

• מידע נוסף על ארטיפקטים גנריים