פתרון בעיות בקובצי אימג' של קונטיינרים

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

אי אפשר לשלוף תמונה או לפרוס אותה בסביבת זמן ריצה Google Cloud

כדאי לבדוק את הדברים הבאים:

  1. מוודאים שהנתיב המלא של התמונה שאתם דוחפים נכון. הנתיב חייב לכלול את שם המארח של המאגר, Google Cloud, מזהה הפרויקט, המאגר והתמונה. לדוגמה: 
    us-west1-docker.pkg.dev/my-project/my-repo/my-image:v1
     מידע נוסף זמין במאמר שמות של מאגרי תמונות ותמונות.
  2. מוודאים שלחשבון שממנו נמשכת התמונה יש את ההרשאות הנכונות לקריאה מהמאגר. אם השבתתם את ההקצאה האוטומטית של תפקידים לחשבונות שירות, אתם צריכים להקצות תפקידים ב-Artifact Registry לחשבונות השירות של זמן הריצה.
    • בחשבונות שירות של Compute Engine,‏ Cloud Run ו-Google Kubernetes Engine, צריך להעניק לחשבון השירות של זמן הריצה את התפקיד Artifact Registry Reader ‏(roles/artifactregistry.reader).
    • לחשבון השירות של Cloud Build, צריך להעניק את התפקיד Artifact Registry Writer ‏ (roles/artifactregistry.writer) לחשבון השירות שמריץ את הבנייה.
    • אם אתם משתמשים ב-Docker או בכלי אחר של צד שלישי, אתם צריכים:

אי אפשר לשלוח תמונה ל-Artifact Registry

נסו:

  1. מוודאים שהמאגר קיים. בניגוד ל-Container Registry, יצירת מאגר היא פעולה נפרדת מהעברת קובץ האימג' הראשון. אם המאגר לא קיים, צריך ליצור אותו.
  2. מוודאים שהנתיב המלא של התמונה שאתם דוחפים נכון. הנתיב חייב לכלול את שם המארח של המאגר, את Google Cloud מזהה הפרויקט, את המאגר ואת התמונה. לדוגמה: 
    us-west1-docker.pkg.dev/my-project/my-repo/my-image:v1

    כל מאגר Artifact Registry הוא משאב נפרד, ולכן אי אפשר לשלוח תמונה לנתיב בלי מאגר. לדוגמה, us-west1-docker.pkg.dev/my-project/my-image:v1 הוא נתיב תמונה לא תקין.

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

  3. מוודאים שלחשבון שממנו מתבצעת ההעלאה של האימג' יש הרשאות כתיבה למאגר. אם השבתתם את ההקצאה האוטומטית של תפקידים לחשבונות שירות, אתם צריכים להקצות תפקידים ב-Artifact Registry לחשבונות השירות של זמן הריצה.
    • בחשבונות שירות של Compute Engine,‏ Cloud Run ו-Google Kubernetes Engine, צריך להעניק לחשבון השירות של זמן הריצה את התפקיד Artifact Registry Writer ‏(roles/artifactregistry.writer).
    • לחשבון השירות של Cloud Build, צריך להעניק את התפקיד Artifact Registry Writer ‏ (roles/artifactregistry.writer) לחשבון השירות שמריץ את הבנייה.
  4. אם Artifact Registry החזיר את ההודעה The repository has enabled tag immutability, המשמעות היא שהמאפיין tag immutability מוגדר למאגר. אי אפשר לשלוח תמונה עם תג שכבר נמצא בשימוש בגרסה אחרת של אותה תמונה במאגר. נסו לשלוח את התמונה שוב עם תג שלא נמצא בשימוש בגרסאות אחרות של התמונה שמאוחסנות.

    כדי לוודא שהמאגר מוגדר לתגי תמונה בלתי ניתנים לשינוי, בודקים את העמודה Immutable image tags (תגי תמונה בלתי ניתנים לשינוי) ברשימת המאגרים ב- Google Cloud console או מריצים את הפקודה הבאה:

    gcloud artifacts repositories describe REPOSITORY \
      --project=PROJECT-ID \
      --location=LOCATION

הודעות ImagePullBackOff ו-ErrImagePull

ההודעות עם ImagePullBackOff ו-ErrImagePull מציינות ש-GKE לא יכול לשלוף תמונה מהמאגר.