آشنایی با اقدامات GitHub – جامعه dev

اقدامات GitHub به شما امکان می دهد وظایف را مستقیماً در مخزن GitHub خود خودکار کنید. گردش کار یک سری مراحل خودکار است که در یک تعریف شده است .yml پرونده ، واقع در .github/workflows/ دایرکتوری پروژه شما.

الزامات اساسی یک گردش کار

برای ایجاد یک گردش کار معتبر در اقدامات GitHub ، چند مؤلفه اساسی وجود دارد که باید حضور داشته باشند:

1. نام گردش کار (name):
   هر گردش کار باید منحصر به فرد داشته باشد نام که آن را مشخص می کند. این به تمایز بین گردش کار مختلف در مخزن کمک می کند.

2. رویداد ماشه (on):
   گردش کار باید مشخص کند کی باید اجرا شود این در زیر تعریف شده است on میدان رویدادهای مشترک شامل:

   • فشار: هنگامی که کد را به مخزن فشار می دهید ، شروع می شود.
   • pull_request: هنگام باز شدن یا به روزرسانی درخواست کشش ، شروع می شود.
   • گردش کار_دپچچ: به شما امکان می دهد یک گردش کار را به صورت دستی ایجاد کنید.

3. تعریف شغلی (jobs):
   یک گردش کار حاوی کار، که واحدهای کاری هستند که در گردش کار اجرا می شوند. هر شغل باید داشته باشد:

   • نام کار: برای شناسایی کار در گردش کار.
   • محیط سیستم عامل (runs-on): این تعریف می کند که کدام سیستم عامل کار را اجرا می کند. گزینه های محبوب شامل ubuntu-latestبا windows-latestوت macos-latestبشر بدون مشخص کردن سیستم عامل ، گردش کار نمی تواند اجرا شود ، زیرا مراحل برای اجرای آن به یک محیط مجازی (مانند اوبونتو) نیاز دارند.

4. گام:
   هر کار از آن ساخته شده است گام، که وظایف فردی هستند که در گردش کار اجرا می شوند. این مراحل می تواند شامل دستورات باشد (مانند echo) ، اقدامات ارائه شده به GitHub یا اقدامات شخص ثالث.

1. اولین گردش کار (workflow.yml)

نام: اولین گردش کار

این گردش کار به طور خودکار با فشار به main شاخه این کلیه نیازهای اصلی گردش کار را برآورده می کند: دارای نام ، ماشه ، محیط سیستم عامل و مراحل است.

• نام:
  • First Workflow شناسه این گردش کار است.

  name: First Workflow

• ماشه (on):
  • گردش کار هنگامی اجرا خواهد شد که وجود دارد push به main شاخه

  on:
    push:
      branches:
        - main

• مشاغل:
  • گردش کار یک کار به نام را تعریف می کند first-workflowبشر

  jobs:
    first-workflow:
      runs-on: ubuntu-latest

• در runs-on زمینه مشخص می کند که کار روشن خواهد شد اوبونتو (آخرین نسخه). این امر برای فراهم کردن محیطی که در آن مراحل اجرا می شود ، لازم است.

• دو مرحله در این کار وجود دارد:

  1. اولین قدم: این مرحله سه پیام را به کنسول چاپ می کند.
  2. مرحله دوم: یک پیام را چاپ می کند که نشان می دهد این مرحله دوم است.

    steps:
      - name: First Step
        run: |
          echo "this is first step"
          echo "Hello GH actions"
          echo "Do or Die"

      - name: Second Step
        run: |
          echo "yeah I am on the second step"

• خلاصه: این گردش کار به طور خودکار اجرا می شود که کد به آن هل داده می شود main دو مرحله را که پیام های موجود در کنسول را چاپ می کند ، شعبه و اجرا کنید.

2. گردش کار دستی (manual-workflow.yml)

نام: گردش کار دستی

این گردش کار را می توان به صورت دستی توسط یک کاربر از رابط Github ایجاد کرد. همچنین نیازهای اصلی گردش کار را برآورده می کند: نام ، ماشه ، سیستم عامل و مراحل.

• نام:
  • Manual Workflow نام این گردش کار است.

  name: Manual Workflow

• ماشه (on):
  • این گردش کار استفاده می کند workflow_dispatch، این بدان معنی است که می توان آن را به صورت دستی از طریق رابط Action GitHub ایجاد کرد.

  on:
    workflow_dispatch:

• مشاغل:
  • گردش کار شغلی به نام را تعریف می کند first-workflow، که در آخرین نسخه اوبونتو نیز اجرا می شود (ubuntu-latest).

  jobs:
    first-workflow:
      runs-on: ubuntu-latest

• مراحل:
  • تنها یک قدم در این گردش کار وجود دارد که سه پیام را به کنسول چاپ می کند.

    steps:
      - name: First Step
        run: |
          echo "this is first step"
          echo "Hello GH actions"
          echo "Do or Die"

• خلاصه: این گردش کار را می توان به صورت دستی از طریق رابط GitHub آغاز کرد و پیام ها را هنگام اجرا به کنسول چاپ کرد.

نکات کلیدی برای یادآوری:

مرا دنبال کن: GitHub