GitHub মার্জ সারি সক্ষম করতে PyGithub-এর সাথে নিয়মসেট এবং শাখা সুরক্ষা নিয়ম ব্যবহার করুন

গিটহাবের সাথে মার্জ প্রসেস স্ট্রীমলাইন করা: মার্জ সারি সক্ষম করার জন্য একটি গাইড

সফ্টওয়্যার ডেভেলপমেন্ট দলগুলি যেমন বৃদ্ধি পায়, তেমনি তাদের গিট ওয়ার্কফ্লোগুলির জটিলতাও বৃদ্ধি পায়। একাধিক সংগ্রহস্থল পরিচালনা করা, পুল অনুরোধগুলি পরিচালনা করা এবং মসৃণ একীকরণ নিশ্চিত করা একটি চ্যালেঞ্জ হতে পারে। সাম্প্রতিক অগ্রগতিগুলির মধ্যে একটি যা এই সমস্যাগুলি সমাধান করার লক্ষ্যে গিটহাবের মার্জ কিউ। এই বৈশিষ্ট্যটি আপনাকে একটি নিয়ন্ত্রিত এবং অনুমানযোগ্য পদ্ধতিতে পুল অনুরোধগুলিকে একত্রিত করার প্রক্রিয়াটিকে স্বয়ংক্রিয় করতে দেয়, এটি নিশ্চিত করে যে কোডটি সর্বদা বিবাদ সৃষ্টি না করেই আপ টু ডেট রয়েছে৷ 🚀

যাইহোক, একত্রীকরণ সারি সক্ষম করা এবং কনফিগার করা একটি সুইচ ফ্লিপ করার মতো সোজা নয়। সঠিক সেটআপের জন্য GitHub GraphQL API ব্যবহার করতে হবে, বিশেষ করে রুলসেট এর মাধ্যমে। বিকাশকারীরা, আমার মতো, এই বৈশিষ্ট্যগুলিকে স্কেলে প্রয়োগ করার চেষ্টা করার সময় প্রায়শই চ্যালেঞ্জের সম্মুখীন হয়, বিশেষত যখন শত শত সংগ্রহস্থল পরিচালনা করে। আমার মনে আছে গিটহাব আলোচনার গভীরে ডুব দেওয়া এবং মার্জ সারি সম্পর্কিত সহায়ক কিন্তু এখনও জটিল ব্যাখ্যাগুলিতে হোঁচট খেয়েছি। কিন্তু আসল কৌতুক হল এই বৈশিষ্ট্যটিকে কার্যকরভাবে সক্ষম করার জন্য কীভাবে সঠিক গ্রাফকিউএল মিউটেশন লিখতে হয় তা বোঝা। 🤔

শাখা সুরক্ষা নিয়ম নিয়ে আমার প্রথম অভিজ্ঞতাটি কিছুটা ধাঁধার মত ছিল। আমি GraphQL ব্যবহার করে সফলভাবে শাখাগুলি রক্ষা করতে সক্ষম হয়েছি, কিন্তু মার্জ কিউ কার্যকারিতা কনফিগার করার জন্য আরও নির্দিষ্ট পদ্ধতির প্রয়োজন। এই গাইডের লক্ষ্য হল কীভাবে আপনার সংগ্রহস্থলে মার্জ সারি চালু করা যায়, পথের কিছু সাধারণ বাধার সমাধান করা এবং PyGithub কীভাবে এই কাজগুলিকে সরল করার ক্ষেত্রে মূল ভূমিকা পালন করতে পারে তা ব্যাখ্যা করা। এটা শুধুমাত্র নিয়ম যোগ করার বিষয়ে নয়, এটি তাদের একসাথে কাজ করার জন্য মসৃণভাবে তৈরি করা। 💻

এই পোস্টে, আমরা GraphQL API এবং রুলসেট ব্যবহার করে মার্জ সারি সক্রিয় করার প্রক্রিয়াটি অন্বেষণ করব। আপনি API কলগুলির সাথে শাখা সুরক্ষা নিয়মগুলিকে কীভাবে স্বয়ংক্রিয় করতে হয় তা দেখতে পাবেন এবং এমনকি যদি আপনি মিউটেশনের সাথে চ্যালেঞ্জের মুখোমুখি হন তবে এই নির্দেশিকাটি স্পষ্টতা প্রদান করবে। এছাড়াও, আমরা এই বৈশিষ্ট্যটি কনফিগার করার বিকল্পগুলি নিয়ে আলোচনা করব, বিশেষ করে যদি আপনি GraphQL-এর সাথে সরাসরি কাজ করার পরিবর্তে PyGithub ব্যবহার করে আরও হ্যান্ডস-অন পদ্ধতি খুঁজছেন। ব্যবহারিক উদাহরণ এবং কিছু সমস্যা সমাধানের টিপস সহ, আমরা আপনার GitHub অভিজ্ঞতাকে আরও দক্ষ করে তোলার লক্ষ্য রাখি। 🔧

স্ক্রিপ্ট কিভাবে কাজ করে এবং এটি কিসের জন্য ব্যবহৃত হয়

এই স্ক্রিপ্টে, লক্ষ্য হল একটি সংগ্রহস্থলের জন্য শাখা সুরক্ষা নিয়ম কনফিগার করতে GitHub এর GraphQL API ব্যবহার করা। একটি GraphQL ক্যোয়ারী ব্যবহার করে রিপোজিটরি আইডি আনার জন্য GitHub-এর API-এ একটি অনুরোধ পাঠানোর মাধ্যমে প্রক্রিয়াটি শুরু হয়। এটি অপরিহার্য কারণ শাখা সুরক্ষা বা মার্জ সারি সক্ষম করার মতো যেকোনো পরিবর্তন প্রয়োগ করতে আইডি প্রয়োজন। `get_repository_id()` ফাংশনে, রিপোজিটরির নাম এবং মালিকের সাথে রিপোজিটরির অনন্য আইডি পুনরুদ্ধার করে একটি অনুরোধ করা হয়। এপিআই এই আইডি দিয়ে সাড়া দেয়, আমাদের সুরক্ষা নিয়ম তৈরি করে এগিয়ে যেতে দেয়।

পরবর্তী ধাপে শাখা সুরক্ষা নিয়ম প্রয়োগ করতে সংগ্রহস্থল আইডি ব্যবহার করা জড়িত। একটি শাখার সুরক্ষা সেট করতে `create_branch_protection_rule()` ফাংশন একটি GraphQL মিউটেশন তৈরি করে। এই ক্ষেত্রে, যে শাখাটিকে সুরক্ষিত করতে হবে তা `BRANCH_PATTERN` ভেরিয়েবল দ্বারা সংজ্ঞায়িত করা হয় এবং সুরক্ষা বিধিগুলির মধ্যে পর্যালোচনাগুলি অনুমোদন করা, স্থিতি পরীক্ষা নিশ্চিত করা এবং প্রশাসকের অনুমতিগুলি প্রয়োগ করার মতো প্রয়োজনীয়তাগুলি অন্তর্ভুক্ত৷ এই সেটিংসগুলি সংগ্রহস্থলের প্রয়োজনের উপর ভিত্তি করে কাস্টমাইজ করা হয়েছে, যেমন নিশ্চিত করা যে শুধুমাত্র পাস করা বিল্ডগুলি একত্রিত হতে পারে বা কঠোর অনুমোদনের কার্যপ্রবাহ প্রয়োগ করতে পারে।

মিউটেশন সংজ্ঞায়িত হয়ে গেলে, স্ক্রিপ্টটি `requests.post` পদ্ধতি ব্যবহার করে GitHub এর GraphQL API-এ একটি অনুরোধ পাঠায়। এটি মিউটেশন ক্যোয়ারী এবং প্রাসঙ্গিক প্যারামিটার সহ একটি পোস্ট অনুরোধ পাঠায়। অনুরোধ সফল হলে, API তৈরি করা সুরক্ষা নিয়মের বিশদ বিবরণ প্রদান করে। অপারেশন সফল হয়েছে কিনা তা নিশ্চিত করার জন্য `response.status_code` চেক করা হয় এবং কোনো ত্রুটি দেখা দিলে একটি ব্যতিক্রম উত্থাপিত হয়। এই প্রক্রিয়াটি নিশ্চিত করতে সাহায্য করে যে কিছু ভুল হলে, স্ক্রিপ্ট ব্যবহারকারীকে একটি সহায়ক ত্রুটি বার্তা দিয়ে সতর্ক করতে পারে।

অবশেষে, স্ক্রিপ্টটি একাধিক সংগ্রহস্থলের জন্য মডুলার এবং পুনরায় ব্যবহারযোগ্য হওয়ার জন্য ডিজাইন করা হয়েছে। আপনি `REPOSITORY_OWNER` এবং `REPOSITORY_NAME`-এর মতো পরামিতিগুলি সামঞ্জস্য করার মাধ্যমে এটিকে সহজে 100s সংগ্রহস্থল পর্যন্ত স্কেল করতে পারেন৷ আপনি যদি বেশ কয়েকটি সংগ্রহস্থল জুড়ে একই সুরক্ষা নিয়ম প্রয়োগ করতে চান তবে স্ক্রিপ্টটি কেবল ইনপুট মান পরিবর্তন করে নমনীয়তার জন্য অনুমতি দেয়। অতিরিক্তভাবে, স্ক্রিপ্টটি এমনভাবে তৈরি করা হয়েছে যে এটি সহজে বৃহত্তর অটোমেশন ওয়ার্কফ্লো-তে একীভূত করতে পারে, যেমন CI/CD পাইপলাইন, যেখানে শাখাগুলিকে রক্ষা করা বা মার্জ কিউ সক্রিয় করা একাধিক প্রকল্পে ধারাবাহিক কোড গুণমান বজায় রাখার জন্য অত্যন্ত গুরুত্বপূর্ণ। 🚀

import requests
GITHUB_API_URL = 'https://api.github.com/graphql'
TOKEN = 'your_token_here'
headers = {
    "Authorization": f"Bearer {TOKEN}",
    "Content-Type": "application/json"
}
# Repository and Branch details
REPOSITORY_OWNER = "your_owner_name"
REPOSITORY_NAME = "your_repo_name"
BRANCH_PATTERN = "main"
# GraphQL mutation for creating a merge queue rule
mutation = """
mutation($repositoryId: ID!, $branchPattern: String!) {
  createMergeQueueRule(input: {
    repositoryId: $repositoryId,
    pattern: $branchPattern,
    requiresStatusChecks: true,
    allowsMergeQueue: true,
  }) {
    mergeQueueRule {
      id
      pattern
      requiresStatusChecks
      allowsMergeQueue
    }
  }
}"""
# Query to fetch repository ID
repository_query = """
query($owner: String!, $name: String!) {
  repository(owner: $owner, name: $name) {
    id
  }
}"""
def get_repository_id():
    variables = {"owner": REPOSITORY_OWNER, "name": REPOSITORY_NAME}
    response = requests.post(
        GITHUB_API_URL,
        json={"query": repository_query, "variables": variables},
        headers=headers
    )
    if response.status_code == 200:
        return response.json()["data"]["repository"]["id"]
    else:
        raise Exception(f"Failed to fetch repository ID: {response.json()}")
def enable_merge_queue(repository_id):
    variables = {
        "repositoryId": repository_id,
        "branchPattern": BRANCH_PATTERN,
    }
    response = requests.post(
        GITHUB_API_URL,
        json={"query": mutation, "variables": variables},
        headers=headers
    )
    if response.status_code == 200:
        print("Merge queue rule created:", response.json()["data"]["createMergeQueueRule"]["mergeQueueRule"])
    else:
        raise Exception(f"Failed to create merge queue rule: {response.json()}")
# Execute
try:
    repository_id = get_repository_id()
    enable_merge_queue(repository_id)
except Exception as e:
    print("Error:", e)

from github import Github
import os
# GitHub access token and repository details
GITHUB_TOKEN = os.getenv('GITHUB_TOKEN')
g = Github(GITHUB_TOKEN)
# Define the repository and branch pattern
repo_name = "your_repo_name"
branch_name = "main"
# Get the repository object
repo = g.get_repo(repo_name)
# Fetch the branch protection rule
branch = repo.get_branch(branch_name)
protection = branch.get_protection()
# Update branch protection to enable merge queue
protection.update(
    required_status_checks={"strict": True, "contexts": []},
    enforce_admins=True,
    allow_force_pushes=False,
    dismiss_stale_reviews=True,
    required_pull_request_reviews={"dismissal_restrictions": {}, "require_code_owner_reviews": True},
    merge_queue_enabled=True
)
# Display status
print(f"Merge queue enabled for branch {branch_name}")

GitHub এর GraphQL API এবং Rulesets এর সাথে মার্জ কিউ সক্ষম করা হচ্ছে

বৃহৎ সংগ্রহস্থলগুলি পরিচালনা করার সময়, বিশেষ করে একাধিক দল এবং প্রকল্প জুড়ে, একত্রীকরণ প্রক্রিয়াটিকে প্রবাহিত করার জন্য একটি মার্জ সারি বাস্তবায়ন করা অত্যন্ত গুরুত্বপূর্ণ হয়ে ওঠে। এটি নিশ্চিত করে যে বিভিন্ন শাখায় করা পরিবর্তনগুলি দ্বন্দ্ব সৃষ্টি না করে বা প্রধান শাখা ভাঙা ছাড়াই পর্যালোচনা, পরীক্ষিত এবং সংহত করা হয়। GitHub-এর একত্রীকরণ সারি একটি চমৎকার সমাধান, কারণ এটি একটি নিরাপদ এবং সুশৃঙ্খলভাবে পুল অনুরোধগুলিকে একত্রিত করার প্রক্রিয়াটিকে স্বয়ংক্রিয় করে, বিশেষ করে যখন শত শত সংগ্রহস্থলের সাথে কাজ করে। প্রথাগত শাখা সুরক্ষা বিধিগুলির বিপরীতে, যা প্রয়োজনীয় পর্যালোচনা এবং স্থিতি পরীক্ষাগুলির মতো চেকগুলিকে প্রয়োগ করে, একত্রিতকরণ সারিটি নিয়ন্ত্রিত, ক্রমাগত একত্রিত করার অনুরোধগুলিকে অনুমতি দেয়, একটি মসৃণ CI/CD পাইপলাইন নিশ্চিত করে৷

যাইহোক, একাধিক রিপোজিটরির জন্য এই বৈশিষ্ট্যটি সক্ষম করার জন্য GitHub-এর GraphQL API সম্পর্কে একটি দৃঢ় বোঝার প্রয়োজন, যা মার্জ সারি সক্ষম করা সহ রিপোজিটরি সেটিংসের উপর আরও দানাদার নিয়ন্ত্রণের সুবিধা দেয়। যদিও GraphQL মিউটেশন ব্যবহার করে শাখা সুরক্ষা নিয়ম তৈরি করার প্রক্রিয়াটি তুলনামূলকভাবে সহজ, তবে মার্জ কিউ কার্যকারিতা অন্তর্ভুক্ত করার জন্য নিয়মসমূহ-এ গভীরভাবে ডুব দিতে হবে। নিয়মসেটগুলি মূলত GitHub-এর GraphQL API-এর মধ্যে একটি কনফিগারেশন টুল যা আপনাকে পুল অনুরোধ একত্রিত করার জন্য জটিল শর্তগুলি প্রয়োগ করার অনুমতি দেয়, আপনার সংজ্ঞায়িত মানদণ্ডের উপর ভিত্তি করে PR-এর স্বয়ংক্রিয় সারিবদ্ধকরণ সহ।

মার্জ কিউ কার্যকারিতার সাথে নিয়মসমূহ একীভূত করে, আপনি নিশ্চিত করতে পারেন যে প্রতিটি পুল অনুরোধ সুশৃঙ্খলভাবে পরিচালনা করা হয়েছে, ইন্টিগ্রেশন প্রক্রিয়ায় সম্ভাব্য বাধা বা ত্রুটিগুলি এড়ানো। GitHub-এর GraphQL API-এর সাথে ইন্টারঅ্যাক্ট করে এমন পুনঃব্যবহারযোগ্য স্ক্রিপ্ট লিখে একাধিক রিপোজিটরি জুড়ে এই কার্যকারিতা প্রয়োগ করা যেতে পারে, যা আপনাকে আপনার প্রতিষ্ঠানের শত শত রিপোজিটরির জন্য এই সেটিংসের প্রয়োগকে স্বয়ংক্রিয় করার অনুমতি দেয়। মার্জ কিউ সফলভাবে সক্ষম করার মূল চাবিকাঠি হল API-এর মিউটেশনগুলিকে সঠিকভাবে ব্যবহার করা, মার্জ কিউ সক্রিয় করা নিশ্চিত করা এবং মার্জিং প্রক্রিয়া চলাকালীন উদ্ভূত বিভিন্ন প্রান্তের কেসগুলি পরিচালনা করা। 🚀