השילוב של GitLab ב-ChatGPT וב-Codex נמצא כעת בגרסת בטא.
סקירה כללית
השתמשו בתבנית האפליקציה של GitLab Self-Managed כדי ליצור טיוטת אפליקציה ייעודית ל-workspace עבור מופע של GitLab Self-Managed או GitLab Dedicated. הזינו את שם המארח של GitLab ואת פרטי ההזדהות של אפליקציית OAuth, בדקו את טיוטת האפליקציה ולאחר מכן פרסמו אותה לחברי ה-workspace הזכאים להשתמש בה. לאחר הפרסום, הפעולות שהופעלו באפליקציה זמינות בשיחות ChatGPT ובסשנים של Codex.
לסקירה של היכולות הנתמכות של GitLab, הזמינות, ההרשאות, השימוש בנתונים ודרישות הרשת, ראו: חיבור GitLab ל-ChatGPT ול-Codex.
מה מגדירים
בתהליך זה תיצרו אפליקציה ייעודית ל-workspace מתוך תבנית האפליקציה של GitLab Self-Managed. האפליקציה משתמשת ברכיבים הבאים:
אפליקציית OAuth של GitLab הרשומה בשרת GitLab Self-Managed או GitLab Dedicated שלכם.
מזהה האפליקציה והסוד של אפליקציית OAuth ב-GitLab, לצורך קבלת הרשאה מהמשתמש.
היקפי ההרשאה הנדרשים של OAuth: api, write_repository ו-openid.
שם המארח של GitLab שלכם, למשל gitlab.example.com, לקביעת נקודות הקצה של אתר האינטרנט, ה-API, ההרשאה והאסימונים.
לפני שמתחילים
נדרשים:
גישת מנהל או בעלים ל-workspace ב-ChatGPT.
הרשאה ב-GitLab ליצירת אפליקציית OAuth: גישת בעלים בקבוצה עבור אפליקציה בבעלות קבוצה, או גישת מנהל המופע עבור אפליקציה ברמת המופע כולו.
שם המארח של GitLab בלבד, ללא https://, יציאה או נתיב. השתמשו בשרת GitLab Self-Managed או GitLab Dedicated, ולא ב-gitlab.com.
החלטה באילו פעולות GitLab יתמכו ChatGPT ו-Codex, כמו חיפוש במאגרים, תהליכי עבודה עם בקשות מיזוג או עם סוגיות, עריכת קבצים או תהליכי עבודה רחבים יותר ב-Codex.
השאירו את ChatGPT ואת GitLab פתוחים בכרטיסיות נפרדות. העתיקו את כתובת ה-URI להפניה בדיוק כפי שהיא מופיעה ב-ChatGPT; אין ליצור אותה בעצמכם או לשנות אותה.
כדי לפתוח את הדף אפליקציות מתוך מסוף הניהול, בחרו את ה-workspace הרצוי של ChatGPT, פתחו את תוספים ובחרו ניהול אפליקציות מדור קודם.
ערכים שיש להכין
שם המארח של GitLab: למשל gitlab.example.com.
כתובת URI להפניה: העתיקו אותה מתהליך הגדרת התבנית ב-ChatGPT.
מזהה האפליקציה של אפליקציית OAuth ב-GitLab.
הסוד של אפליקציית OAuth ב-GitLab.
היקפי הרשאה של OAuth: העתיקו אותם מתהליך הגדרת התבנית ב-ChatGPT.
תחילת הגדרת התבנית ב-ChatGPT
ב-ChatGPT, עברו ל-workspace שבו האפליקציה אמורה להיות זמינה.
עברו אל הגדרות workspace > אפליקציות.
בקטלוג, מצאו את GitLab, פתחו את תבנית האפליקציה של GitLab Self-Managed ובחרו הפעלה.
הזינו שם ותיאור ברורים לאפליקציה.
הזינו את שם המארח של GitLab, למשל gitlab.example.com.
העתיקו את כתובת ה-URI להפניה שמופיעה ב-ChatGPT והשאירו את הכרטיסייה פתוחה.
לדוגמה: https://chatgpt.com/connector/oauth/<redirect_id>. אין להסיר את מזהה ההפניה, להוסיף לוכסן בסוף או להחליף את כתובת ה-URI בכתובת URL כללית של ChatGPT.
יצירת אפליקציית OAuth של GitLab ב-GitLab
בחירת המיקום ליצירת האפליקציה
פתחו את שרת GitLab שלכם, למשל https://gitlab.example.com.
בחרו אם ליצור אפליקציה ברמת המופע כולו או אפליקציה בבעלות קבוצה. הבחירה קובעת מי מנהל את האפליקציה; הגישה לפרויקטים עדיין נקבעת לפי הרשאות GitLab של המשתמש שמעניק הרשאה ולפי היקפי ההרשאה שניתנו ב-OAuth.
עבור אפליקציה ברמת המופע כולו, עברו אל ניהול > אפליקציות. עבור אפליקציה בבעלות קבוצה, עברו אל הגדרות > אפליקציות של הקבוצה.
הוספת פרטי האפליקציה
בחרו אפליקציה חדשה או הוספת אפליקציה חדשה.
הזינו שם ברור לאפליקציה, למשל GitLab Self-Managed או GitLab Dedicated.
בשדה כתובת URI להפניה, הדביקו את כתובת ה-URI המדויקת שהעתקתם מ-ChatGPT.
השאירו את האפשרות סודית מופעלת עבור אפליקציית OAuth זו, הפועלת בצד השרת.
הגדרת גישה ושמירה
עבור אפליקציה ברמת המופע כולו, GitLab ממליצה לבחור מהימנה. כך מדלגים על הבקשה למתן הרשאה מהמשתמש.
בחרו בהיקפי ההרשאה api, write_repository ו-openid.
בדקו מי יכול לנהל את האפליקציה, וודאו שלמשתמשי GitLab שמעניקים לה הרשאה יש הרשאות מתאימות בקבוצות ובפרויקטים.
שמרו את האפליקציה.
דרישות להיקפי הרשאה של OAuth
התבנית מבקשת את היקפי ההרשאה הבאים של OAuth עבור פעולות GitLab שהופעלו ב-ChatGPT וב-Codex:
api: נדרש לפעולות API של GitLab שהאפליקציה מאפשרת לבצע, כולל פעולות של בקשות מיזוג, סוגיות ו-CI/CD.
write_repository: נדרש לפעולות כתיבה במאגר באמצעות Git.
openid: נדרש למידע על זהות וחברות באמצעות OpenID Connect.
העתקת פרטי ההזדהות של OAuth ב-GitLab
באפליקציה ששמרתם ב-GitLab, העתיקו את מזהה האפליקציה ואת הסוד. התייחסו לסוד כאל פרט הזדהות. אם הוא נחשף, חדשו אותו ב-GitLab וצרו אפליקציה חדשה ל-workspace.
השלמת ההגדרה ב-ChatGPT
חזרו לכרטיסיית הגדרת התבנית ב-ChatGPT.
הדביקו את מזהה האפליקציה של GitLab בשדה מזהה לקוח OAuth.
הדביקו את הסוד של GitLab בשדה סוד לקוח OAuth.
ודאו ששדה שם המארח של GitLab מכיל רק את שם המארח, למשל gitlab.example.com.
בחרו יצירת טיוטה.
פתחו את פרטי טיוטת האפליקציה ובדקו את הגדרת פעולות. ב-Enterprise וב-Edu, בדקו את גישה לפי תפקיד כדי לוודא שבעלי התפקידים הרצויים יכולים להשתמש באפליקציה. ב-Business, נהלו את זמינות האפליקציה בכל ה-workspace.
פרסום האפליקציה וניהולה עבור ChatGPT ו-Codex
יצירת טיוטת האפליקציה לא הופכת אותה לזמינה לחברים באופן אוטומטי. לאחר בדיקת הטיוטה:
בחרו פרסום עבור טיוטת האפליקציה.
עברו אל מסוף הניהול, בחרו את ה-workspace הרצוי של ChatGPT ופתחו את תוספים. ודאו ש-GitLab זמין ב-workspace.
ב-Enterprise וב-Edu, בדקו את גישה לפי תפקיד כדי לוודא שבעלי התפקידים הרצויים יכולים להשתמש ב-GitLab. ב-Business, נהלו את זמינות האפליקציה בכל ה-workspace.
בהגדרת פעולות, בדקו את פעולות הקריאה והכתיבה הזמינות.
בהגדרת אישורים, בחרו מתי המשתמשים נדרשים לאשר פעולה לפני ש-ChatGPT או Codex משתמשים באפליקציה.
בקשו ממשתמש בעל גישה לפתוח לצורך בדיקה את GitLab מתוך קטלוג התוספים או מתוך הגדרות > תוספים. ודאו שהמשתמש יכול להתקין את התוסף ולהתחבר לאפליקציה שנוצרה מתבנית GitLab Self-Managed.
הגדרות האישור האלה של האפליקציה חלות על שיחות ChatGPT ועל שרשורי Codex.
הגדרת פעילות GitLab לסקירת קוד באמצעות Codex
לאחר פרסום האפליקציה, הגדירו פעילות GitLab ב-Codex אם בכוונתכם להשתמש בסקירת קוד באמצעות Codex. הגדרת הפעילות הזו מגדירה את אירועי הוובהוק הנדרשים.
פתחו את הגדרות המחברים של Codex.
הגדירו חשבון שירות ל-workspace. אפשרו ל-Codex ליצור את החשבון, או ספקו אסימון גישה אישי של חשבון שירות קיים.
הפעילו את פעילות GitLab עבור הפרויקט או אחת מקבוצות האב שלו.
אם Codex צריך לבצע משימות תכנות או להשתמש בהגדרות ייעודיות לפרויקט, צרו סביבה לפרויקט.
אפליקציית GitLab משתמשת בהרשאת OAuth של המשתמש לצורך קריאה וביצוע פעולות שהופעלו ב-ChatGPT וב-Codex. לפעולות כתיבה במסגרת סקירות של Codex ב-GitLab Self-Managed או ב-GitLab Dedicated, אסימון חשבון השירות שמנוהל ב-workspace קובע באיזו זהות ובאילו פרויקטים Codex יכול להוסיף הערות או תגובות.
למידע נוסף: סקירת בקשות מיזוג של GitLab באמצעות Codex.
חיבור אפליקציית GitLab ובדיקתה
כמשתמשים בעלי גישה, פתחו את GitLab מתוך קטלוג התוספים או מתוך הגדרות > תוספים. בחרו התקנת תוסף ולאחר מכן חיבור.
אם ב-workspace שלכם יש יותר מאפליקציית GitLab אחת, בחרו באפליקציה של שרת GitLab Self-Managed או GitLab Dedicated הזה.
העניקו הרשאה לאפליקציית OAuth של GitLab כשתתבקשו לעשות זאת.
תחילה הפעילו פעולת קריאה מצומצמת ב-ChatGPT או ב-Codex, כמו הצגת רשימת הפרויקטים הנגישים או שליפת בקשת מיזוג מוכרת.
אם פעולות כתיבה מופעלות, בדקו אותן בפרויקט בסיכון נמוך ובכל מוצר שבו אתם מתכננים להשתמש בהן, לפני הרחבת השימוש.
שם המארח ואופן הפעולה של OAuth
האפליקציה משתמשת בשם המארח כדי לקבוע את נקודות הקצה של GitLab. יש להזין רק את שם המארח, למשל gitlab.example.com. אין לכלול https://, נתיב API או מאגר, יציאה או gitlab.com. התבנית מיועדת ל-GitLab Self-Managed או ל-GitLab Dedicated. עבור GitLab.com (SaaS), יש להשתמש באפליקציית GitLab.
פתרון בעיות בהגדרת אפליקציית GitLab Self-Managed
אי-התאמה בכתובת ה-URI להפניה: ודאו שכתובת ה-URI להפניה באפליקציית OAuth של GitLab זהה בדיוק לכתובת ה-URI להפניה שמופיעה ב-ChatGPT.
ChatGPT לא מצליח ליצור או לשמור את טיוטת האפליקציה: ודאו שהוזנו שם המארח, מזהה האפליקציה, הסוד וכתובת ה-URI להפניה.
האימות מצליח, אך הקריאות לפרויקט נכשלות: ודאו שלמשתמש GitLab שמעניק הרשאה יש גישה לפרויקט, ושלאפליקציית OAuth יש את היקפי ההרשאה של התבנית.
ה-API מחזיר שגיאת 403 או הודעה על הרשאות לא מספיקות: ודאו שלחשבון GitLab המחובר יש את ההרשאות הנדרשות בפרויקט או בקבוצה, ושאפליקציית OAuth כוללת את היקפי ההרשאה הנדרשים לתבנית.
אין גישה לאף פרויקט: ודאו שלמשתמש יש גישה לפרויקטים, שהוא מחובר למופע GitLab הרצוי ושהוא בחר באפליקציית GitLab הנכונה ב-ChatGPT או ב-Codex.