בדיקה ופרסום של שילובים

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

התפקידים הנדרשים

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

• ‫בדיקת שילוב: Application Integration Invoker (roles/integrations.integrationInvoker)
• פרסום של שילוב: Application Integration Deployer (roles/integrations.integrationDeployer)

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

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

ההרשאות הנדרשות

כדי לבדוק או לפרסם שילוב, נדרשות ההרשאות הבאות:

• בדיקת שילוב: integrations.integrations.invoke
• פרסום אינטגרציה: integrations.integrationVersions.deploy

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

התפקיד "עריכת Application Integration" (roles/integrations.integrationEditor) כולל את שתי ההרשאות.

אם השילוב משתמש בחשבון שירות run-as, צריך גם את התפקיד "משתמש בחשבון שירות" (roles/iam.serviceAccountUser) בחשבון השירות הזה כדי לבדוק או לפרסם אותו. הקצאת התפקיד "משתמש בחשבון שירות"

בדיקת שילוב

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

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

כדי להריץ בדיקה של שילוב, בוחרים באחת מהאפשרויות הבאות:

המסוף

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

   כניסה ל-Application Integration

2. בתפריט הניווט שמימין, לוחצים על שילובים כדי לפתוח את הדף שילובים.
3. בוחרים את השילוב שרוצים לבדוק.

4. בסרגל הניווט של המעצב, לוחצים על בדיקה.

   אם יש כמה טריגרים שמוגדרים בשילוב, בוחרים את הטריגר שרוצים להריץ ממנו את השילוב. מופיע החלונית Test Integration.

5. לוחצים על בדיקת השילוב.

   Application Integration מריץ את האינטגרציה ומציג את תוצאת ההרצה בחלונית Test Integration:

   • כדי לערוך את משתני הקלט, לוחצים על עריכת משתני הקלט.
   • כדי לבדוק מחדש את השילוב, לוחצים על בדיקה חוזרת של השילוב.
   • כדי לשחזר את הערכים, לוחצים על שחזור ערכים.
   • כדי להציג ולבדוק את יומני הביצוע של הרצת הבדיקה, לוחצים על הצגת היומנים.
   • אם הפעלתם את Cloud Logging, כדי לראות את היומנים ב-Cloud Logging, לחצו על View Cloud logs.
   • כדי לערוך את האינטגרציה בלי ליצור גרסה חדשה שלה, לוחצים על Edit integration.
   • כדי לסגור את פעולת הבדיקה ולחזור לעורך השילוב, לוחצים על Close.

API

מפעילים את ה-method‏ projects.locations.integrations.test.

השדה clientId בגוף הבקשה הוא חובה. צריך להגדיר את מספר הפרויקט ב-Google Cloud, ולא את מזהה הפרויקט.

כדי להגדיר את הזמן הקצוב לתפוגה של התהליך, מגדירים את השדה X-Server-Timeout בכותרת. כברירת מחדל, הזמן הקצוב לתפוגה הוא 120 שניות. רשימה של קבוצת פרמטרים מוגדרים מראש של בקשות מופיעה בקטע פרמטרים של המערכת.

פרסום שילוב

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

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

המסוף

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

   כניסה ל-Application Integration

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

4. בסרגל הניווט של המעצב, לוחצים על התפריט הנפתח Version ובוחרים את גרסת האינטגרציה שרוצים לפרסם.
5. לוחצים על פרסום.

   מופיעה תיבת הדו-שיח Autogenerate Integration description. כדי ליצור תיאור, לוחצים על כן, אני רוצה להמשיך. אם לא, לוחצים על לא, רק לפרסם.

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

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

API

מפעילים את ה-method‏ projects.locations.integrations.versions.publish.

ביטול הפרסום של שילוב

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

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

המסוף

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

   כניסה ל-Application Integration

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

4. בסרגל הניווט של המעצב, לוחצים על התפריט הנפתח Version ובוחרים את גרסת האינטגרציה שרוצים לבטל את הפרסום שלה.
5. לוחצים על ביטול הפרסום.

   אחרי שהשילוב בוטל, אפשר ללחוץ על Enable editing בעורך השילובים כדי לערוך את השילוב. עריכת השילוב תיצור גרסה חדשה של השילוב הזה.

API

מפעילים את ה-method‏ projects.locations.integrations.versions.unpublish.

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

מידע נוסף על מכסות ומגבלות ב-Application Integration

שיטה מומלצת

• לפני שבודקים את השילוב, צריך להגדיר את השימושיות של משתנה (משתנה קלט או משתנה פלט). אפשר לעיין במשתני השילוב.
• מגדירים טיפול בשגיאות בשילוב.

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

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