فرآیند: کاربر که این رویداد را در ابزار توسعه آغاز می کند با تطبیق آدرس ایمیل به کاربر JIRA نقشه برداری می شود ، سپس نام کاربری ، یعنی. - کاربر تک جیرا با آدرس ایمیل تطبیق یافته - مسئله را به عنوان کاربر JIRA انتقال دهید.
- هیچ کاربر JIRA با آدرس ایمیل تطبیق یافته - مسئله را به عنوان یک کاربر ناشناس انتقال دهید. وقتی نمی توانیم کاربر را با ماشه مطابقت دهیم ، مسئله را با یک کاربر ناشناس جابجا می کنیم. این بدان معنا نیست که کاربران ناشناس با دسترسی به سایت JIRA شما وجود دارند.
- چندین کاربر با آدرس ایمیل تطبیق در JIRA - سعی کنید نام کاربری مطابق با آن گروه از کاربران را پیدا کنید. اگر یک کاربر JIRA با نام کاربری تطبیق وجود دارد ، مسئله را به عنوان کاربر JIRA انتقال دهید. اگر نام کاربری تطبیق وجود ندارد ، مسئله را به عنوان یک کاربر ناشناس انتقال دهید.
سرور Bitbucket
آدرس ایمیل و نام کاربری مورد استفاده برای نقشه برداری کاربر
آدرس ایمیل و نام کاربری مورد استفاده برای نقشه برداری کاربر برای Server Bitbucket 7. 14+ در صورت استفاده از OAUTH
همه رویدادهای درخواست PULL
آدرس ایمیل سرور Bitbucket و نام کاربری کاربر که درخواست کشش را انجام داده است.
آدرس ایمیل سرور Bitbucket و نام کاربری کاربر که درخواست کشش را انجام داده است.
کاربر Bitbucket باید حداقل با آدرس ایمیل پیکربندی شده در نمایه خود ، حداقل یک مرتبه انجام دهد. در غیر این صورت ، درخواست کشش را نمی توان برای کاربر JIRA نقشه برداری کرد. این بدان معنی است که مسئله به عنوان یک کاربر ناشناس منتقل می شود.
آدرس ایمیل مرتبط با تعهد و نام کاربری سرور Bitbucket که آدرس ایمیل به آن نقشه می کند. اگر آدرس ایمیل به نام کاربری نقشه نکند ، از نویسندگان "نام" از این تعهد استفاده می شود.
آدرس ایمیل مرتبط با تعهد و نام کاربری سرور Bitbucket که آدرس ایمیل به آن نقشه می کند. اگر آدرس ایمیل به نام کاربری نقشه نکند ، مسئله به عنوان یک کاربر ناشناس منتقل می شود.
آدرس ایمیل سرور Bitbucket و نام کاربری کاربر معتبر که شعبه را به سرور Bitbucket سوق داده است.
آدرس ایمیل مرتبط با کاربر سرور Bitbucket که آخرین تعهد را در شعبه انجام داده است. اگر آدرس ایمیل به کاربر JIRA نقشه نکشید ، مسئله به عنوان یک کاربر ناشناس منتقل می شود.
fisheye/crucible
آدرس ایمیل و نام کاربری مورد استفاده برای نقشه برداری کاربر
آدرس ایمیل مرتبط با تعهد و نام کاربری Fisheye که آدرس ایمیل به آن نقشه می کند. اگر آدرس ایمیل به نام کاربری نقشه نکند ، از نویسندگان "نام" از این تعهد استفاده می شود.
این رویداد برای کاربر JIRA نقشه برداری نمی شود. این بدان معنی است که مسئله به عنوان یک کاربر ناشناس منتقل می شود.
همه رویدادهای مرور
آدرس ایمیل Crucible و نام کاربری کاربر معتبر که این بررسی را انجام داده است.
ابر بیتباکت
آدرس ایمیل و نام کاربری مورد استفاده برای نقشه برداری کاربر
همه رویدادهای درخواست PULL
آدرس ایمیل Bitbucket و نام کاربری کاربر که درخواست کشش را انجام داده است. توجه داشته باشید ، کاربر Bitbucket باید حداقل یک تعهد (با آن آدرس ایمیل پیکربندی شده برای مشخصات آنها) انجام دهد ، در غیر این صورت درخواست کشش نمی تواند برای کاربر JIRA نقشه برداری شود. این بدان معنی است که مسئله به عنوان یک کاربر ناشناس منتقل می شود.
آدرس ایمیل مرتبط با تعهد و نام کاربری Bitbucket که آدرس ایمیل به آن نقشه می کند. اگر آدرس ایمیل به نام کاربری نقشه نکند ، از نویسندگان "نام" از این تعهد استفاده می شود.
این رویداد برای کاربر JIRA نقشه برداری نمی شود. این بدان معنی است که مسئله به عنوان یک کاربر ناشناس منتقل می شود.
GitHub / GitHub Enterprise
آدرس ایمیل و نام کاربری مورد استفاده برای نقشه برداری کاربر
درخواست PULL ایجاد شده / درخواست را ادغام کنید
آدرس ایمیل GitHub و نام کاربری کاربر که درخواست کشش را انجام داده است. توجه داشته باشید ، کاربر GitHub باید حداقل یک تعهد (با آن آدرس ایمیل پیکربندی شده برای نمایه خود) انجام دهد ، در غیر این صورت درخواست کشش نمی تواند برای کاربر JIRA نقشه برداری شود. این بدان معنی است که مسئله به عنوان یک کاربر ناشناس منتقل می شود.
آدرس ایمیل مرتبط با تعهد و نام کاربری GitHub که آدرس ایمیل به آن نقشه می کند. اگر آدرس ایمیل به نام کاربری نقشه نکند ، از نویسندگان "نام" از این تعهد استفاده می شود.
آدرس ایمیل مرتبط با کاربر سرور Bitbucket که آخرین تعهد را در شعبه انجام داده است. اگر آدرس ایمیل به کاربر JIRA نقشه نکشید ، مسئله به عنوان یک کاربر ناشناس منتقل می شود.
رسیدگی به رویداد و محدودیت رویداد
در بیشتر موارد ، پردازش وقایع از ابزارهای توسعه شما به انتقال خودکار مسئله باید یکپارچه باشد. با این حال ، گاهی اوقات ممکن است تأخیرهایی در انتقال مسائل وجود داشته باشد یا به دلیل نحوه برخورد با وقایع یا محدودیت رویداد ، به هیچ وجه در حال انتقال یا موضوعاتی نیست.
- رسیدگی به رویداد - بسته به اینکه آیا ابزار توسعه از طریق اتصال DVCS یا پیوند برنامه به JIRA متصل می شود ، رویدادها متفاوت انجام می شوند. این می تواند تأثیر بگذارد که وقایع به تأخیر بیفتند یا از بین بروند در صورت عدم دسترسی JIRA:
Bitbucket Cloud و GitHub Enterprise
رویدادهای Bitbucket Cloud و GitHub Enterprise از طریق اتصال DVCS در JIRA پردازش می شوند. اتصال DVCS رویدادها را از Bitbucket Cloud و GitHub Enterprise از طریق دو مکانیسم هماهنگ سازی: یک هماهنگ سازی با وب سایت و یک همگام سازی برنامه ریزی شده پردازش می کند.
- هماهنگ سازی WebHook: اتصال DVCS از Webhooks در Bitbucket و GitHub Enterprise برای ارسال داده ها در هنگام وقوع یک رویداد استفاده می کند. این مکانیسم استاندارد برای پردازش رویدادها است ، به این معنی که تقریباً بلافاصله پس از یک رویداد Cloud/GitHub Bitbucket باید به طور خودکار به طور خودکار منتقل شود.
- هماهنگ سازی برنامه ریزی شده: اگر هنگام وقوع یک رویداد Bitbucket Cloud/GitHub Enterprise ، با JIRA تماس نگیرد ، این رویداد توسط کانکتور DVCS ذخیره می شود و در هماهنگ سازی برنامه ریزی بعدی (هر 60 دقیقه به طور پیش فرض) ارسال می شود. این یک مکانیسم پشتیبان گیری در صورت عدم موفقیت هماهنگ سازی وب سایت است.
سرور Bitbucket و Fisheye/Crucible
رویدادهای سرور Bitbucket و Fisheye/Crucible از طریق لینک برنامه پردازش می شوند. با این حال ، سرور Bitbucket و Fisheye/Crucible وظیفه اطمینان از ارسال وقایع را بر عهده دارند و آنها را در زمان وقوع این رویداد یک بار ارسال می کنند. این بدان معنی است که اگر JIRA هنگام ارسال رویدادها در دسترس نباشد ، وقایع از بین می روند.
- محدودیت های رویداد - محدودیت های رویداد بر روی همه ابزارهای توسعه اعمال می شود تا JIRA با رویدادهای بیش از حد بیش از حد بارگیری نشود. هر رویدادی که پس از فراتر از حد رویداد ارسال شده است از بین می رود. محدودیت رویداد برای هر ابزار توسعه در زیر ذکر شده است:
Bitbucket Cloud و GitHub Enterprise
- هماهنگ سازی ناشی از وب: 10 شاخه ؛100 تعهد
- هماهنگ سازی برنامه ریزی شده: 600 شاخه (فاصله همگام سازی در دقیقه x 10) ؛6000 تعهد (فاصله همگام سازی در دقیقه x 100) محدودیت رویداد برای همگام سازی های برنامه ریزی شده می تواند کمتر از 600 شاخه و 6000 تعهد باشد ، در صورت کاهش فاصله همگام سازی ، اما هرگز بیشتر نیست.
سرور Bitbucket
10 شاخه ؛100 تعهد در هر هماهنگ سازی محدودیت دیگری که در بالای 10 شعبه اعمال می شود و 100 تعهد محدودیت 100000 مسئله تغییر یافته است. به عنوان مثال ، اگر 100 مرجع بیش از 1000 کلید شماره را انجام دهد ، از حد تغییر موضوع فراتر می رود.
fisheye/crucible
6000 رویداد در هر هماهنگ سازی
چگونه محرک ها با سایر عملیات/محدودیت های گردش کار ارتباط دارند
هنگامی که یک انتقال به طور خودکار انجام می شود ، هرگونه شرایط ، اعتبار سنجی یا مجوزهای پیکربندی شده در انتقال را نادیده می گیرد.
با این حال ، توابع پست هنوز اجرا می شوند. شما باید مراقب باشید که اگر عملکرد پست شما به کاربر نیاز دارد ، انتقال شما توسط یک کاربر ناشناس اجرا نمی شود (به بخش نقشه برداری کاربر در بالا مراجعه کنید).
عیب یابی
اگر در تنظیم یک ماشه یا فعال کردن یک ماشه مشکل دارید، مراحل زیر را برای عیب یابی مشکل خود دنبال کنید.
1. از تشخیص ماشه استفاده کنید
اولین قدم شما در عیب یابی یک ماشه بررسی عیب یابی آن در Jira است. تشخیص می تواند به شما بگوید که آیا مشکلی در اتصال به ابزارهای توسعه شما وجود دارد یا اینکه آیا مشکلی به طور خودکار همانطور که انتظار می رفت تغییر نکرده است.
- Navigate to the Jira administration console> Issues> Workflows>گردش کار خود را پیدا کنید و روی View (ستون عملیات) کلیک کنید
- در حالت متن (و نه حالت نمودار)، روی انتقال مورد نظر کلیک کنید.
- در صفحه انتقال (برگه Triggers نشان داده خواهد شد)، برای نشان دادن اطلاعات عیب یابی، روی مشاهده جزئیات برای محرک مورد نظر کلیک کنید.
- بخش "منابع محرک" مشکلات مربوط به ادغام بین Jira و ابزارهای توسعه شما را فهرست می کند. به عنوان مثال، اینکه آیا نوع صحیح احراز هویت را پیکربندی کرده اید یا خیر.
- بخش «شکست های انتقال» مشکلاتی را فهرست می کند که علی رغم شلیک ماشه در انتقال خودکار شکست خورده اند. به عنوان مثال، یک کاربر ناشناس به انتقال نگاشت شده است، اما انتقال دارای یک تابع پست است که به یک کاربر غیر ناشناس نیاز دارد.
2. مشکلات رایج را بررسی کنید
اگر نمی توانید مشکل خود را با اطلاعات مربوط به عیب یابی ماشه حل کنید، فهرست مشکلات رایج زیر را برای دلایل و راه حل های احتمالی بررسی کنید.
من نمی توانم یک ماشه به یک انتقال اضافه کنم:
علل احتمالی.
Jira یا ابزارهای توسعه شما نسخه صحیحی نیستند
نصب/ارتقا به نسخه صحیحشما باید Jira 6. 3. 3+ و یکی از ابزارهای توسعه زیر را برای فعال کردن محرک های گردش کار داشته باشید: Bitbucket Server ( Bitbucket Server 3. 2. 0+)، Fisheye/Crucible 3. 5. 2+، Bitbucket، GitHub Enterprise
ابزارهای توسعه شما به درستی به Jira متصل نیستند
پیکربندی اتصال خود را بررسی کنید:
- Jira + Bitbucket Server/Fisheye/Crucible: باید یک پیوند برنامه دو طرفه را با استفاده از Oauth با 2LO و 3LO پیکربندی کنید.
- Jira + Bitbucket Cloud/GitHub Enterprise: باید کانکتور DVCS را به درستی پیکربندی کنید.
- Jira + Bitbucket Cloud/Github: بررسی کنید که برنامه Github به درستی نصب شده باشد.
ماشه ای که می خواهید اضافه کنید قبلاً به انتقال اضافه شده است
همه محرک ها در هر انتقال منحصربه فرد هستند، یعنی فقط یک بار می توانید یک ماشه به یک انتقال اضافه کنید.
موضوع تغییر نمی کند:
علل احتمالی.
پروژه شما از گردش کاری که با تریگرها پیکربندی شده است استفاده نمی کند
Navigate to your project's summary> Administration>گردش کار، و بررسی کنید که پروژه شما از گردش کاری که با تریگرها پیکربندی کرده اید استفاده می کند.
شما در جایی که محرک ها اضافه شده اند ، تغییرات گردش کار خود را ذخیره نکرده اید
به گردش کار که به محرک اضافه شده اید بروید. بررسی کنید که با مشاهده انتقال گردش کار و تأیید حضور محرک های شما منتشر شده است.
توسط DVC های شما نمی توان به جیرا رسید
یک ساعت صبر کنیداگر هنوز نمی توان بعد از یک ساعت به آن رسید ، بررسی کنید که اتصال به DVC های شما به درستی پیکربندی شده است ، به ادغام با ابزارهای توسعه مراجعه کنید.
اگر محرک ها پیکربندی نشده باشند یا JIRA از Bitbucket Cloud/GitHub Enterprise قابل دسترسی نباشد ، ممکن است تاخیر تا یک ساعت باشد ، زیرا هنوز هم هماهنگ ساعتی از تعهدات/شاخه ها/درخواست های کشش بدون در نظر گرفتن پیکربندی Triggers وجود دارد. برای اطلاعات بیشتر ، به بخش رسیدگی به رویداد و محدوده رویداد در بالا مراجعه کنید.
مخزن DVCS شما به حساب DVCS هماهنگ مرتبط نیست
Navigate to the Jira administration console> Add-ons>حساب های DVCS و مخزن خود را فعال کنید.
اگر شما Bitbucket Cloud یا GitHub Enterprise را برای AutoLink مخازن جدید پیکربندی نکرده اید ، ممکن است مخازن داشته باشید که فعال نیستند (یعنی به حساب DVC خود مرتبط هستند). این بدان معناست که وقایع موجود در مخزن نامشخص به JIRA ارسال نمی شود ، از این رو مسئله به طور خودکار انتقال نمی یابد ، حتی اگر یک ماشه را پیکربندی کرده باشید.
تعهدات شما خیلی قدیمی است
فقط مرتکب کمتر از 21 روزه می شود ، باعث انتقال خواهد شد. این برای جلوگیری از بارگذاری فله از ایجاد انتقال فله است.
این عمل برای کاربران ناشناس مجاز نیست
بررسی کنید که هر کاربر در ابزارهای توسعه شما به کاربر JIRA نقشه می کند.
برخی از عملیات مسئله هنگامی که انتقال توسط یک کاربر ناشناس انجام می شود ، استثنائاتی را به وجود می آورد. اینها هستند:
- رویداد CreatiSsue (این احتمالاً مربوط به انتقال "ایجاد" یا "ایجاد مسئله" در گردش کار شما است)
- توابع ارسال شده که یک کاربر را فرض می کند ، انتقال را انجام می دهد
در صورتی که این رویداد در ابزار توسعه نمی تواند برای کاربر JIRA نقشه برداری شود ، یک انتقال تحریک شده توسط یک کاربر ناشناس انجام می شود. برای اطلاعات بیشتر ، به بخش نقشه برداری کاربر در بالا مراجعه کنید.
حداکثر تعداد انتقال خودکار مجاز برای یک مسئله از آن فراتر رفته است
بررسی کنید که انتقال گردش کار شما به یک حلقه نامحدود پایان نمی یابد.
رویدادهای انتقال خودکار مسئله به اشتباه توسط ابزار توسعه سرکوب می شوند
تنظیمات مخزن/پروژه را تغییر دهید تا امکان ارسال رویدادها فراهم شود.
در صورت ارسال رویدادهای کپی ، مخازن Bitbucket Server (Bitbucket Server 3. 3 - 3. 5) یا Fisheye (3. 5+) را پیکربندی کرده اید. رویدادهای مخزن تکراری ممکن است هنگامی که همان مخزن را که توسط ابزارهای توسعه چندگانه نمایه شده است ، به جیرا ارسال شود. توجه داشته باشید ، JIRA هنگام پردازش محرک های گردش کار ، به طور خودکار رویدادهای تعهد تکراری (JIRA 6. 3. 3+) و رویدادهای ایجاد شعبه (JIRA 6. 3. 11+) را حذف می کند.
شما نباید رویدادهای مخزن را از سرور Bitbucket یا Fisheye سرکوب کنید ، مگر اینکه رویدادهای تکراری باعث ایجاد نادرست مشکلات شوند.
مسئله انتقال می یابد اما همانطور که انتظار می رود:
علل احتمالی.
شما یک ماشه را در یک انتقال جهانی پیکربندی کرده اید
بررسی کنید که چگونه رویداد ماشه بر موضوعات موجود در وضعیت های مختلف تأثیر می گذارد. در نظر بگیرید که ماشه را از انتقال جهانی حذف کنید.
ما توصیه می کنیم که محرک های انتقال جهانی را پیکربندی نکنید ، مگر اینکه اطمینان داشته باشید که دقیقاً می دانید که ماشه چگونه بر رفتار مسئله تأثیر می گذارد. برای اطلاعات بیشتر به محرک ها و انتقال های جهانی در بالا مراجعه کنید.
شرایط گردش کار ، اعتبار سنج ها و مجوزها عمداً برای انتقال خودکار مسئله نادیده گرفته می شوند
اگر انتظار داشتید که شرایط گردش کار ، اعتبار سنج ها یا مجوزها برای انتقال خودکار به کار گرفته شود ، لطفاً توجه داشته باشید که هیچ یک از این موارد صدق نمی کند. مربوط به این ، توابع پست در مورد انتقال خودکار مسئله اعمال می شود.
گردش کار شما در چندین پروژه به اشتراک گذاشته می شود
اگر می خواهید محرک هایی برای برخی از پروژه ها اعمال کنند ، اما نه برخی دیگر ، ممکن است نیاز به کپی کردن گردش کار خود داشته باشید.
محرک ها به گردش کار اعمال می شوند. اگر یک گردش کار در چندین پروژه به اشتراک گذاشته شود ، شامل کلیه محرک هایی است که برای آن پیکربندی شده اند.
کپی کردن وقایع انتقال خودکار مسئله توسط ابزارهای توسعه چندگانه ارسال می شود
تنظیمات مخزن/پروژه را در یک (یا بیشتر) ابزارهای توسعه خود تغییر دهید تا از ارسال وقایع جلوگیری کنید.
رویدادهای مخزن تکراری ممکن است هنگامی که همان مخزن را که توسط ابزارهای توسعه چندگانه نمایه شده است ، به جیرا ارسال شود. JIRA به طور خودکار رویدادهای تعهد تکراری (JIRA 6. 3. 3 و بعد از آن) و رویدادهای ایجاد شعبه (JIRA 6. 3. 11 و بعد) را حذف می کند.
اگر از آخرین نسخه JIRA استفاده نمی کنید و رویدادهای مخزن کپی را ایجاد می کنید که باعث انتقال نادرست می شود ، می توانید سرور Bitbucket (Bitbucket Server 3. 3 - 3. 5) و مخزن Fisheye (3. 5+) را برای سرکوب رویدادهای ارسال شده به JIRA برای محرک های گردش کار پیکربندی کنید.
اطلاعات ثبت شده برای انتقال صحیح نیست:
علل احتمالی.
کاربران در ابزارهای توسعه شما برای کاربران در JIRA نقشه نمی کنند
بررسی کنید که هر کاربر در ابزارهای توسعه شما به کاربر JIRA نقشه می کند.
اگر کاربران به درستی نقشه برداری نشوند ، کاربر برای انتقال مسئله ناشناس خواهد بود. برای اطلاعات بیشتر ، به بخش نقشه برداری کاربر در بالا مراجعه کنید.
مسئله شناخته شده: کاربر صحیح فقط در برگه های "تاریخ" و "فعالیت" برای مسائل در جیرا و در ایمیل های اعلان نشان داده شده است. در سایر اعلان ها (به عنوان مثال برگه "انتقال" برای مسائل) یک کاربر ناشناس نشان داده شده است.
این یک مسئله شناخته شده است که در نسخه آینده برطرف خواهد شد.
3. کمک بگیرید
اگر هنوز نمی توانید مشکل خود را برطرف کنید ، تعدادی از منابع کمکی دیگر در دسترس است ، از جمله انجمن های برنامه های ما ، جامعه اطلس و تیم پشتیبانی ما.
هنگامی که یک انتقال به طور خودکار انجام می شود ، هرگونه شرایط ، اعتبار سنجی یا مجوزهای پیکربندی شده در انتقال را نادیده می گیرد.
با این حال ، توابع پست هنوز اجرا می شوند. شما باید مراقب باشید که اگر عملکرد پست شما به کاربر نیاز دارد ، انتقال شما توسط یک کاربر ناشناس اجرا نمی شود (به بخش نقشه برداری کاربر در بالا مراجعه کنید).