הגדרת התראות Pub/Sub

התראות Pub/Sub מאפשרות לעקוב אחרי שינויים במאגרי Docker ב-Artifact Registry, כולל תרשימי Helm 3 שנארזו בפורמט OCI. אתם יכולים לרשום אפליקציות להתראות האלה כדי להפעיל אירועים אוטומטיים, לתעד את הפעילות במאגר או לתקשר בין שירותים כשמעלים, מתייגים או מוחקים תמונות.

סקירה כללית

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

‫Artifact Registry מפרסם הודעות בנושא שנקרא gcr לגבי השינויים הבאים:

  • תמונות שהועלו
  • תגים חדשים שנוספו לתמונות
  • מחיקת תמונה

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

כדי לקבל התראות, צריך:

  1. יוצרים נושא בשם gcr בפרויקט עם Artifact Registry.
  2. יוצרים מינוי לנושא.
  3. מגדירים את אפליקציית המנוי לקבלת הודעות על שינויים במאגר.
  4. אם צריך, מגדירים הרשאות כדי לשלוט בגישה לנושא ולמינוי.

יצירת הנושא של Artifact Registry

כדי ליצור את הנושא gcr עם מפתחות הצפנה שמבוססים על Google Cloud :

המסוף

  1. נכנסים לדף Pub/Sub topics במסוף Cloud de Confiance .

    כניסה לדף Pub/Sub topics

  2. לוחצים על Create Topic.

  3. מזינים את מזהה הנושא gcr.

  4. לוחצים על Create Topic.

gcloud

מריצים את הפקודה הבאה:

    gcloud pubsub topics create gcr --project=PROJECT-ID

מחליפים את PROJECT-ID במזהה הפרויקט ב- Cloud de Confiance by S3NS. אם משמיטים את הדגל --project, הפקודה משתמשת בפרויקט הנוכחי.

מידע נוסף על הפקודה gcloud pubsub topics זמין במסמכי התיעוד של topics.

כדי ליצור את הנושא gcr עם הצפנת CMEK, קראו את ההוראות להצפנת נושאים ב-Pub/Sub.

אחרי שיוצרים את הנושא gcr או מוודאים שהוא קיים, אפשר ליצור מינוי לנושא.

יצירת מינוי

אחרי שיצרתם נושא לשינויים במאגר, אתם יכולים להגדיר מינוי לנושא הזה באמצעות מסירת דחיפה או מסירת משיכה. מומלץ להשתמש במסירה במשיכה, כי מערכות CI/CD יכולות ליצור שינויים רבים בקובצי ה-Artifact המאוחסנים, והמסירה במשיכה יעילה יותר לנפח גדול של הודעות.

כדי ליצור מינוי עם מסירה במשיכה:

המסוף

  1. נכנסים לדף Pub/Sub topics במסוף Cloud de Confiance .

    כניסה לדף Pub/Sub topics

  2. לוחצים על הנושא של הפרויקט.

  3. לוחצים על Create Subscription.

  4. מזינים שם למינוי:

    projects/PROJECT/subscriptions/[SUBSCRIPTION-NAME]
    

    משאירים את Delivery Type (סוג המסירה) מוגדר כ-Pull (משיכה).

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

gcloud

מריצים את הפקודה הבאה:

gcloud pubsub subscriptions create SUBSCRIPTION-NAME --topic=gcr

מחליפים את SUBSCRIPTION-NAME בשם למינוי.

מידע נוסף על הפקודה gcloud pubsub subscriptions זמין במסמכי התיעוד של subscriptions.

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

הגדרת אפליקציית המנוי

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

כשמשתמש במאגר מעלה או מוחק קובץ אימג', מתרחשים השלבים הבאים:

  1. חשבון השירות של Artifact Registry מפרסם את השינוי בנושא gcr. חשבון השירות הוא service-PROJECT-NUMBER@gcp-sa-artifactregistry.s3ns-system.iam.gserviceaccount.com, כאשר PROJECT-NUMBER הוא מספר הפרויקט ב- Cloud de Confiance . כברירת מחדל, לחשבון השירות של Artifact Registry יש את ההרשאה pubsub.topics.publish כדי שהוא יוכל לפרסם שינויים בנושא.

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

  2. ‫Pub/Sub מעביר את ההודעה מהנושא למינוי שלכם.

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

    לזהות שמושכת הודעות בשם המנוי צריכות להיות הרשאות גישה למינוי. כדי לתת את ההרשאה הזו, אפשר להשתמש בתפקיד המנוי ב-Pub/Sub.

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

הגדרת ההרשאות

אתם יכולים להשתמש בהרשאות Pub/Sub כדי לקבוע את הגישה לנושאים ולמינויים.

למידע נוסף על הרשאות Pub/Sub ומתן גישה לנושאים ולמינויים, קראו את המסמכים בנושא בקרת גישה ב-Pub/Sub.

דוגמאות להתראות

ההתראות ב-Pub/Sub נשלחות כמחרוזות בפורמט JSON. בדוגמאות הבאות מוסבר מה קורה כשמקבלים התראות של Artifact Registry מ-Pub/Sub.

כשמעבירים קובץ אימג' ל-Artifact Registry, המידע של ההתראה עשוי להיראות כך:

{
  "action":"INSERT",
  "digest":"u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/hello-world@sha256:6ec128e26cd5..."
}

כשמתווסף תג תמונה חדש ל-Artifact Registry, המטען הייעודי (payload) של ההתראה נראה כך:

{
  "action":"INSERT",
  "digest":"u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/hello-world@sha256:6ec128e26cd5...",
  "tag":"u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/hello-world:1.1"
}

ההודעה מזהה את התמונה הרלוונטית באמצעות מפתח digest או tag.

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

{
  "action":"DELETE",
  "tag":"u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/hello-world:1.1"
}

ההודעה יכולה להכיל את הערכים DELETE או INSERT במפתח action.

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