شروع سریع با اسکریپت #

این مراحل را دنبال کنید:

1. اجرا کنید quickstart.sh
2. دو رمز عبور را وارد کنید – یکی برای کاربر پایگاه داده “عادی” و دیگری
   برای
   ریشه
3. چند لحظه صبر کنید – TestRail دانلود و راه اندازی می شود

TestRail باید از طریق URL زیر قابل دسترسی باشد: http://localhost:۸۰۰۰

نصب را از طریق رابط کاربری وب به پایان برسانید (از مقادیر چاپ شده توسط استفاده کنید
نصب کننده
در پایان).

پس از ورود به جادوگر نصب،
باید مسیر زیر را برای Chrome Headless Shell بچسبانید:

• /usr/bin/chrome-headless-shell-linux64/chrome-headless-shell

پیکربندی توکن Jira را به‌روزرسانی کنید (برای نسخه‌های زیر ۱۰.۱.۴ لازم است)
#

اگر در حال ارتقا از نسخه ای زودتر از آن هستید 10.1.4،
شما باید فایل پیکربندی توکن Jira را به عنوان بخشی از این فرآیند به روز کنید.

1. فایل های آپدیت را دانلود کنید اینجا.
2. فایل ها را به روز کنید:
   1. برای مثال، نام ظرف سرور TestRail را پیدا کنید
      testrail-docker-srv
   2. دستور زیر را برای کپی کردن جدید اجرا کنید
      consts.php
      داخل ظرف قرار دهید

      docker cp patches/testrail-<version>/testrail/app/config/consts.php testrail-docker-srv:/var/www/testrail/app/config

   3. مالکیت فایل صحیح را تنظیم کنید.

      docker exec -it testrail-docker-srv \
      chown www-data:www-data /var/www/testrail/app/config/consts.php

اجرای TestRail با استفاده از docker-compose #

فایل نوشتن از طریق متغیرهای محیطی پیکربندی می شود – پیشنهاد می شود
به
از یک فایل env استفاده کنید. اطلاعات بیشتر در مورد یک فایل env در دسترس است
مستندات فایل های Docker env. 

1. ابتدا یک فایل .env با حداقل متغیرهای اجباری برای:
   • DB_USER
   • DB_NAME
   • DB_PWD
   • DB_ROOT_PWD
2. بعد، اجرا کنید docker-compose up
   (آن
   خواهد شد
   اولین بار چند دقیقه وقت بگذارید).
3. TestRail باید بالا باشد! دسترسی به آن از طریق: http://localhost:۸۰۰۰
4. مقادیری را که در فایل .env مشخص کرده اید، در هنگام TestRail دوباره وارد کنید
   نصب کننده
   تنظیمات پایگاه داده را می خواهد.
5. برای حذف نمونه، فشار دهید Ctrl+C و
   سپس
   اجرا کنید docker-compose down.

متغیرهای محیطی #

پیشنهاد می‌شود یک فایل .env محلی ایجاد کنید تا مختص کاربر یا ماشین را مشخص کنید
متغیرها (برای اطلاعات بیشتر به مستندات فایل های Docker env).
نحو ساده است: به عنوان مثال. “HTTP_PORT=۸۰۰۰”

متغیرهای محیطی را نیز می توان مستقیماً در پوسته با استفاده از
همان
نحو
و سپس با استفاده از docker-compose.

• DB_PORT
• HTTP_PORT
• HTTPS_PORT
• DB_URL (به عنوان مثال http://internal.yourcompany.com/۵.۷.sql)

پایگاه های داده از پیش پر شده و Config.php TestRail #

از طریق DB_URL variable، همچنین است
ممکن است
برای ارائه SQL-dump برای دانلود توسط کانتینر، بنابراین TestRail
در حال حاضر است
از پیش پیکربندی شده برای عملکرد مناسب، config.php فایل
نیاز به ارائه دارد. به سادگی آن را در قسمت کپی کنید _config پوشه
اطمینان حاصل کنید که مقادیر موجود در config.php فایل
با تنظیمات پایگاه داده برای کاربر و رمز عبور که مشخص شده است مطابقت داشته باشد
در
را
نوشتن فایل برای db.

استفاده از فایل های Compose #

استفاده عمومی #

docker-compose up
docker-compose down

استدلال up شروع می کند
ظرف؛
در حالی که down همه چیز را متوقف می کند
را docker-compose CLI
مرجع را می توان یافت اینجا.

گزینه های مفید اضافی: #

نام پوشه docker-compose در شروع می‌شود (در این مورد، ‘internal-docker’)
به عنوان نام پروژه استفاده می شود و به تمام ظروف تخم ریزی شده اضافه می شود.

توصیه: استفاده کنید docker-compose down -v،
همانطور که جلدهای نامگذاری شده و ناشناس را حذف می کند!

نکات کلی در مورد فایل های نوشتن #

• همه فایل های نوشتن به حجم های اضافی متکی هستند:
• testrail_root شامل
  نصب
  و سوار می شود /var/www/testrail
• testrail_opt شامل آپلود شده است
  فایل ها
  و غیره سوار می شود /opt/testrail
• testrail_db شامل پایگاه داده
  و
  سوار می شود /var/lib/mysql.
• testrail_config شامل
  config.php
  فایلی که TestRail را پیکربندی می کند و روی آن نصب می شود /var/www/testrail/config

کانتینرها هر چند به هم متصل هستند testrail پل زد
شبکه ترتیب شروع مهم است – php باید اول باشد و به دنبال آن
وب سرور
و DB.

مهاجرت کردن & ارتقاء TestRail #

اجرای TestRail در کانتینرهای Docker #

لطفاً نگاهی به Readme در مخزن Github بیندازید.

از TestRail استفاده می کند docker-compose به
خدمات فردی لازم را اجرا کنید و کانتینرها را به هم پیوند دهید.

برای شروع یا توقف TestRail، این دو دستور کار را انجام می دهند. آنها را در
را
ریشه
پوشه مخزن:

docker-compose up
docker-compose down

برای شروع کانتینرها در حالت جدا، کافی است یک پارامتر -d اضافه کنید: docker-compose up -d

فایل های docker-compose حاوی تعدادی متغیر با از پیش تعیین شده است
پیش فرض
ارزش ها برای تخصیص مقادیر سفارشی برای این متغیرها، a ایجاد کنید
env
فایل
(همانطور که در
مستندات فایل docker env –
این یک فایل متنی ساده با نحو VAR=VALUE است.

در غیر این صورت، امکان ارائه متغیرهای env از طریق دستور نیز وجود دارد
خط
مانند
صادرات HTTP_PORT=8008 && docker-compose up -d.

سایت
linuxhit.com فراهم می کند
یک نمای کلی خوب از نحوه استفاده از متغیرهای env در bash.

انتقال از نصب سرور TestRail موجود به کانتینرها
#

استفاده از پایگاه داده در کانتینرها #

اگر یک DB اختصاصی را فقط برای TestRail اجرا کرده اید، منطقی است که انجام دهید
اجرا کنید
را
DB در یک ظرف. برای ارتقاء مراحل زیر را دنبال کنید:

1. قبل از مهاجرت، امتیازات کاربر mysql را بررسی کنید. اگر یک کاربر
   بود
   ایجاد شده است
   با “@localhost” (محدود کردن دسترسی به “فقط از localhost”)،
   شما
   نیاز دارند
   برای ایجاد یک کاربر جدید با حق کافی برای اجازه اتصال از راه دور:
   • دسترسی به DB با mysql -p و
     لیست همه کاربران + میزبان: SELECT user, host FROM mysql.user;
   • اگر کاربر TestRail دارای “localhost” یا مقداری IP در “host” باشد.
     ستون
     (و نه «٪»)، یک کاربر جدید باید ایجاد شود – CREATE
     کاربر
     ‘testraildocker’@’%’ شناسایی شده توسط ‘newpassword’. – >GRANT ALL ON testrail.* TO 'testraildocker'@'%';
     (% اجازه اتصال از راه دور از هر IP را می دهد. اگر زیرشبکه docker خود را می شناسید – معمولاً ۱۷۲.۱۶.۲۵۵.۲۵۵ – از زیر شبکه docker داخلی مربوطه به جای “%” برای تقویت امنیت استفاده کنید.)
2. کل مطالب را کپی کنید /var/lib/mysql به
   را _mysql پوشه و
   را config.php فایل
   به _config.
3. اگر می‌خواهید پیوست‌ها، گزارش‌ها، گزارش‌ها و گزارش‌های حسابرسی را نگه دارید، ایجاد کنید
   را
   پوشه ها logs, audit, reports, attachments در
   را _opt پوشه و کپی کنید
   را
   محتوا
   از مکان قدیمی تا پوشه های جدید ایجاد شده.

4. را ویرایش کنید config.php فایل
   و
   “DB_HOSTNAME” را به تغییر دهید db:3306.
   همچنین، LOG_PATH و AUDIT_PATH را به:

   define('LOG_PATH', '/opt/testrail/logs/');
   define('AUDIT_PATH', '/opt/testrail/audit/');

5. اگر می خواهید از یک پورت خاص برای دسترسی به TestRail استفاده کنید، یک را ایجاد کنید
   env
   فایل
   (در اینجا بیشتر) و پورت را از طریق مشخص کنید
   HTTP_PORT=<portNumber>
6. اجرا کنید docker-compose up -d

همچنین مسیرها را برای پیوست ها و گزارش می دهد زیر TestRail > اداره > تنظیمات سایت به: /opt/testrail/attachments و /opt/testrail/reports

استفاده از پایگاه داده خارجی #

اگر از یک خارجی سرور پایگاه داده،
ترک
سرور DB همانطور که هست و مراحل زیر را دنبال کنید:

1. را کپی کنید config.php فایل
   به _config.
2. اگر می‌خواهید پیوست‌ها، گزارش‌ها، گزارش‌ها و گزارش‌های حسابرسی را نگه دارید، ایجاد کنید
   را
   پوشه ها logs، audit، reports،
   و attachments در _opt folder،
   و محتوا را از محل قدیمی در پوشه های ایجاد شده جدید کپی کنید.

3. LOG_PATH و AUDIT_PATH را در فایل config.php ویرایش کنید:

   define('LOG_PATH', '/opt/testrail/logs/');
   define('AUDIT_PATH', '/opt/testrail/audit/');

4. اگر می خواهید از یک پورت خاص برای دسترسی به TestRail استفاده کنید، یک را ایجاد کنید
   env
   فایل
   (بیشتر اینجا) و پورت را از طریق HTTP_PORT= مشخص کنید<شماره پورت>
5. اجرا کنید docker-compose up -d

اگر قبلاً از کانتینرها استفاده می کنید، TestRail را ارتقا دهید #

گزینه ۱: «n» سریع کثیف #

به سادگی از اسکریپت ارتقاء استفاده کنید: upgradeTestRail.sh
اگر تنظیمات پیش‌فرض را حفظ کرده باشید، TestRail را ارتقا می‌دهد
ایجاد شده است
توسط اسکریپت شروع سریع سپس باید این مراحل را دنبال کنید:

1. با اجرا کردن کانتینر داکر آپاچی را پیدا کنید
   docker ps
2. کپی کنید CONTAINER ID برای
   testrail/apacheتصویر
3. اجرا کنید
   docker exec -it <container_id> بش
   برای ورود به کانتینر داکر
4. حرکت به /var/www/testrail دایرکتوری
5. اجرا کنید php run.php update

اگر از مکان‌های سفارشی برای فایل‌های DB و غیره استفاده می‌کنید، از گزینه ۲ استفاده کنید،
زیر

گزینه ۲: انجام ارتقاء مرحله به مرحله #

برای ارتقا TestRail از یک نسخه قدیمی به یک نسخه جدیدتر (به عنوان مثال ۶.۰.۰ به ۶.۰.۱)،
انجام دهد
مراحل زیر:

1. ظروف را ببندید: docker-compose down -v
2. (اختیاری) اگر نسخه اختصاصی TestRail را به عنوان مثال مشخص کرده اید.
   الف .env فایل
   – نسخه ای را که می خواهید به آن ارتقا دهید تنظیم کنید.
3. تصاویر را بکشید: docker-compose pull
4. توصیه می شود: ایجاد نسخه پشتیبان (به زیر مراجعه کنید)
5. TestRail را راه اندازی کنید docker-compose up -d
6. با اجرا کردن کانتینر داکر آپاچی را پیدا کنید
   docker ps
7. کپی کنید CONTAINER ID برای
   testrail/apache تصویر
8. اجرا کنید
   docker exec -it <container_id> بش
   برای ورود به کانتینر داکر
9. حرکت به /var/www/testrail دایرکتوری
10. اجرا کنید php run.php update

همچنین می توانید با کپی کردن این سه پوشه در a یک ارتقای “ایمن” انجام دهید
جدید
مکان
و سپس دویدن docker-compose.

موضوعات پیشرفته #

آپاچی در مقابل nginx و MySQL در مقابل MariaDB #

TestRail در حال حاضر به طور رسمی از Apache + MySQL پشتیبانی می کند. با خیال راحت بده
nginx
و mariadb را امتحان کنید – با این حال، لطفا توجه داشته باشید که این به طور رسمی نیست
پشتیبانی می شود.
اگر مشکلی در این دو سیستم پیدا کردید، لطفاً به ما اجازه دهید
بدان،
بنابراین می توانیم در آینده به پشتیبانی بالقوه nginx/mariadb نزدیک شویم.

ایجاد پشتیبان #

همه ظروف بدون حالت هستند، بنابراین می توان آنها را با خیال راحت خارج کرد. مربوطه
داده ها
است
ذخیره شده در حجم های محلی: به طور پیش فرض در _config، _mysql،
و _opt. فقط یک نسخه پشتیبان ایجاد کنید
از اینها
پوشه ها

متغیرهای محیطی #

• TESTRAIL_VERSION
• OPT_PATH
• CONFIG_PATH
• MYSQL_PATH
• HTTP_PORT
• DB_PORT
• DB_URL
• DB_USER
• DB_PWD
• DB_NAME
• DB_ROOT_PWD
• TR_DEFAULT_TASK_EXECUTION

خودتان تصاویر را بسازید #

همچنین امکان ساخت تصاویر Docker توسط خودتان وجود دارد. همه Dockerfiles
می تواند
پیدا شود در این پوشه.
دستورالعمل های ساخت در زیر پوشه های مربوطه می باشد.