הגדרת מאגר נתונים של Jira Cloud

בדף הזה מוסבר איך ליצור מאגר נתונים ולחבר את Jira Cloud ל-Gemini Enterprise.

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

לפני שמגדירים את החיבור המאוגד ל-Jira Cloud, צריך לוודא את הדברים הבאים:

יצירת מאגר נתונים ב-Jira Cloud

כדי ליצור מאגר נתונים של Jira Cloud:

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise.

    Gemini Enterprise

  2. בוחרים פרויקט ב- Google Cloud או יוצרים פרויקט חדש.

  3. בתפריט הניווט, לוחצים על מאגרי נתונים.

  4. ‫Create data store.

  5. בקטע Source, מחפשים את Jira Cloud ולוחצים על Select.

  6. בקטע נתונים:

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

    2. לוחצים על Continue.

    3. בקטע Authentication settings, מגדירים את האימות בהתאם למצב החיבור שנבחר.

      1. מזינים את פרטי האימות הבאים:

        • מזהה לקוח: המזהה של אפליקציית OAuth 2.0.
        • סוד לקוח: המפתח הסודי שמשויך לאפליקציית OAuth 2.0.
        • Instance URI: כתובת ה-URL הבסיסית של המכונה של Jira Cloud (לדוגמה, https://your-domain.atlassian.net).
        • מזהה המכונה: מזהה ייחודי של המכונה שלכם ב-Jira Cloud.

        מידע נוסף על קבלת פרטי הכניסה האלה זמין במאמר הגדרת Jira Cloud.

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

      3. לוחצים על Continue.

    4. בקטע יעדים, מזינים את כתובת ה-URL של נקודת הקצה של Jira Cloud.

    5. לוחצים על Continue.

    6. בקטע אפשרויות מתקדמות:

      • אופציונלי: כדי לאפשר קבוצה של כתובות IP סטטיות במערכת, מסמנים את התיבה הפעלת כתובות IP סטטיות. אחרי שיוצרים את מאגר הנתונים, צריך להציג את כתובות ה-IP הסטטיות הרשומות בדף הפרטים של מאגר הנתונים ולהוסיף אותן לכלל רשימת ההיתרים של כתובות ה-IP ב-Jira Cloud. מידע נוסף זמין במאמר הגדרת תעבורת נתונים יוצאת עם כתובת IP סטטית.
      • אם בחרתם באפשרות חיפוש מאוחד ויש לכם שדות בהתאמה אישית, אתם יכולים לבחור באפשרות הכללת שדות בהתאמה אישית כדי שיהיה אפשר לחפש בהם. שדות בהתאמה אישית ב-Jira הם שדות נתונים שמוגדרים על ידי המשתמשים ומאחסנים מידע מיוחד שלא זמין בשדות ברירת המחדל של המערכת.
      • אם בחרתם באפשרות הטמעת נתונים:
        1. אופציונלי: בשדה Max QPS, מזינים את המספר המקסימלי של שאילתות לשנייה כדי להחיל הגבלת קצב של יצירת בקשות על השאילתות שהמחבר שולח למכונה של Jira Cloud. אם לא מגדירים את המדיניות, ברירת המחדל היא 12.
        2. אם הגדרתם את User Identity Accessor for Jira Cloud:
          1. בשדה Jira Identity Sync Forge URL, מזינים את כתובת היעד של אפליקציית Forge שנוצרה בתוך המכונה.
          2. בשדה Jira Identity Sync Forge Client Secret (סוד הלקוח של Jira Identity Sync Forge), מזינים את מפתח ה-API או הטוקן שנוצרו בהגדרות של אפליקציית Jira. מידע נוסף על הגדרת User Identity Accessor ל-Jira Cloud זמין במאמר התקנת User Identity Accessor.

    7. בקטע ישויות לחיפוש (אם בחרתם באפשרות חיפוש מאוחד) או ישויות לסנכרון (אם בחרתם באפשרות הטמעת נתונים):

      1. בוחרים את כל הישויות הנדרשות.
      2. אם בחרתם באפשרות חיפוש מאוחד, המשיכו לשלב הבא.
      3. אם בחרתם באפשרות הטמעת נתונים, המשיכו לשלבים הבאים:
        1. אופציונלי: כדי לסנכרן פרויקטים ספציפיים, מבצעים את הפעולות הבאות:
          1. לוחצים על סינון.
          2. כדי לסנן ישויות מהאינדקס, בוחרים באפשרות החרגה מהאינדקס. כדי לוודא שהן נכללות באינדקס, בוחרים באפשרות הכללה באינדקס.
          3. מזינים את מפתח הפרויקט. מקישים על Enter אחרי כל מפתח פרויקט. מידע נוסף על קבלת מפתח הפרויקט זמין במאמר קבלת מפתח הפרויקט.
          4. מזינים את המפתחות. צריך ללחוץ על Enter אחרי כל מפתח.
          5. לוחצים על Save.
        2. כדי להגדיר את תזמון הסנכרון:
          1. ברשימה תדירות הסנכרון, בוחרים את תדירות הסנכרון.
            • כדי לתזמן סנכרונים מלאים נפרדים של נתוני ישויות וזהויות, מרחיבים את התפריט בקטע סנכרון מלא ובוחרים באפשרות אפשרויות בהתאמה אישית.
          2. ברשימה תדירות הסנכרון המצטבר, בוחרים את תדירות הסנכרון המצטבר. מידע נוסף זמין במאמר לוחות זמנים לסנכרון.

  7. לוחצים על Continue.

  8. בקטע פעולות:

    • אם בחרתם באפשרות חיפוש מאוחד, בקטע בחירת פעולות ב-Jira Cloud להפעלה, בוחרים את הפעולות שרוצים להפעיל במאגר הנתונים.

    • אם בחרתם באפשרות הטמעת נתונים:

      1. בקטע הגדרות אימות:

        1. מזינים את פרטי האימות הבאים:
          • מזהה לקוח: המזהה של אפליקציית OAuth 2.0.
          • סוד לקוח: המפתח הסודי שמשויך לאפליקציית OAuth 2.0.
          • Instance URI: כתובת ה-URL הבסיסית של המכונה של Jira Cloud (לדוגמה, https://your-domain.atlassian.net).
          • מזהה המכונה: מזהה ייחודי של המכונה שלכם ב-Jira Cloud.

        מידע נוסף על פרטי הכניסה זמין במאמר הגדרת Jira Cloud.

        1. לוחצים על Login (כניסה) ונכנסים ל-Jira Cloud כדי לאמת את החשבון.

      2. לוחצים על Continue.

      3. בקטע Select Jira Cloud actions to enable, בוחרים את הפעולות מהקטגוריה כדי להפעיל אותן במאגר הנתונים.

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

  9. לוחצים על Continue.

  10. בקטע Configuration (הגדרה):

    1. ברשימה Multi-region, בוחרים את המיקום של מחבר הנתונים.
    2. בשדה השם של מחבר הנתונים, נותנים שם למחבר.
    3. אם בחרתם באפשרות us או eu בתור המיקום, מגדירים את הגדרות ההצפנה:
      • אופציונלי: אם לא הגדרתם מפתחות לאזור יחיד, לחצו על מעבר לדף ההגדרות כדי לעשות זאת. מידע נוסף זמין במאמר רישום מפתח לאזור יחיד למחברים של צד שלישי.
      • בוחרים באפשרות מפתח הצפנה בניהולGoogle או מפתח Cloud KMS.
      • אם בחרתם באפשרות Cloud KMS key:
        • ברשימה Key management type, בוחרים את הסוג המתאים.
        • ברשימה Cloud KMS key, בוחרים את המפתח.
      מידע נוסף זמין במאמר מפתחות הצפנה בניהול הלקוח.

  11. לוחצים על Continue.

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

  13. לוחצים על יצירה. ‫Gemini Enterprise יוצר את מאגר הנתונים ומציג את מאגרי הנתונים בדף Data Stores.

בדף Data Stores, לוחצים על שם מאגר הנתונים כדי לראות את הסטטוס. אחרי שהסטטוס של מאגר הנתונים משתנה מ-Creating (בשלבי יצירה) ל-Active (פעיל), מאגר הנתונים של Jira Cloud מוכן לשימוש.

במאגר נתונים להטמעה שנוצר באמצעות Jira Cloud, המצב של מאגר הנתונים משתנה מבשלבי יצירה לפועל כשהסנכרון מתחיל. אחרי שההטמעה מסתיימת, הסטטוס משתנה ל-Active (פעיל), מה שמציין שמאגר הנתונים מוגדר באופן מלא. בהתאם לנפח הנתונים, יכול להיות שתהליך ההטמעה יימשך כמה שעות.

אחרי שיוצרים את מאגר הנתונים, יוצרים אפליקציה, מקשרים אותה למאגר הנתונים של Jira Cloud ונותנים ל-Gemini Enterprise הרשאה לגשת ל-Jira Cloud לפני שמריצים שאילתות.

הפעלת סנכרון בזמן אמת להטמעת נתונים

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

ישויות ב-Jira יצירה עדכון מחיקה שינויים בהרשאות
בעיות
יומני עבודה
פרויקטים
תגובות
קבצים מצורפים

כדי להפעיל סנכרון בזמן אמת במאגר נתונים של Jira Cloud, פועלים לפי השלבים הבאים:

יצירת webhook URL

  1. עוברים לדף Gemini Enterprise ובתפריט הניווט לוחצים על מאגרי נתונים.
  2. בוחרים מאגר נתונים של Jira Cloud.

  3. לוחצים על הצגה/עריכה בשורה סנכרון בזמן אמת.

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

    1. כדי להפעיל את הסנכרון בזמן אמת, לוחצים על המתג הפעלת סנכרון בזמן אמת.
    2. מזינים ערך בשדה Client secret ומעתיקים אותו. תצטרכו את הערך הזה שוב כשתצרו תגובה לפעולה מאתר אחר (webhook) במסוף הניהול של Jira.
    3. לוחצים על Save.

  5. אחרי שהסטטוס של סנכרון בזמן אמת משתנה ל-Running, לוחצים על הצגה/עריכה.

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

    1. מעתיקים את כתובת ה-URL של ה-webhook.
    2. לוחצים על Close.

יצירת תגובה לפעולה מאתר אחר (webhook)

  1. נכנסים למסוף הניהול של Jira.
  2. לוחצים על הגדרות ובוחרים באפשרות מערכת.
  3. בחלונית System settings, בוחרים באפשרות Webhooks.
  4. לוחצים על יצירת תגובה לפעולה מאתר אחר (webhook). מידע נוסף על תגובות לפעולות מאתר אחר (webhooks) זמין במאמר תגובות לפעולות מאתר אחר (webhooks).
  5. נותנים שם ל-webhook.
  6. בוחרים את הסטטוס Enabled.
  7. בשדה כתובת URL, מדביקים את כתובת ה-URL שהועתקה מ-Gemini Enterprise ומוסיפים /{issue.id}.

  8. בשדה סוד, מזינים את אותו ערך שהזנתם כשיצרתם כתובת URL של תגובה לפעולה מאתר אחר (webhook) ב-Gemini Enterprise.

  9. בקטע Issue related events, בוחרים באפשרויות הבאות:

    ישויות נוצר מעודכן נמחק
    שגיאה כן כן כן
    יומן עבודה כן כן כן
    תגובה כן כן כן
    הקובץ המצורף כן לא כן

  10. בקטע Project related events, מסמנים את התיבות created,‏ updated ו-deleted של הישות Project.

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

טיפול בנתונים והרצת שאילתות

בקטע הזה מוסבר איך Gemini Enterprise מנהל את השאילתה שלכם ומהן ההשלכות על הפרטיות כשמשתמשים במאגר הנתונים המשותף.

הרצת שאילתות

אחרי שנותנים ל-Jira Cloud הרשאה ושולחים שאילתת חיפוש ל-Gemini Enterprise:

  • ‫Gemini Enterprise שולח את שאילתת החיפוש ישירות ל-API של Atlassian.
  • ‫Gemini Enterprise משלב את התוצאות עם תוצאות ממקורות נתונים מקושרים אחרים ומציג תוצאת חיפוש מקיפה.

טיפול בנתונים

כשמשתמשים בחיפוש מאוחד של צד שלישי, חלים הכללים הבאים לטיפול בנתונים:

  • מחרוזת השאילתה נשלחת למערכת הבק-אנד של צד שלישי לחיפוש (Atlassian API).
  • הצדדים השלישיים האלה עשויים לשייך את השאילתות לזהות שלכם.
  • אם מופעלים כמה מקורות נתונים של חיפוש מאוחד, יכול להיות שהשאילתה תישלח לכולם.
  • אחרי שהנתונים מגיעים למערכת של הצד השלישי, הם כפופים לתנאים ולהגבלות ולמדיניות הפרטיות של המערכת הזו.

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