$lang['tuto'] = "سبق"; ?>$lang['tuto'] = "سبق"; ?> گائیڈ: ایک ہی رنر پر گٹ ورک فلوز

گائیڈ: ایک ہی رنر پر گٹ ورک فلوز چلانا

گائیڈ: ایک ہی رنر پر گٹ ورک فلوز چلانا
گائیڈ: ایک ہی رنر پر گٹ ورک فلوز چلانا
Lucas Simon
اتوار، 19 مئی، 2024 8:53:25 PM

مشترکہ رنرز پر GitHub ورک فلوز کو مربوط کرنا

GitHub ایکشنز میں ایک سے زیادہ ورک فلو کا انتظام کرنا مشکل ہو سکتا ہے، خاص طور پر جب آپ کو ایک ہی خود میزبان رنر پر چلانے کی ضرورت ہو۔ ایسے حالات میں جہاں آپ کے پاس مختلف ورک فلو کے لیے علیحدہ YAML فائلیں ہیں، جیسے codeql.yml اور snyk-zap.yml، اس بات کو یقینی بنانا کہ وہ کسی مخصوص گروپ کے ایک ہی رنر پر چلتی ہیں مشکل ہوسکتی ہے۔

مقصد یہ ہے کہ دونوں ورک فلو کے لیے ایک ہی رنر کو واضح طور پر رنر کا نام لیے بغیر استعمال کیا جائے، اس طرح دوسرے ورک فلو کے ساتھ تنازعات سے بچنا ہے۔ یہ گائیڈ علیحدہ YAML فائلوں میں ورک فلو کو برقرار رکھتے ہوئے مؤثر طریقے سے اس مطابقت پذیری کو حاصل کرنے کے لیے ممکنہ حل تلاش کرے گا۔

کمانڈ تفصیل
jq ایک ہلکا پھلکا اور لچکدار کمانڈ لائن JSON پروسیسر جو Bash اسکرپٹ میں JSON آؤٹ پٹ کو پارس کرنے کے لیے استعمال ہوتا ہے۔
head -n 1 نتیجہ کی پہلی سطر نکالتا ہے، جو یہاں پہلی دستیاب رنر ID کو منتخب کرنے کے لیے استعمال ہوتا ہے۔
curl URLs کے ساتھ ڈیٹا کی منتقلی کے لیے کمانڈ لائن ٹول، جو Bash اسکرپٹ میں GitHub کے API کے ساتھ تعامل کے لیے استعمال ہوتا ہے۔
os.getenv() Python میں ماحولیاتی متغیرات کو بازیافت کرتا ہے، GitHub ٹوکن اور ذخیرہ کا نام حاصل کرنے کے لیے استعمال ہوتا ہے۔
requests.get() ایک مخصوص URL پر ایک GET درخواست بھیجتا ہے، جو Python اسکرپٹ میں GitHub کے API سے دستیاب رنرز کو لانے کے لیے استعمال ہوتا ہے۔
os.path.exists() چیک کرتا ہے کہ آیا کوئی مخصوص راستہ موجود ہے، یہ تعین کرنے کے لیے استعمال کیا جاتا ہے کہ آیا Python اسکرپٹ میں رنر ID فائل پہلے سے موجود ہے۔
with open() Python میں فائل آپریشنز کے لیے سیاق و سباق مینیجر، رنر ID کو فائل میں پڑھنے اور لکھنے کے لیے استعمال کیا جاتا ہے۔

مشترکہ رنرز کے ساتھ ورک فلو کو مربوط کرنا

فراہم کردہ اسکرپٹس GitHub ورک فلوز کے لیے رنر اسائنمنٹ کا انتظام کرتی ہیں۔ Bash اسکرپٹ یہ چیک کرنے سے شروع ہوتا ہے کہ آیا رنر ID پہلے سے ہی عارضی فائل میں محفوظ ہے۔ اگر نہیں، تو استعمال کرتا ہے۔ curl دستیاب رنرز کے لیے GitHub کے API سے استفسار کرنے کے لیے اور jq JSON جواب کو پارس کرنے کے لیے، پہلے بیکار رنر کو منتخب کرکے اور اس کی ID کو محفوظ کرنا۔ Python اسکرپٹ کو استعمال کرکے اسی طرح کی فعالیت حاصل کرتی ہے۔ requests.get() GitHub کے API سے رنر کی معلومات حاصل کرنے کا طریقہ۔ اسکرپٹ پھر چیک کرتا ہے کہ آیا رنر ID پہلے سے ہی استعمال کر کے محفوظ ہے۔ os.path.exists() اور اگر نہیں تو اسے بچاتا ہے۔

دونوں اسکرپٹ اس بات کو یقینی بناتے ہیں کہ ایک بار رنر کو تفویض کیا جائے گا، اسے ذخیرہ شدہ رنر ID کا حوالہ دے کر بعد کی ملازمتوں کے لیے دوبارہ استعمال کیا جائے گا۔ Python اسکرپٹ میں، os.getenv() GitHub ٹوکن اور ریپوزٹری کے لیے ماحولیاتی متغیرات کو بازیافت کرتا ہے، اور with open() فائل آپریشنز کو محفوظ طریقے سے ہینڈل کرنے کے لیے استعمال کیا جاتا ہے۔ یہ اسکرپٹ متعدد ورک فلو کو مربوط کرنے میں مدد کرتی ہیں، اس بات کو یقینی بناتی ہیں کہ وہ رنر کے نام کو ہارڈ کوڈ کیے بغیر ایک ہی رنر پر چلتے ہیں، انہیں ورک فلو کے عمل کو منظم کرنے میں لچکدار اور موثر بناتے ہیں۔

GitHub ایکشنز کے لیے مشترکہ رنر کی حکمت عملی کو نافذ کرنا

ایک ہی رنر پر ورک فلو کو یقینی بنانے کے لیے Bash اسکرپٹنگ اور GitHub ایکشنز کا استعمال

# A script to manage runner assignment
#!/bin/bash

# Check if a runner is already assigned
RUNNER_ID=$(cat /tmp/runner_id)

if [ -z "$RUNNER_ID" ]; then
  # No runner assigned yet, pick one and save its ID
  RUNNER_ID=$(curl -s -H "Authorization: token $GITHUB_TOKEN" \
               https://api.github.com/repos/$GITHUB_REPOSITORY/actions/runners |
               jq -r '.runners[] | select(.status=="online" and .busy==false) | .id' | head -n 1)
  echo $RUNNER_ID > /tmp/runner_id
fi

echo "Using runner $RUNNER_ID"

# Proceed with the workflow using the assigned runner

علیحدہ YAML فائلوں میں مسلسل رنر کے استعمال کو یقینی بنانا

مربوط ورک فلو پر عمل درآمد کے لیے ازگر اور گٹ ہب ایکشنز کا استعمال

import requests
import os

# GitHub API token and repository
GITHUB_TOKEN = os.getenv('GITHUB_TOKEN')
REPO = os.getenv('GITHUB_REPOSITORY')

# Function to get an available runner
def get_runner():
    url = f"https://api.github.com/repos/{REPO}/actions/runners"
    headers = {'Authorization': f'token {GITHUB_TOKEN}'}
    response = requests.get(url, headers=headers)
    runners = response.json()['runners']
    for runner in runners:
        if runner['status'] == 'online' and not runner['busy']:
            return runner['id']
    return None

# Check if a runner is already assigned
if not os.path.exists('/tmp/runner_id'):
    runner_id = get_runner()
    with open('/tmp/runner_id', 'w') as f:
        f.write(str(runner_id))
else:
    with open('/tmp/runner_id', 'r') as f:
        runner_id = f.read()

print(f"Using runner {runner_id}")

GitHub ایکشنز میں موثر رنر مینجمنٹ

ایسے حالات میں جہاں ورک فلو کو ایک ہی خود میزبان رنر پر چلانے کی ضرورت ہوتی ہے، ایک اہم غور رنر کی دستیابی کو یقینی بنانا اور تنازعات کو کم کرنا ہے۔ مشترکہ رنر حکمت عملی کا استعمال، جیسا کہ پچھلی اسکرپٹس میں دیکھا گیا ہے، اس بات کو یقینی بناتا ہے کہ ایک بار رنر کو کسی کام کے لیے تفویض کیا جاتا ہے، اس کے بعد کی ملازمتیں اسی رنر کا استعمال کرتی ہیں۔ یہ پیچیدہ CI/CD پائپ لائنوں میں خاص طور پر فائدہ مند ہو سکتا ہے جہاں ریاست کو برقرار رکھنا یا کیشڈ وسائل کا استعمال بہت ضروری ہے۔

غور کرنے کا ایک اور پہلو رنر کے استعمال کو بہتر بنانا ہے۔ دستیابی کی بنیاد پر رنرز کو متحرک طور پر منتخب کرنے اور تفویض کرنے سے، تنظیمیں اپنے وسائل کا بہتر انتظام کر سکتی ہیں۔ اس طرح کی حکمت عملیوں پر عمل درآمد نہ صرف کارکردگی کو بہتر بناتا ہے بلکہ ایک دستیاب رنر کے انتظار میں قطار میں گزارنے والے ورک فلو کو بھی کم کرتا ہے۔ اس نقطہ نظر کو دیگر CI/CD ٹولز اور پلیٹ فارمز تک بڑھایا جا سکتا ہے، جس سے یہ آٹومیشن کی مختلف ضروریات کے لیے ایک ورسٹائل حل ہے۔

مشترکہ رنرز پر کام کے بہاؤ کو مربوط کرنے کے بارے میں عام سوالات

  1. میں یہ کیسے یقینی بنا سکتا ہوں کہ ایک مخصوص رنر ہمیشہ استعمال ہوتا ہے؟
  2. کا استعمال کرتے ہیں runs-on رنر گروپ یا عین رنر کا نام بتانے کے لیے اپنی YAML فائل میں کلید۔
  3. کیا میں متحرک طور پر رنرز کو ورک فلو کے لیے تفویض کر سکتا ہوں؟
  4. ہاں، دستیاب رنرز سے استفسار کرنے کے لیے اسکرپٹس کا استعمال کرکے اور انہیں متحرک طور پر تفویض کرنا۔
  5. میں مصروف ماحول میں رنر کے تنازعات کو کیسے سنبھال سکتا ہوں؟
  6. رنر مختص کو مؤثر طریقے سے منظم کرنے کے لیے قطار لگانے کا طریقہ کار نافذ کریں یا ورک فلو کو ترجیح دیں۔
  7. اگر کوئی رنرز دستیاب نہ ہوں تو کیا ہوگا؟
  8. ورک فلو اس وقت تک قطار میں رہے گا جب تک کہ کوئی رنر دستیاب نہ ہو جائے۔ انتظار کے اوقات کو کم سے کم کرنے کے لیے رنر کے استعمال کو بہتر بنائیں۔
  9. کیا میں ان اسکرپٹس کو دوسرے CI/CD پلیٹ فارم کے ساتھ استعمال کر سکتا ہوں؟
  10. ہاں، منطق کو رنر مینجمنٹ تک API رسائی والے دوسرے پلیٹ فارمز کے لیے ڈھال لیا جا سکتا ہے۔
  11. میں ورک فلو کے درمیان حالت کیسے برقرار رکھ سکتا ہوں؟
  12. یقینی بنائیں کہ ایک ہی رنر متعلقہ ملازمتوں کے لیے استعمال کیا جاتا ہے اور جہاں ممکن ہو کیشنگ میکانزم کا فائدہ اٹھانا۔
  13. ان اسکرپٹس کے لیے کن اجازتوں کی ضرورت ہے؟
  14. یقینی بنائیں کہ آپ کے GitHub ٹوکن میں ضروری اسکوپس ہیں، جیسے repo اور workflow.
  15. کیا میں ایک ہی رنر پر بیک وقت متعدد ورک فلو چلا سکتا ہوں؟
  16. عام طور پر، نہیں. ہر رنر ایک وقت میں ایک کام انجام دیتا ہے۔ ہم آہنگی کے لیے متعدد رنر استعمال کریں۔
  17. میں رنر کے استعمال اور کارکردگی کی نگرانی کیسے کروں؟
  18. رنر کی سرگرمی اور کارکردگی کو ٹریک کرنے کے لیے GitHub کے بلٹ ان مانیٹرنگ ٹولز یا بیرونی خدمات کا استعمال کریں۔

نتیجہ:

اسی خود میزبان رنر پر چلانے کے لیے GitHub ورک فلو کا انتظام کارکردگی اور مستقل مزاجی کے لیے بہت ضروری ہے۔ زیر بحث Bash اور Python اسکرپٹس رنرز کو متحرک طور پر تفویض کرکے اور اس بات کو یقینی بنا کر کہ اس کے بعد کی ملازمتیں ایک ہی رنر کا استعمال کرتے ہوئے ایک مضبوط حل فراہم کرتی ہیں۔ یہ نقطہ نظر تنازعات کو کم کرتا ہے اور وسائل کے استعمال کو بہتر بناتا ہے، یہ پیچیدہ CI/CD پائپ لائنوں کے لیے ایک مؤثر حکمت عملی بناتا ہے۔ ان طریقوں کو لاگو کرنے سے، تنظیمیں اپنے ورک فلو پر عمل درآمد کو ہموار کر سکتی ہیں اور انتظار کے اوقات کو کم کر سکتی ہیں، بالآخر پیداواری صلاحیت کو بہتر بنا سکتی ہیں اور ترقی کے ہموار عمل کو برقرار رکھ سکتی ہیں۔