GitLab در ChatGPT و Codex در حال حاضر در مرحله بتا است.
نمای کلی
با استفاده از الگوی برنامه GitLab Self-Managed، برای یک نمونه GitLab Self-Managed یا GitLab Dedicated پیشنویس برنامهای ویژه فضای کاری ایجاد کنید. نام میزبان GitLab و اطلاعات ورود برنامه OAuth را ارائه دهید، پیشنویس برنامه را بازبینی کنید و سپس آن را برای اعضای واجد شرایط فضای کاری منتشر کنید. پس از انتشار، کنشهای فعال برنامه در گفتوگوهای ChatGPT و نشستهای Codex در دسترساند.
برای آشنایی کلی با قابلیتهای پشتیبانیشده GitLab، دسترسپذیری، مجوزها، استفاده از دادهها و الزامات شبکه، به این مطلب مراجعه کنید: اتصال GitLab به ChatGPT و Codex.
آنچه راهاندازی میکنید
شما از الگوی برنامه GitLab Self-Managed، برنامهای ویژه فضای کاری ایجاد میکنید. این برنامه از موارد زیر استفاده میکند:
یک برنامه OAuth در GitLab که روی میزبان GitLab Self-Managed یا GitLab Dedicated شما ثبت شده است.
شناسه برنامه و رمز OAuth در GitLab برای تأیید کاربر.
محدودههای دسترسی لازم OAuth: api، write_repository و openid.
نام میزبان GitLab شما، مانند gitlab.example.com، برای تعیین نقاط پایانی وب، API، تأیید و توکن.
پیش از شروع
به موارد زیر نیاز دارید:
دسترسی سرپرست یا مالک فضای کاری ChatGPT.
مجوز GitLab برای ایجاد برنامه OAuth: دسترسی مالک گروه برای برنامه متعلق به گروه، یا دسترسی سرپرست نمونه برای برنامهای در سطح کل نمونه.
فقط نام میزبان GitLab، بدون https://، درگاه یا مسیر. از میزبان GitLab Self-Managed یا GitLab Dedicated استفاده کنید، نه gitlab.com.
تصمیمگیری درباره کنشهای GitLab که ChatGPT و Codex باید پشتیبانی کنند؛ مانند جستوجوی محل نگهداری، گردشکارهای درخواست ادغام و مشکل، ویرایش فایل یا گردشکارهای گستردهتر Codex.
ChatGPT و GitLab را در برگههای جداگانه باز نگه دارید. URI تغییرمسیر نمایشدادهشده در ChatGPT را دقیقاً کپی کنید؛ آن را ایجاد یا ویرایش نکنید.
مقادیر موردنیاز
نام میزبان GitLab: برای مثال، gitlab.example.com.
URI تغییرمسیر: آن را از روند راهاندازی الگو در ChatGPT کپی کنید.
شناسه برنامه OAuth در GitLab.
رمز OAuth در GitLab.
محدودههای دسترسی OAuth: آنها را از روند راهاندازی الگو در ChatGPT کپی کنید.
Start the template setup in ChatGPT
In ChatGPT, switch to the workspace where the app should be available.
Go to Workspace settings > Plugins.
In Directory, find GitLab, open its GitLab Self-Managed app template, and select Enable.
Enter a clear app name and description.
Enter the GitLab hostname, such as gitlab.example.com.
Copy the Redirect URI shown in ChatGPT, and keep this tab open.
Example: https://chatgpt.com/connector/oauth/<redirect_id>. Do not remove the redirect ID, add a trailing slash, or replace the URI with a generic ChatGPT URL.
ایجاد برنامه OAuth در GitLab
محل ایجاد برنامه را انتخاب کنید
میزبان GitLab خود را باز کنید؛ برای مثال، https://gitlab.example.com.
انتخاب کنید که برنامه در سطح کل نمونه ایجاد شود یا متعلق به یک گروه باشد. این انتخاب مشخص میکند چه کسی برنامه را مدیریت میکند؛ دسترسی به پروژه همچنان تابع مجوزهای GitLab کاربر تأییدکننده و محدودههای دسترسی اعطاشده OAuth است.
برای برنامهای در سطح کل نمونه، به سرپرستی > برنامهها بروید. برای برنامه متعلق به گروه، در گروه به تنظیمات > برنامهها بروید.
افزودن جزئیات برنامه
برنامه جدید یا افزودن برنامه جدید را انتخاب کنید.
نامی روشن برای برنامه وارد کنید؛ مانند GitLab Self-Managed یا GitLab Dedicated.
در URI تغییرمسیر، URI دقیقی را که از ChatGPT کپی کردهاید جایگذاری کنید.
برای این برنامه OAuth سمت سرور، گزینه محرمانه را فعال نگه دارید.
پیکربندی دسترسی و ذخیره
برای برنامهای در سطح کل نمونه، GitLab توصیه میکند مورد اعتماد را انتخاب کنید. با این کار، اعلان تأیید کاربر نمایش داده نمیشود.
محدودههای دسترسی api، write_repository و openid را انتخاب کنید.
بررسی کنید چه کسانی میتوانند برنامه را مدیریت کنند و مطمئن شوید کاربران تأییدکننده GitLab مجوزهای مناسب گروه و پروژه را دارند.
برنامه را ذخیره کنید.
الزامات محدوده دسترسی OAuth
الگو برای کنشهای فعال GitLab در ChatGPT و Codex، محدودههای دسترسی OAuth زیر را درخواست میکند:
api: برای عملیات API در GitLab که برنامه ارائه میدهد، از جمله کنشهای درخواست ادغام، مشکل و CI/CD، لازم است.
write_repository: برای عملیات نوشتن در محل نگهداری از طریق Git لازم است.
openid: برای اطلاعات هویت و عضویت OpenID Connect لازم است.
کپی اطلاعات ورود OAuth در GitLab
در برنامه ذخیرهشده GitLab، شناسه برنامه و رمز را کپی کنید. رمز را اطلاعات ورود محرمانه در نظر بگیرید. اگر افشا شد، آن را در GitLab تمدید کنید و یک برنامه جدید برای فضای کاری بسازید.
تکمیل راهاندازی در ChatGPT
به برگه راهاندازی الگو در ChatGPT برگردید.
شناسه برنامه GitLab را در شناسه سرویسگیرنده OAuth جایگذاری کنید.
رمز GitLab را در رمز سرویسگیرنده OAuth جایگذاری کنید.
تأیید کنید که نام میزبان GitLab فقط شامل خود نام میزبان است؛ مانند gitlab.example.com.
ایجاد پیشنویس را انتخاب کنید.
جزئیات پیشنویس برنامه را باز کنید و «دسترسی نقشها» و «پیکربندی کنشها» را بازبینی کنید.
انتشار و مدیریت برنامه برای ChatGPT و Codex
ایجاد پیشنویس برنامه، آن را بهطور خودکار در دسترس اعضا قرار نمیدهد. پس از بازبینی پیشنویس:
برای پیشنویس برنامه، انتشار را انتخاب کنید.
به تنظیمات فضای کاری > افزونهها بروید و تأیید کنید که GitLab برای نقشهای موردنظر در دسترس است.
دسترسی نقشها را برای نقشهایی که باید از برنامه استفاده کنند بازبینی کنید.
در پیکربندی کنشها، کنشهای خواندن و نوشتن موجود را بازبینی کنید.
در پیکربندی تأییدها، مشخص کنید کاربران چه زمانی باید پیش از استفاده ChatGPT یا Codex از برنامه، کنشی را تأیید کنند.
از کاربر آزمایشی دارای دسترسی بخواهید GitLab را از فهرست افزونهها یا تنظیمات > افزونهها باز کند. تأیید کنید که کاربر میتواند افزونه را نصب کند و به برنامه ایجادشده از الگوی Self-Managed در GitLab متصل شود.
این تنظیمات تأیید برنامه برای گفتوگوهای ChatGPT و رشتههای Codex اعمال میشوند.
راهاندازی فعالیت GitLab برای بازبینی کد با Codex
پس از انتشار برنامه، اگر قصد دارید از بازبینی کد Codex استفاده کنید، فعالیت GitLab را در Codex پیکربندی کنید. این راهاندازی فعالیت، رویدادهای وبهوک لازم را پیکربندی میکند.
تنظیمات رابطهای Codex را باز کنید.
یک حساب سرویس فضای کاری پیکربندی کنید. اجازه دهید Codex حساب را ایجاد کند، یا برای حساب سرویس موجود یک توکن دسترسی شخصی ارائه دهید.
فعالیت GitLab را برای پروژه یا یکی از گروههای والد آن فعال کنید.
اگر Codex باید وظایف کدنویسی را اجرا کند یا از راهاندازی ویژه پروژه استفاده کند، یک محیط پروژه ایجاد کنید.
برنامه GitLab برای خواندن و کنشهای فعال در ChatGPT و Codex از OAuth کاربر استفاده میکند. برای نوشتن بازبینیهای Codex در GitLab Self-Managed یا GitLab Dedicated، توکن حساب سرویس مدیریتشده توسط فضای کاری، هویت و پروژههایی را تعیین میکند که Codex میتواند در آنها نظر بدهد یا واکنش نشان دهد.
بیشتر بخوانید: بازبینی درخواستهای ادغام GitLab با Codex.
اتصال و آزمایش برنامه GitLab
بهعنوان کاربری دارای دسترسی، GitLab را از فهرست افزونهها یا تنظیمات > افزونهها باز کنید. نصب افزونه و سپس اتصال را انتخاب کنید.
اگر فضای کاری شما بیش از یک برنامه 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 انتخاب کرده است.