نصب افزونه در Jira فقط کپیکردن یک JAR نیست. نسخه محصول، نوع استقرار، دسترسی ادمین، backup، لایسنس و سناریوهای تست باید از قبل مشخص شوند. این راهنما بر اساس ساختار build و descriptor مخزن افزونه نوشته شده و برای هر محیط باید با رویه تغییرات سازمان تطبیق داده شود.
پیشنیازهای قبل از نصب
نسخه دقیق Jira، نوع استقرار، نسخه Java، روش دسترسی به UPM و فهرست افزونههای مرتبط را ثبت کنید. backup معتبر از application data و پایگاهداده بگیرید و برای نصب در محیط تست، یک snapshot یا برنامه rollback داشته باشید.
در مخزن فعلی، pom نسخه هدف Jira را 9.12.0 و source/target جاوا را 11 تعریف کرده است. این اطلاعات برای ارزیابی اولیه مفید است، اما معیار نهایی، آزمون روی instance مشتری و سازگاری با سیاست پشتیبانی سازمان است.
- نسخه Jira و نوع نصب
- نسخه Java و سیستمعامل
- لیست افزونههای UI و تاریخمحور
- backup و برنامه بازگشت
- کاربر administrator برای نصب و فعالسازی
ساخت یا دریافت artifact
در فرایند توسعه، Node برای ساخت bundle جاوااسکریپت و Maven برای بسته افزونه استفاده میشود. نسخه package.json فعلی افزونه 11.4.61 است و build با wrapper Maven مستند شده است. در زمان انتشار باید artifact دقیق نسخه از target انتخاب شود و فایلهای قدیمی با آن اشتباه نشوند.
برای مشتری معمولاً artifact release شده و checksum یا شناسه نسخه کافی است؛ build داخلی باید در محیط کنترلشده و بدون قرار دادن کلیدهای خصوصی در workspace انجام شود.
نصب و فعالسازی
روش نصب را بر اساس سیاست سازمان انتخاب کنید: UPM، upload از پنل مدیریت یا مسیر مورد تأیید تیم عملیات. پس از نصب، صفحه مدیریت لایسنس افزونه شناسه سرور را نشان میدهد و administrator میتواند کلید دریافتشده را فعال کند.
کلید لایسنس به instance Jira وابسته است. اگر محیط staging و production جدا هستند، شناسه هر محیط باید در فرایند صدور و پشتیبانی لحاظ شود.
تست پس از نصب
حداقل یک issue با Due Date، یک DateTime، یک ویرایش inline، یک جستوجوی تاریخ و یک نمونه Activity Stream را تست کنید. اگر JSM، Roadmaps، Audit Log، JXL یا افزونههایی مانند ScriptRunner دارید، همان contextها را نیز در matrix آزمون قرار دهید.
در هر سناریو مقدار قبل از ذخیره، مقدار بعد از ذخیره، نتیجه API یا گزارش و رفتار هنگام refresh را ثبت کنید. تست فقط بازشدن popup کافی نیست.
- بازشدن و بستن popup
- انتقال درست تاریخ در save و edit
- نمایش تاریخ در گزارش و جستوجو
- رفتار license نامعتبر یا منقضی
- تست مرورگرهای مورد استفاده سازمان
Rollout مرحلهای
پس از تأیید pilot، نصب را برای گروههای کاربری یا پروژهها مرحلهای کنید و کانال مشخصی برای گزارش خطا داشته باشید. راهنمای کوتاه استفاده و FAQ داخلی، تعداد تیکتهای اولیه را کم میکند. در پایان هر مرحله، نتیجه و ناسازگاریها را مستند کنید.
پرسشهای متداول
آیا نصب افزونه نیازمند restart Jira است؟+
روش نصب و نسخه Jira تعیینکننده است. رویه رسمی تیم عملیات و دستورالعمل artifact همان محیط را ملاک قرار دهید و قبل از تغییر، پنجره نگهداری و rollback داشته باشید.
آیا میتوان مستقیم روی production نصب کرد؟+
برای محیطهای سازمانی، ابتدا نصب و تست روی staging یا pilot پیشنهاد میشود؛ سپس rollout کنترلشده روی production انجام شود.