חיבור GitLab ל-Notion

במסמך העזרה הזה

GitLab עוזרת לצוותים לנהל קוד, לשתף פעולה בפיתוח תוכנה ולעקוב אחר גרסאות. באפשרותך לסנכרן פרויקטים, בעיות, בקשות מיזוג, צינורות עיבוד (pipelines) וגרסאות של GitLab לתוך Notion כדי לשמור על עבודת הפיתוח לצד התוכניות והמסמכים של הצוות שלך.


אנחנו מחליפים את סנכרוני ה-GitLab המנוהלים הקיימים בסנכרונים מותאמים המופעלים על ידי Notion Workers. באפשרותך להתאים אישית אילו נתונים לסנכרן וכיצד הם מאורגנים ב-Notion. הנתונים המסונכרנים הקיימים שלך נשארים ב-Notion; עקוב אחר מדריך זה כדי להגדיר החלפה. למידע נוסף על Notion Workers →

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

Workers מריצים את הסנכרון שלך על התשתית של Notion. כדי להגדיר את ההחלפה שלך, ציין ב-@-mention את מאגר הידע המסונכרן הקיים שלך בצ'אט עם Notion AI וכלול את מיומנות סנכרון ה-GitLab.

להכין את הדברים הבאים:

  • מאגר הידע המסונכרן של GitLab הקיים שלך ב-Notion. יש לוודא ש-Notion AI יכול לגשת אליו.

  • הרשימה המלאה של פרויקטי GitLab שיש לכלול. באפשרותך לספק כתובות URL של פרויקטים, מזהים מספריים או נתיבים כגון my-team/my-project. למד כיצד להציג פרויקטים ב-GitLab →

  • אסימון גישה אישי או של פרויקט ב-GitLab עם read_api וגישה לכל פרויקט שנבחר.

  • גישה ל-Workers ולכלים ש-Notion AI צריכה כדי ליצור ולפרוס Worker בסביבת העבודה שלך.

  • דף מיומנות זה, שאותו תעתיק לחשבון ה-Notion שלך: GitLab Guide: Worker Sync. מיומנות זו מיועדת ל-GitLab.com. אם אתה משתמש במופע GitLab בניהול עצמי, הודע ל-Notion AI לפני ההגדרה. כתובת ה-API ותצורת האישורים של המדריך זקוקות להתאמה ואימות עבור המופע שלך.

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

יש לפתוח צ'אט עם Notion AI בסביבת העבודה המכילה את מאגר הידע המסונכרן הקיים שלך.

יש להעתיק את ההנחיה שלהלן. יש להחליף את @Existing GitLab sync database על ידי הקלדת @ ובחירת מאגר הידע בפועל מתפריט האזכורים. אם בעיות ובקשות מיזוג נמצאות במאגרים מסונכרנים נפרדים, יש לציין את שניהם.

יש להחליף את סנכרון ה-GitLab הנוכחי שלי, @Existing GitLab sync database, ב-Notion Worker באמצעות GitLab Guide: Worker Sync.

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

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

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

יש לבחור אזכור של מאגר ידע בפועל בהנחיה. הקלדת שם מאגר הידע בלבד אינה מספקת ל-Notion AI קישור לבדיקה.

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

יש לעקוב אחר הוראות Notion AI כדי לספק את אסימון ה-GitLab שלך דרך קלט האישורים המאובטח. הוא זקוק ל-read_api ולגישה לפרויקטים שנבחרו.

אין להדביק את האסימון בצ'אט, בדף Notion או במאפיין של מאגר ידע. ה-Worker משתמש בפרטי אימות מתווכים, כך שהקוד שלו אינו זקוק לקריאת האסימון הגולמי.

הגדרה זו משתמשת בפרטי אימות חדשים של Worker. חיבור ה-GitLab הקיים שלך לא מספק אותם באופן אוטומטי.

אם Notion AI לא יכול לגשת למיומנות או לכלי ה-Worker, יש לפתור תחילה את בעיית הגישה. המדריך המקושר מכיל גם הוראות הגדרה עבור מישהו בצוות שלך שיכול להשתמש ב-Notion CLI.

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

מאגר ידע

מה זה כולל

פרויקטים של GitLab

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

נושאים (Issues) של GitLab

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

בקשות מיזוג של GitLab

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

צינורות עיבוד (Pipelines) של GitLab

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

גרסאות הפצה (Releases) של GitLab

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

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

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

יש לבדוק את ההבדלים האלה לפני המעבר:

  • אנשים ותוויות: מחברים, אחראים ותוויות נשמרים כטקסט במדריך זה. הם אינם מאפייני "אדם" או "בחירה מרובה" ב-Notion.

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

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

  • יש לבקש מ-Notion AI להעריך כל שדה נוסף שזרימת העבודה הקיימת שלך דורשת.

יש להמתין עד ש-Notion AI תאשר שכל חמשת הסנכרונים תקינים ושהייבוא הראשוני הושלם.

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

  2. יש לאשר שיחסי פרויקט ותצוגות לוח המחוונים מציגים את הרשומות הצפויות.

  3. יש לבדוק ששינוי אחרון ב-GitLab מגיע לתחליף לאחר רענון מוצלח.

  4. יש לעיין במאפיינים המותאמים אישית של מאגר הידע הישן ובערכים של Notion בלבד עם Notion AI. יש להעביר את מה שנדרש באמצעות מזהי רשומות יציבים של GitLab.

  5. יש לעדכן קישורים, תצוגות מאגר ידע מקושרות, יחסים ואוטומציות שצריכים להשתמש בתחליף. יש לעיין בהרשאות השיתוף של הדף החדש.

  6. ברגע שהצוות שלך עובר לתחליף, יש לבקש מ-Notion AI לעזור להוציא משימוש את הסנכרון הישן, תוך שמירה על מאגר הידע הישן זמין לעיון.

לא נדרש למחוק את מאגר הידע הישן כדי להשתמש ב-Worker. יש לשמור אותו עד לוודא שהמידע וזרימת העבודה של הצוות שלך נלקחו בחשבון.

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

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

עדכונים זורמים מ-GitLab ל-Notion. בצע שינויים בערכים מסונכרנים ב-GitLab; שינויים ב-Notion אינם נכתבים בחזרה.

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

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

המיומנות מתחילה בדף GitLab Sync פרטי. שתף אותו רק עם האנשים שצריכים לראות את הרשומות המיובאות.

ההרשאות של Notion שולטות בגישה לנתונים המסונכרנים. המאפיין Visibility של פרויקט GitLab או המאפיין Confidential של בעיה אינם אוכפים את הרשאת המקור הזו ב-Notion. עיין בנתונים הכלולים על ידי האסימון לפני שיתוף הדף.

פרויקט חסר

אשר את רשימת הפרויקטים המלאה ואת הגישה לאסימון. תן ל-Notion AI את כתובת ה-URL או המזהה המספרי של הפרויקט אם הנתיב שלו השתנה. אל תריץ רענון עם רשימה מקוצרת רק כדי לעקוף שגיאת גישה.

נושא או בקשת מיזוג חסרים

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

לוח המחוונים ריק

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

אני רואה מאגרי ידע כפולים

בקש מ-Notion AI לבדוק את ה-Worker הקיים, כתובות ה-URL של מאגרי הידע ומבנה הדף לפני יצירת כל דבר אחר. המיומנות דורשת חמישה מאגרי ידע מסונכרנים בפועל ולוח מחוונים אחד תחת GitLab Sync. תן ל-Notion AI לזהות כפילויות כלשהן לפני הסרתן.

העדכונים נעצרו

בקש מ-Notion AI לבדוק את ההרצות האחרונות של ה-Worker, תוקף האסימון, הרשאות האסימון והגישה לכל פרויקט שנבחר. עבור מופע בניהול עצמי, בדוק גם את מארח GitLab שהוגדר. מגבלות בקשות עלולות לעכב עדכונים.


מתן משוב

האם המשאב הזה היה שימושי?


Powered by Fruition