טריגר של IBM MQ

הטריגר של IBM MQ הוא טריגר של אירוע ב-Connector שמאפשר להפעיל שילוב על סמך אירועים של IBM MQ שנרשמתם אליהם בחיבור שלכם ל-IBM MQ.

לפני שמתחילים

אם אתם מתכננים ליצור או להגדיר חיבור חדש לטריגר IBM MQ, ודאו שיש לכם את תפקיד ה-IAM הבא בפרויקט:

  • אדמין של מחבר (roles/connectors.admin)

    • מידע על הקצאת תפקידים מופיע במאמר ניהול הגישה.

מקצים לחשבון השירות שבו רוצים להשתמש עבור הטריגר של IBM MQ את תפקידי ה-IAM הבאים:

הוספת טריגר IBM MQ

כדי להוסיף טריגר IBM MQ לשילוב, מבצעים את השלבים הבאים:

  1. נכנסים לדף Application Integration במסוף Google Cloud .

    מעבר אל Application Integration

  2. בתפריט הניווט, לוחצים על Integrations (שילובים).

    מוצגת רשימה של כל השילובים שזמינים בפרויקט Google Cloud בדף Integrations List.

  3. בוחרים שילוב קיים או לוחצים על יצירת שילוב כדי ליצור שילוב חדש.

    אם יוצרים שילוב חדש:

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

    השילוב החדש שנוצר ייפתח בכלי השילובים.

  4. בסרגל הניווט של כלי העריכה של השילוב, לוחצים על טריגרים כדי לראות את רשימת הטריגרים הזמינים.
  5. לוחצים על הרכיב IBM MQ trigger (טריגר IBM MQ) וממקמים אותו בכלי לעריכת שילובים.

    6. כדי להגדיר את הטריגר IBM MQ, אפשר להשתמש בחיבור IBM MQ קיים שזמין ב-Integration Connectors, או ליצור חיבור IBM MQ חדש באמצעות האפשרות ליצירת חיבור מוטבע.

הגדרת טריגר של IBM MQ באמצעות חיבור קיים

אפשר להגדיר את הטריגר של IBM MQ באמצעות חיבור קיים של IBM MQ ב-Integration Connectors. שימו לב שהטריגר של IBM MQ הוא טריגר של אירוע מחבר, ולכן אפשר להשתמש בחיבור IBM MQ רק אם מופעלת הרשמה לאירועים כדי להגדיר את הטריגר.

במאמר הגדרת טריגר IBM MQ באמצעות חיבור חדש מוסבר איך להגדיר טריגר IBM MQ באמצעות חיבור חדש ל-IBM MQ.

כדי להגדיר טריגר של IBM MQ באמצעות חיבור קיים ל-IBM MQ, מבצעים את השלבים הבאים:

  1. לוחצים על הרכיב IBM MQ trigger (טריגר IBM MQ) בכלי לעריכת שילובים כדי לפתוח את חלונית הגדרת הטריגר.
  2. לוחצים על Configure trigger (הגדרת הטריגר).
  3. בדף Connector Event Trigger Editor (עורך טריגרים של אירועים של מחבר), מזינים את פרטי ההגדרה הבאים:
    1. אזור: בוחרים את האזור של חיבור IBM MQ.
    2. חיבור: בוחרים את החיבור ל-IBM MQ שרוצים להשתמש בו.

      ב-Application Integration מוצגים רק חיבורים פעילים ל-IBM MQ שמופעל בהם מינוי לאירועים.

    3. בוחרים באפשרות Queue או נושא בתור JMS Source Type.
      • אם בוחרים באפשרות Queue, צריך לספק את שם התור של IBM MQ בעמודה JMS Source Name (שם מקור JMS).
      • אם בוחרים באפשרות Topic, צריך לציין את שם הנושא של IBM MQ בעמודה JMS Source Name (שם מקור ה-JMS).
    4. חשבון שירות: בוחרים חשבון שירות עם תפקידי ה-IAM הנדרשים לטריגר של IBM MQ.
  4. לוחצים על סיום כדי להשלים את הגדרת הטריגר ולסגור את הדף.

הגדרת טריגר של IBM MQ באמצעות חיבור חדש

כדי להגדיר את הטריגר IBM MQ באמצעות חיבור חדש ל-IBM MQ, פועלים לפי השלבים הבאים:

  1. לוחצים על הרכיב IBM MQ trigger (טריגר IBM MQ) בכלי לעריכת שילובים כדי לפתוח את חלונית הגדרת הטריגר.
  2. לוחצים על Configure trigger (הגדרת הטריגר).
  3. מדלגים על השדה אזור.
  4. לוחצים על Connection (חיבור) ובוחרים באפשרות Create Connection (יצירת חיבור) מהתפריט הנפתח.
  5. מבצעים את השלבים הבאים בחלונית Create Connection (יצירת חיבור):
    1. בשלב מיקום, בוחרים את המיקום של חיבור IBM MQ החדש:
      1. אזור: בוחרים אזור מהרשימה הנפתחת.
      2. לוחצים על הבא.
    2. בשלב Connection Details (פרטי החיבור), מזינים את הפרטים של חיבור IBM MQ החדש:
      1. גרסת המחבר: בוחרים גרסה זמינה של מחבר IBM MQ מהרשימה הנפתחת.
      2. שם החיבור: מזינים שם לחיבור IBM MQ.
      3. (אופציונלי) תיאור: מזינים תיאור לקישור.
      4. (אופציונלי) הפעלת Cloud Logging: מסמנים את התיבה הזו כדי לאחסן את כל נתוני היומן של החיבור.
      5. חשבון שירות: בוחרים חשבון שירות עם תפקידי ה-IAM הנדרשים לחיבור IBM MQ.
      6. הפעלת מינוי לאירועים: בוחרים באפשרות הזו כדי להפעיל את המינוי לאירועים עבור החיבור ל-IBM MQ.
      7. (אופציונלי) מרחיבים את הגדרות מתקדמות כדי להגדיר את ההגדרות של צומת החיבור.

        מידע נוסף על הגדרות צומת החיבור ל-IBM MQ זמין במאמר בנושא חיבור ל-IBM MQ.

      8. (אופציונלי) לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
      9. לוחצים על הבא.
    3. אם רוצים להשתמש ב-SSL, בוחרים באפשרות הפעלת SSL. יוצגו פרטי ההגדרה של SSL.
      1. בוחרים סוג של מאגר אישורים. הוא יכול להיות גלוי לכולם, פרטי או חיבור לא מאובטח.
      2. בוחרים את האישורים שמוצגים על סמך הבחירה שלכם במאגר האישורים.
      3. אם אתם משתמשים ב-mTLS, בוחרים את האישורים של מאגר המפתחות בקטע Key Store.
      4. אופציונלי: בוחרים את גרסת ה-TLS.
      5. מזינים את סט האלגוריתמים להצפנה הנתמך. מזינים כמה חבילות הצפנה, כערכים מופרדים בפסיקים. מידע נוסף זמין במאמר בנושא חבילות הצפנה נתמכות.
    4. בשלב Destinations (יעדים), מזינים את פרטי מופע IBM MQ:
      1. סוג היעד: בוחרים באפשרות כתובת המארח.
      2. מארח: מזינים את שם המארח או את כתובת ה-IP של מופע IBM MQ.
      3. לוחצים על הבא.
    5. בשלב אימות, מזינים את פרטי האימות של מופע IBM MQ:
      1. בוחרים את סוג האימות הרצוי ומזינים את הפרטים הרלוונטיים כדי לגשת לכתובת ה-URL של המארח ב-IBM MQ.

        כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

      2. לוחצים על הבא.
    6. בדיקה: בודקים את פרטי החיבור ל-IBM MQ שסיפקתם.
    7. לוחצים על Create (יצירה) כדי לסיים את יצירת החיבור החדש ל-IBM MQ.
  6. לוחצים על סיום וסוגרים את הדף.

סטים נתמכים של אלגוריתמים להצפנה

גרסת TLS סטים נתמכים של אלגוריתמים להצפנה
1.2
  • TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
  • TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
  • TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
  • TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
  • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
  • TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
  • TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA
  • TLS_DHE_RSA_WITH_AES_256_CBC_SHA
  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
  • TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
‫1.3
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256
  • TLS_AES_128_GCM_SHA256

פלט של טריגר

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

הטריגר של IBM MQ מציין את הסטטוס של מינוי לאירוע באמצעות המצבים הבאים:

  • ‫Creating: מציין שהטריגר נרשם למינוי האירוע.
  • ‫Active: מציין שהטריגר נרשם בהצלחה למינוי לאירוע.
  • ‫Error: מציין שיש בעיה במינוי לאירועים שהוגדר.

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

בתמונה הבאה מוצגת דוגמה לפריסה של חלונית ההגדרות של טריגר IBM MQ:

תמונה שבה מוצגת חלונית ההגדרה של טריגר IBM MQ תמונה שמוצגת בה חלונית ההגדרה של טריגר IBM MQ

משתנה הפלט של הטריגר

לכל אירוע, הטריגר של IBM MQ יוצר משתנה פלט ConnectorEventPayload (בפורמט JSON) שאפשר להשתמש בו במשימות הבאות. הפלט של המשתנה יכלול את המטען הייעודי (payload) מהאירוע של IBM MQ. לדוגמה: 

{
"message": "Hello world",
"messageContentType": "Text"
}

הצגת מינויים לאירועים

כדי לראות ולנהל את כל המינויים לאירועים שמשויכים לחיבור ב-Integration Connectors, פועלים לפי השלבים הבאים:

  1. עוברים לדף Integration Connectors > Connections.

    כניסה לדף Connections

  2. לוחצים על החיבור שרוצים לראות את המינויים שלו.
  3. לוחצים על הכרטיסייה מינויים לאירועים.

    כאן מוצגים כל המינויים לאירועים של החיבור.

עריכה של טריגר IBM MQ

אפשר לערוך טריגר של IBM MQ כדי לשנות או לעדכן את הגדרות החיבור ואת פרטי המינוי לאירועים.

כדי לערוך טריגר של IBM MQ:

  1. לוחצים על הרכיב IBM MQ trigger (טריגר IBM MQ) בכלי לעריכת שילובים כדי לפתוח את חלונית הגדרת הטריגר.
  2. לוחצים על Configure IBM MQ trigger (הגדרת טריגר של IBM MQ).
  3. בדף Connector Event Trigger Editor (עורך טריגרים של אירועים במחבר), מבצעים את הפעולות הבאות:
    1. כדי לשמור את המינוי הקודם לאירועים, לוחצים על שמירה. אחרת, לוחצים על מחיקה.
    2. מעדכנים את הגדרות החיבור ואת פרטי המינוי לאירועים לפי הצורך.
    3. לוחצים על סיום.

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

מכסות ומגבלות

מידע על מכסות ומגבלות זמין במאמר מכסות ומגבלות.

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