ادغام با Travis CI

تراویس سی یک ابزار CI/CD (ادغام و استقرار مستمر) است که به تیم های توسعه کمک می کند کد را به سرعت منتشر کنند و ساخت، آزمایش و استقرار برنامه های خود را خودکار کنند. با استفاده از Travis CI، مهندسان می توانند کل مجموعه آزمایشی خود را برای commit های جدید خودکار کنند و احتمال خطای انسانی را کاهش دهند.

یک مورد استفاده روزمره برای Travis CI در حال ساخت و آزمایش برنامه شما در هر زمان که تغییرات کد ارسال می شود. برای استفاده کامل از TestRail و مدیریت تمام تست‌کیس‌ها و نتایج تست، اعم از دستی و خودکار، می‌توانید نتایج تست خودکار خود را مستقیماً از Travis CI به TestRail ارسال کنید. این مقاله چگونگی استفاده آسان از Travis CI و the TestRail CLI برای انجام این وظیفه

استفاده از TestRail CLI در بیلدهای Travis CI #

فرآیندهای خودکار را می توان در Travis CI با استفاده از a پیکربندی کرد .travis.yml فایل را .travis.yml فایل فرآیند ساخت را شرح می دهد. این فایل های YAML به شما این امکان را می دهند که فرآیند ساخت خود را به صورت ساختاریافته مشخص کنید. زیر .travis.yml، می توانید یک محیط ساخت پیش فرض و مجموعه ای از مراحل پیش فرض را برای هر زبان برنامه نویسی تعیین کنید.

ساده ترین راه برای ادغام TestRail با Travis CI این است که شما را پیکربندی کنید .travis.yml برای استفاده از TestRail CLI برای ارسال نتایج تست خودکار به TestRail. در زیر نمونه ای از نحوه فایل گردش کار با استفاده از TestRail CLI برای ارسال نتایج تست به TestRail به نظر می رسد.

dist: xenial
jobs:
  include:
    - stage: Run tests and upload results to TestRail
      language: python
      python: 3.9-dev
      addons:
        chrome: stable
      script:
        - mvn clean compile test
      after_script:
        - pip install trcli
        - trcli -y
           -h https://INSTANCE.testrail.io/
           --project "PROJECT NAME"
           -u USER_EMAIL
           -p PASSWORD
           parse_junit
           --title "Automated Tests from Travis workflow"
           --run-description $TRAVIS_JOB_WEB_URL
           -f "./target/surefire-reports/TEST-TestSuite.xml"

یک ساخت در Travis CI دنباله ای از مراحل. هر مرحله از یک دنباله از کارها تشکیل شده است. هر مرحله در Travis CI در یک واحد در یک ظرف تازه یا یک ماشین مجازی اجرا می شود.

شکستن .travis.yml، متوجه حقایق جالبی می شویم.

• ما انتخاب کرده ایم محیط ساخت Xenial برای اجرای این بیلد
• این بیلد از یک کار تشکیل شده است که وظیفه اجرا و آپلود نتایج تست در TestRail را بر عهده دارد.
• ما دوتا داریم فازها در داخل کار فاز اول script تست ها و فاز دوم را اجرا می کند after_script برای نصب استفاده می شود TestRail CLI و نتایج آزمون را در TestRail بارگذاری کنید.

به طور کلی، کار شامل مراحل زیر است:

1. Set up environment for the test automation framework 
2. Add Chrome browser 
3. Run the tests 
4. Upload the results to TestRail

مرحله ۱: محیطی را برای چارچوب اتوماسیون تست تنظیم کنید #

در کارمان از محیط ساخت Xenial، که نسخه پایتون را از قبل نصب کرده است.3.8.13“، اما برای استفاده از TestRail CLI، ما باید نسخه به روز شده پایتون را نصب کنیم. برای انجام این کار، ما عبارت “3.9.devنسخه پایتون با استفاده از کلید پایتون در مشخصات زبان.

jobs:
 include:
   - stage: Run tests and upload results to TestRail
     language: python
     python: 3.9-dev
  

مرحله ۲: مرورگر کروم را اضافه کنید #

را افزونه گوگل کروم به بیلدهای Travis CI اجازه می دهد تا Google Chrome را در زمان اجرا نصب کنند. می‌توانید نسخه پایدار یا بتا Chrome را نصب کنید.

addons:
  chrome: stable

مرحله ۳: تست ها را اجرا کنید #

این مرحله به صورت تعریف شده است script در داخل کار این مرحله وظیفه اجرای آزمایشات را بر عهده دارد.

script:
  - mvn clean compile test

مرحله ۴: نتایج را در TestRail بارگذاری کنید #

این مرحله به صورت تعریف شده است after_script. این دو عمل متفاوت انجام می دهد:

• را نصب کنید TestRail CLI.
• تماس بگیرید TestRail CLI برای آپلود گزارش JUnit تولید شده توسط چارچوب اتوماسیون تست شما و ارسال نتایج به TestRail.

را TestRail CLI یک بسته پایتون است که در فهرست بسته پایتون میزبانی می شود (PyPI). برای نصب آن دستور را اجرا می کنیم pip install trcli.

بعد از TestRail CLI نصب شده است، تعداد کمی وجود دارد استدلال های اجباری که باید باهاش کنار بیاییم after_script دستوری مانند آدرس نمونه TestRail و اعتبارنامه، پروژه ای که می خواهید به آن گزارش دهید، عنوان اجرای تست و مسیر گزارش JUnit.

برای اطلاعات بیشتر در مورد استدلال، لطفاً TestRail CLI مستندات

after_script:
  - pip install trcli
  - trcli -y
     -h https://INSTANCE.testrail.io/
     --project "PROJECT NAME"
     -u USER_EMAIL
     -p PASSWORD
     parse_junit
     --title "Automated Tests from Travis workflow"
     --run-description $TRAVIS_JOB_WEB_URL
     -f "./target/surefire-reports/TEST-TestSuite.xml"

نمونه کار با استفاده از TestNG و سلنیوم #

TravisCI از بسیاری از ابزارهای کنترل نسخه مانند GitHub، GitLab و Bitbucket پشتیبانی می کند، اما در این مقاله، مخزن GitHub را در نظر خواهیم گرفت.

در زیر مثالی آورده شده است که نحوه اجرای آزمایشات سلنیوم در Travis CI و سپس گزارش نتایج به TestRail را نشان می دهد.

1. یک مخزن جدید در GitHub ایجاد کنید
2. فایل ها را از TestNG-سلنیوم نمونه پروژه  
3. جایگزین کنید TESTRAIL_INSTANCE، نام پروژه، USER_EMAIL، و رمز عبور در  .travis.yml فایل را با استفاده از مشخصات خود (توصیه می کنیم رمز عبور را مستقیماً جایگزین نکنید و از آن استفاده کنید متغیرهای محیطی Travis CI در عوض).  
4. پروژه را در مخزن GitHub خود آپلود کنید.

اجرای گردش کار #

1. حرکت به وب سایت تراویس CI و کلیک کنید وارد شوید دکمه

   

2. وارد شوید به تراویس CI با GitHub اعتبارنامه

   

3. در داشبورد از تراویس CI می توانید همه را ببینید مخازن فعال با گزینه ای برای ماشه ساخت.

   

4. ماشه ساخت برای TestNG-سلنیوم مخزن
5. پس از شروع ساخت، روی پیوند مخزن در داشبورد کلیک کنید. در اینجا می توانید وضعیت ساخت را به صورت مشاهده کنید در حال دویدن

   
   
   
   

6. پس از تکمیل ساخت، همانطور که در تصویر زیر نشان داده شده است، با رنگ سبز نشان داده می شود.

   

7. در Job log می بینید که تست های خودکار با موفقیت انجام شد و نتایج تست در TestRail آپلود شد.

   

   

   

   

8. نمونه TestRail خود را باز کنید و نتایج Test Run خود را ببینید.

   

بعدش چی؟ #

اکنون که نتایج تست خود را روی TestRail متمرکز کرده‌اید، نه تنها می‌توانید نتایج تست‌های خودکار خود را به همراه پیام‌های خطای آزمایش‌های ناموفق بررسی کنید، بلکه می‌توانید تلاش‌های آزمایشی دستی و خودکار خود را در گزارش‌هایی که پوشش کامل آزمون پیرامون برنامه‌تان را به شما نشان می‌دهند و حتی پیشرفت اتوماسیون آزمایش را ردیابی کنید، تجمیع کنید. همچنین می‌توانید یک اشکال را مستقیماً از نتیجه آزمایش خودکار به یک ردیاب مشکل ترجیحی خود گزارش دهید، همانطور که برای نتایج تست دستی خود انجام می‌دهید!

می توانید به آن نگاه کنید گزارش‌های TestRail و ویدئو معیارهای تست برای آشنایی با نحوه استفاده از قابلیت های گزارش دهی TestRail.