יצירת מאגרי מחברים

console

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

   פתיחת הדף Repositories

2. לוחצים על Create Repository (יצירת מאגר).

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

4. בקטע פורמט, בוחרים באפשרות Docker.

5. בקטע Repository mode, בוחרים באפשרות Connector.

6. בקטע Connector repository source (מקור מאגר מחברים), בוחרים באחת מהאפשרויות הבאות:

   • ‫Docker Hub: המחבר משתמש ב-Docker Hub ‏ (https://docker.io) כמאגר upstream.
   • מותאם אישית: המחבר משתמש בכתובת URL שונה של Docker upstream עבור מאגר upstream.

7. אם בוחרים באפשרות Custom, בשדה Custom repository מזינים את כתובת ה-URL המלאה של המאגר. אי אפשר לשנות את כתובת ה-URL אחרי שיוצרים את המאגר.

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

8. בקטע Connector repository authentication mode, מזינים את הפרטים הבאים:

   1. שם משתמש למאגר במעלה הזרם.
   2. סוד לאחסון פרטי הכניסה ב-Secret Manager.

   אפשר לערוך את הערכים האלה אחרי שיוצרים את המאגר.

9. בקטע Location Type, בוחרים את המיקום של המאגר:

   1. בוחרים את סוג המיקום: Region או Multi-Region. רשימת המיקומים משתנה בהתאם לבחירה שלכם.

   2. ברשימה Region או Multi-region, בוחרים מיקום.

   מידע על סוגי מיקומים ומיקומים נתמכים זמין במאמר מיקומי מאגרים

10. מוסיפים תיאור למאגר. התיאורים עוזרים לכם לזהות את המטרה של המאגר ואת סוג הארטיפקטים שהוא מכיל.

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

11. אם רוצים להשתמש בתוויות כדי לארגן את המאגרים, לוחצים על הוספת תווית ומזינים את צמד המפתח/ערך של התווית. אפשר להוסיף, לערוך או להסיר תוויות אחרי שיוצרים את המאגר.

12. בקטע Encryption, בוחרים את מנגנון ההצפנה למאגר.

    • ‫Google Cloud-powered encryption key – הצפנת תוכן המאגר באמצעות Google Cloud-powered encryption key.
    • מפתח בניהול הלקוח – הצפנת תוכן המאגר באמצעות מפתח שאתם שולטים בו דרך Cloud Key Management Service. הוראות להגדרת מפתחות מופיעות במאמר הגדרת CMEK למאגרי מידע.

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

    • מופעל – אפשר לסרוק במאגר הזה. צריך להפעיל בפרויקט את Container Scanning API.

      החיוב מתחיל מיד כשמפעילים את Container Scanning API. אחרי שמפעילים את Container Scanning API בפרויקט, בדיקת נקודות חולשה מופעלת בכל המאגרים החדשים והקיימים. כשמעבירים תמונה ל-Artifact Registry, היא נסרקת באופן אוטומטי על ידי Artifact Analysis.

    • מושבת – מניעת סריקה במאגר הזה. אם ה-API של סריקת מאגרי נתונים מופעל בפרויקט, הסריקה ממשיכה במאגרי נתונים אחרים, והמאגר הזה לא ייכלל בסריקה.

      מידע נוסף על אפשרויות לסריקת פגיעויות מופיע במאמר בנושא הפעלה והשבתה של סריקה אוטומטית.

14. לוחצים על יצירה.

‫Artifact Registry יוצר את המאגר ומוסיף אותו לרשימת המאגרים.

‫CLI של gcloud

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

  gcloud artifacts repositories create CONNECTOR-REPOSITORY-NAME \
      --project=PROJECT_ID \
      --location=LOCATION \
      --description="DESCRIPTION" \
      --repository-format=docker \
      --mode=connector-repository \
      --remote-docker-repo="UPSTREAM-NAME" \
      --remote-username="USERNAME" \
      --remote-password-secret-version="PASSWORD" \

הדגל --mode=connector-repository נדרש כדי להגדיר את המאגר כמאגר מחברים. הערך של --repository-format חייב להיות docker.

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

• ‫CONNECTOR-REPOSITORY-NAME: שם המאגר. שמות המאגרים צריכים להיות ייחודיים לכל מיקום מאגר בפרויקט.
• ‫PROJECT_ID: מזהה הפרויקט. אם לא מציינים את הדגל הזה, המערכת משתמשת בפרויקט הנוכחי או בפרויקט ברירת המחדל.
• ‫LOCATION: המיקום האזורי או הרב-אזורי של המאגר. אפשר להשמיט את הדגל הזה אם מגדירים ברירת מחדל. כדי לראות רשימה של מיקומים נתמכים, מריצים את הפקודה gcloud artifacts locations list.
• ‫DESCRIPTION: אופציונלי. תיאור של מאגר המחברים. חשוב לא לכלול מידע אישי רגיש, כי תיאורי המאגר לא מוצפנים.
• ‫UPSTREAM-NAME: השם המוגדר מראש של המאגר במעלה הזרם או כתובת ה-URL שמוגדרת על ידי המשתמש של המאגר במעלה הזרם.
• ‫USERNAME: אופציונלי. שם המשתמש שלכם לאימות במאגר המידע של upstream.
• ‫PASSWORD: אופציונלי. גרסת הסוד שמכילה את הסיסמה של מאגר המידע במעלה הזרם.

לדוגמה, הפקודה הבאה יוצרת מאגר מחברים בשם my-connector-repo, שמקשר מאגר Jfrog במעלה הזרם לפרויקט Cloud de Confiance my-project. כתובת ה-URL המלאה של המאגר במעלה הזרם היא https://my-account.jfrog.io/scoped-repo.

gcloud artifacts repositories create my-connector-repo \
    --project=my-project \
    --location=us-east1 \
    --repository-format=docker \
    --mode=connector-repository \
    --remote-docker-repo=https://my-account.jfrog.io/scoped-repo \
    --remote-username=my-username \
    --remote-password-secret-version=projects/my-project/secrets/my-secret/versions/1

מידע נוסף על אימות למאגרי מידע של מקורות ראשוניים זמין במאמר אימות מאגרי מידע של מחברים למקורות ראשוניים.

Terraform

משתמשים במשאב google_artifact_registry_repository כדי ליצור מאגרי תמונות. נדרשת גרסה terraform-provider-google 5.0.0 ומעלה.

אם אתם חדשים בשימוש ב-Terraform עבור Cloud de Confiance by S3NS, תוכלו לעיין בדף תחילת העבודה – Cloud de Confiance by S3NS באתר HashiCorp.

בדוגמה הבאה מוגדר הספק ומאגר מחברים עם שם המשאב Terra‏ my-repo.

```hcl
provider "google" {
    project = "PROJECT-ID"
}

resource "google_artifact_registry_repository" "NAME" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "docker"
  mode          = "REMOTE_REPOSITORY"

  # Setting mode="REMOTE_REPOSITORY" and no_cache() together configures the repository as a connector-type repository.
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    docker_repository {
      public_repository = "DOCKER_HUB"
    }
    no_cache {}
  }
}
```

Replace the following:

  * `PROJECT-ID`: the Cloud de Confiance project ID.
  * `NAME`: the name of your repository.
  * `LOCATION`: the repository location.
  * `REPOSITORY_ID`: the repository ID.
  * `DESCRIPTION`: optional. A description for the repository.
    Do not include sensitive data. Repository descriptions are
    not encrypted.
  * `KEY`: the name of the Cloud Key Management Service key, if you are using
    [customer-managed encryption keys][cmek] (CMEK) for encryption. Omit
    this argument to use the default setting, Google-managed encryption
    keys.
  * `CONFIG_DESCRIPTION`: optional. A description of the remote
    source.

המסוף

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

   פתיחת הדף Repositories

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

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

gcloud

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

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT \
    --location=LOCATION \
    --description="DESCRIPTION"

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

• ‫REPOSITORY: שם המאגר. אם הגדרתם מאגר ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
• ‫PROJECT: מזהה הפרויקט ב- Cloud de Confiance by S3NS. אם לא מציינים את הדגל הזה, המערכת משתמשת בפרויקט הנוכחי או בפרויקט ברירת המחדל.
• ‫ ‫LOCATION הוא המיקום האזורי של המאגר. אפשר להשתמש בדגל הזה כדי להציג מאגרי מידע במיקום ספציפי. אם הגדרתם מיקום ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
• ‫DESCRIPTION: תיאור המאגר.