סקירה כללית של מאגרי מחברים

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

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

פורמטים נתמכים של מחברים

‫Artifact Registry תומך רק במאגרי מחברים בפורמט Docker.

אימות במעלה הזרם

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

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

תרחישים לדוגמה ויתרונות

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

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

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

אם Artifact Registry נמצא ב-service perimeter של VPC Service Controls, כברירת מחדל, Artifact Registry דוחה גישה למקורות במעלה הזרם שנמצאים מחוץ ל-perimeter. אתם יכולים לאפשר למאגרי מחברים במיקום ספציפי לגשת למקורות חיצוניים שהוגדרו מחוץ לגבולות גזרה. הוראות מפורטות זמינות במאמר הגדרה של VPC Service Controls.

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

עדכונים במטא-נתונים ובאינדקסים של חבילות

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

פורמט סוג קובץ גיל העדכון שמוגדר כברירת מחדל
Docker רשימה/קבלת מטמון תגים שעה אחת

מאגרי upstream של מחבר Artifact Registry

אתם יכולים להשתמש ב-Docker Hub כמקור מאגר מחברים או להזין כתובת URL של מאגר מותאם אישית. בטבלה הבאה מוצגת רשימה חלקית של כמה מזהי URI נפוצים של Docker במעלה הזרם:

אופן הלימוד Upstream URI שם המרשם
Docker https://MY_ARTIFACTORY_INSTANCE.jfrog.io/OPTIONAL_REPO JFrog Artifactory
Docker https://ghcr.io GitHub Container Registry
Docker https://registry-1.docker.io Docker Hub
Docker https://public.ecr.aws הגלריה הציבורית של AWS ECR
Docker https://registry.k8s.io Kubernetes Container Registry
Docker https://MY_NEXUS_IP Nexus

מגבלות

בנוסף למכסות ולמגבלות של Artifact Registry, יש מגבלות נוספות על מאגרי מחברים:

  • צריכה להיות גישה למקורות במעלה הזרם דרך האינטרנט. מאגרי מחברים לא תומכים במקורות במקום או במקורות של רשת ענן וירטואלי פרטי (VPC) ללא כתובת IP ציבורית.

מצבים אחרים של מאגרים

אלה מצבי המאגר האחרים:

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

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