העברת תמונות קונטיינרים של App Engine אל Artifact Registry

מזהה אזור

‫REGION_ID הוא קוד מקוצר ש-Google מקצה על סמך האזור שבוחרים כשיוצרים את האפליקציה. הקוד לא תואם למדינה או למחוז, למרות שחלק ממזהי האזורים עשויים להיראות דומים לקודים נפוצים של מדינות ומחוזות. באפליקציות שנוצרו אחרי פברואר 2020, המחרוזת REGION_ID.r כלולה בכתובות ה-URL של App Engine. באפליקציות קיימות שנוצרו לפני התאריך הזה, מזהה האזור הוא אופציונלי בכתובת ה-URL.

מידע נוסף על מזהי אזורים

השירות Container Registry הוצא משימוש והושבת ב-18 במרץ 2025. מומלץ להשתמש ב-Artifact Registry לאחסון ולניהול של תמונות קונטיינרים. כברירת מחדל, פריסות חדשות שנוצרו אחרי 5 במרץ 2025 משתמשות ב-Artifact Registry במקום ב-Container Registry לאחסון תמונות של אפליקציות. ב-Artifact Registry יש את אותן תכונות לניהול קונטיינרים כמו ב-Container Registry, והוא כולל תכונות והטבות נוספות. ‫Artifact Registry הוא שירות מנוהל במלואו שתומך גם בקובצי אימג' של קונטיינרים וגם בארטיפקטים שאינם קונטיינרים, ולכן הוא מרחיב את היכולות של Container Registry.

בפרויקטים שנוצרו לפני מאי 2024 או שעדיין לא הופעל בהם כלי ההעברה האוטומטי, צריך לפעול לפי השלבים במדריך הזה כדי להפעיל את App Engine כך שיעביר אוטומטית את תהליכי הפריסה.

סביבה רגילה של App Engine

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

  • בפריסות רגילות קיימות, לחשבון השירות שמבצע את הפריסה (חשבון השירות שמוגדר כברירת מחדל ב-App Engine (PROJECT_ID@appspot.gserviceaccount.com) או חשבון השירות המותאם אישית) צריך להיות תפקיד שמעניק את הרשאת הכתיבה המפורשת artifactregistry.repositories.uploadArtifacts ב-Artifact Registry. במאמר ניהול הגישה לחשבונות שירות מוסבר איך לראות את התפקידים שמשויכים לחשבון השירות שמשמש לפריסה.

  • פריסות חדשות יכולות להשתמש ב-Artifact Registry אם אחד מהתפקידים הבאים מופיע בחשבון השירות שמשויך לפריסות:

    אם אף אחד מהתפקידים האלה לא מופיע, צריך להקצות לחשבון השירות שמשמש לפריסה את התפקיד 'כותב ב-Artifact Registry' (roles/artifactregistry.writer).

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

במהלך העברות אוטומטיות, Google Cloud יכול ליצור מאגרים חדשים ולהעתיק תמונות מ-Container Registry אל Artifact Registry.

סביבה גמישה של App Engine

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

  • כדי שפריסות גמישות קיימות יפעלו כמצופה עם Artifact Registry, לחשבון השירות שמשמש לפריסה (חשבון השירות שמוגדר כברירת מחדל ב-App Engine (PROJECT_ID@appspot.gserviceaccount.com) או חשבון השירות בהתאמה אישית) צריך להיות תפקיד שמעניק הרשאות מפורשות ל-Artifact Registry, כמו artifactregistry.repositories.downloadArtifacts לקריאה ו-artifactregistry.repositories.uploadArtifacts לכתיבה. במאמר ניהול הגישה לחשבונות שירות מוסבר איך לראות את התפקידים שמשויכים לחשבון השירות שמשמש לפריסה.

  • אם אחד מהתפקידים הבאים מופיע בחשבון השירות שמשויך לפריסות, אפשר להשתמש ב-Artifact Registry לפריסות חדשות:

    אם אף אחד מהתפקידים האלה לא מופיע, צריך להעניק את התפקיד Artifact Registry Repository Administrator (roles/artifactregistry.repoAdmin) לחשבון השירות שמשמש לפריסה.

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

במהלך העברות אוטומטיות, Google Cloud יכול ליצור מאגרים חדשים ולהעתיק תמונות מ-Container Registry אל Artifact Registry.

מעבר ל-Artifact Registry עבור קובצי אימג' של קונטיינרים שנבנו באופן ידני

תהליך ההעברה האוטומטי לא רלוונטי אם פרסתם בעבר את האפליקציות באמצעות תמונות קונטיינר מוכנות מראש או תמונות קונטיינר שבניתם באופן ידני מ-Container Registry. לדוגמה, תהליך ההעברה האוטומטי לא פועל אם יצרתם קובצי אימג' של קונטיינרים באמצעות Docker, העברתם את קובצי האימג' האלה אל Container Registry ופרסתם את האפליקציות באמצעות הפקודה gcloud app deploy --image-url.

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

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

  • מעבירים ידנית את קובצי האימג' של הקונטיינרים מ-Container Registry אל Artifact Registry ומבצעים פריסה מחדש של גרסאות חדשות של השירות. מידע נוסף זמין במאמר בנושא העברה ידנית למאגרי gcr.io ב-Artifact Registry.

  • משתמשים בדגל copy-only כדי להעתיק את קובצי האימג' של הקונטיינר אל Artifact Registry ולפרוס מחדש גרסאות חדשות של השירות.