טריגר Solace

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

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

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

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

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

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

הוספת הטריגר של Solace

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

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

    מעבר אל Application Integration

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

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

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

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

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

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

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

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

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

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

מידע על הגדרת טריגר Solace באמצעות חיבור Solace חדש זמין במאמר הגדרת טריגר Solace באמצעות חיבור חדש

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

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

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

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

הגדרת טריגר Solace באמצעות חיבור חדש

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

  1. לוחצים על הרכיב Solace trigger (טריגר של Solace) בכלי לעריכת שילובים כדי לפתוח את חלונית הגדרת הטריגר.
  2. לוחצים על Configure trigger (הגדרת הטריגר).
  3. מדלגים על השדה אזור.
  4. לוחצים על Connection (חיבור) ובוחרים באפשרות Create Connection (יצירת חיבור) מהתפריט הנפתח.
  5. מבצעים את השלבים הבאים בחלונית Create Connection (יצירת חיבור):
    1. בשלב מיקום, בוחרים את המיקום של חיבור Solace החדש:
      1. אזור: בוחרים מיקום מהרשימה הנפתחת.

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

      2. לוחצים על הבא.
    2. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
      1. מחבר: בוחרים באפשרות Solace מהרשימה הנפתחת של המחברים הזמינים.
      2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
      3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

        השמות של החיבורים צריכים לעמוד בקריטריונים הבאים:

        • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
        • האותיות צריכות להיות קטנות.
        • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
        • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
        • במחברים שתומכים בהרשמה לאירועים, שמות החיבורים לא יכולים להתחיל בקידומת goog.
      4. אופציונלי: מזינים תיאור למופע החיבור.
      5. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
      6. כדי להשתמש בחיבור למינויים לאירועים, בוחרים באפשרות הפעלת מינוי לאירועים. בחירה באפשרות הזו מפעילה את המינוי לאירוע עם פעולות.
      7. ‫Message VPN: רשת ה-VPN של הודעות בנתב ההודעות Solace Pub/Sub+ שאליו רוצים להתחבר. החיבור ספציפי ל-Message VPN. אם יש לכם הרבה רשתות VPN להעברת הודעות, אתם צריכים ליצור חיבור נפרד לכל רשת VPN להעברת הודעות.
      8. שם תור ברירת המחדל: השם של תור ברירת המחדל, יכול להיות שיוחלף כשמבצעים פעולה.
      9. שם ברירת המחדל של הנושא: שם הנושא שאליו רוצים להתחבר.
      10. (אופציונלי) כדי להשתמש ב-SSL, בוחרים באפשרות הפעלת SSL ומציינים את פרטי ההגדרה של SSL.
        1. בוחרים סוג של מאגר אישורים. אפשר לציין גלוי לכולם, פרטי או חיבור לא מאובטח.
        2. בוחרים את האישורים בהתאם לבחירה שלכם במאגר האישורים. לדוגמה, אם בוחרים באפשרות פרטי, צריך לציין מאגר אישורים מותאם אישית.
        3. אם אתם משתמשים ב-mTLS, בוחרים את האישורים של מאגר המפתחות בקטע Key Store.
        4. אופציונלי: בוחרים את גרסת ה-TLS.
        5. מזינים את סט האלגוריתמים להצפנה הנתמך. מזינים כמה חבילות הצפנה, כערכים מופרדים בפסיקים. מידע נוסף זמין במאמר בנושא חבילות הצפנה נתמכות.
      11. (אופציונלי) מגדירים את ההגדרות של צומת החיבור.
        • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
        • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

        צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר עסקאות עבור חיבור מסוים, צריך יותר צמתים, ולהפך: כדי לעבד פחות עסקאות, צריך פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.
      12. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
      13. לוחצים על הבא.
    3. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
      1. סוג היעד: בוחרים סוג יעד.
        • כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
        • כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.

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

      2. לוחצים על הבא.
    4. בקטע אימות, מזינים את פרטי האימות.
      1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

        החיבור ל-Solace תומך בסוגי האימות הבאים:

        • אנונימי
        • שם משתמש וסיסמה

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

      2. לוחצים על הבא.
    5. בקטע פרטי המינוי לאירוע, מגדירים את הפרטים שקשורים לאירוע.
      • מזינים את ההגדרה של תור ההודעות המתות. אם מגדירים תיבת דואר להודעות שלא נמסרו, החיבור כותב את האירועים שלא עברו עיבוד אל נושא Pub/Sub שצוין. ממלאים את הפרטים הבאים:
        1. מזהה פרויקט של הודעות שלא ניתן למסור: מזהה הפרויקט ב-Google Cloud שבו הגדרתם את נושא ה-Pub/Sub של הודעות שלא ניתן למסור.
        2. נושא להודעות ללא מוצא: נושא Pub/Sub שבו רוצים לכתוב את הפרטים של האירוע שלא עבר עיבוד.
    6. בדיקה: בודקים את פרטי החיבור והאימות.
    7. לוחצים על יצירה.

    פלט של טריגר

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

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

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

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

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

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

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

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

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

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

      כניסה לדף Connections

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

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

    עריכת טריגר Solace

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

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

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

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

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

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

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