یکپارچه‌سازی‌ها و پیوند تیکت
یکپارچه‌سازی، ارورا را به سامانهٔ کنترل نسخهٔ شما وصل می‌کند. این کار دو چیز را باز می‌کند: رفع خودکار با هوش مصنوعی (خواندن کد و باز کردن مرج‌ریکوئست) و پیوند تیکت (ساخت یا وصل‌کردن تیکت گیت‌لب از دل یک خطای ارورا).
اتصال گیت‌لب
تنظیمات ← یکپارچه‌سازی‌ها ← افزودن یکپارچه‌سازی:
| فیلد | توضیح |
|---|---|
provider | gitlab (خودمیزبان یا gitlab.com). github برای انتشار بعدی آماده شده است. |
base_url | نشانی نمونهٔ شما، مثل https://gitlab.example.com. پیش‌فرض https://gitlab.com است. |
access_token | توکن دسترسی شخصی یا گروهی. رمزگذاری‌شده ذخیره می‌شود. |
name | برچسبی که چند نمونه را از هم تفکیک می‌کند |
اسکوپ توکن: ساده‌ترین اسکوپ کارآمد api است — ارورا باید بتواند پروژه‌ها را فهرست کند، محتوای
فایل بخواند، شاخه بسازد و مرج‌ریکوئست و تیکت باز کند.
curl -X POST "$ERRORA/api/v1/organizations/$ORG_ID/integrations" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"provider":"gitlab","base_url":"https://gitlab.example.com","access_token":"glpat-…","name":"Company GitLab"}'
مدیریت یکپارچه‌سازی‌ها به توانمندی integration:manage نیاز دارد.
همگام‌سازی مخزن‌ها
بعد از اتصال، همگام‌سازی مخزن‌هایی را که توکن می‌بیند می‌آورد:
POST /api/v1/organizations/{org_id}/integrations/{id}/sync
GET /api/v1/organizations/{org_id}/integrations/{id}/repositories
هر مخزن با شناسهٔ ارائه‌دهنده، path_with_namespace، آدرس وب و شاخهٔ پیش‌فرض ذخیره می‌شود.
پیوند مخزن به پروژه
در تنظیمات پروژه، مخزنی را انتخاب کنید که کدش خطاهای آن پروژه را تولید می‌کند. همین مخزن است که رفع خودکار از آن می‌خواند و رویش مرج‌ریکوئست باز می‌کند.
پیوند تیکت از صفحهٔ خطا
روی هر خطای ارورا می‌توانید:
- تیکت گیت‌لب بسازید — عنوان و توضیح از استثنا، ردپای فراخوانی و پیوند بازگشت به ارورا از پیش پر می‌شود.
- تیکت موجود را وصل کنید — میان تیکت‌های مخزن جست‌وجو کنید و یکی را بچسبانید، در صورت تمایل همراه با یک کامنت حاوی پیوند ارورا.
تیکت‌های وصل‌شده در صفحهٔ خطا فهرست می‌شوند تا نفر بعدی بدون جست‌وجو آن‌ها را ببیند.
GET /api/v1/projects/{project_id}/issues/{issue_id}/external-issues
POST /api/v1/projects/{project_id}/issues/{issue_id}/external-issues
GET /api/v1/projects/{project_id}/external-issues/search?q=
GET /api/v1/projects/{project_id}/issues/{issue_id}/repositories
عیب‌یابی
| نشانه | علت / راه‌حل |
|---|---|
| همگام‌سازی چیزی برنمی‌گرداند | توکن هیچ پروژه‌ای نمی‌بیند — اسکوپ و گروه آن را بررسی کنید |
پاسخ 401 از سمت ارائه‌دهنده | توکن منقضی یا باطل شده؛ دوباره واردش کنید (توکن‌ها در API فقط‌نوشتنی‌اند) |
| نمونهٔ گیت‌لب شما در دسترس نیست | ارورا از سرورهای خودش صدایش می‌زند نه از مرورگر شما — نمونه باید از اینترنت با گواهی معتبر در دسترس باشد |
| ساخت MR شکست می‌خورد | توکن دسترسی نوشتن ندارد، یا شاخهٔ پیش‌فرض در برابر ساخت شاخه محافظت شده است |